#dmx #address #struct #absolute #hold #parser #addresses

dmx-struct

A struct that holds a DMX Addresse with parsing capabilities

1 unstable release

0.1.0 May 16, 2021

#10 in #dmx

Download history 19/week @ 2024-04-01 2/week @ 2024-05-20 1/week @ 2024-06-10 31/week @ 2024-06-24 30/week @ 2024-07-01

61 downloads per month

MIT/Apache

15KB
283 lines

Dmx-Struct

A rust- module for a struct that holds dmx-address information.

dmx-struct is in pre-release state. Any breaking changes may be implemented without further notice!

Description

This is a simple crate that contains a struct DMXAddress. The struct implements the trait TryFrom that understands notation with dot (eg. 1.234, 5.231) and absolute dmx addresses to parse.

The module is designed to never panic but return DMXParseError instead

The module holds both, the absolute address and the address separated by universe and address so no calculation needed for further oparations

Usage

The main struct DMXAddress implements the trait TryFrom<&str> so usage is straight forward:

[dependencies]
dmx-struct = "0.1.0"

Example try from

 use std::convert::TryFrom;

use dmx_struct::{DMXAddress, DMXParseError};

fn test() {
    let dmx_address: Result<DMXAddress, DMXParseError> = DMXAddress::try_from("1.511");
    let dmx_address: Result<DMXAddress, DMXParseError> = DMXAddress::try_from("1024");
}

Example try into

use std::convert::TryInto;

use dmx_struct::{DMXAddress, DMXParseError};

fn test() {
   let dmx_address: Result<DMXAddress, DMXParseError> = "1.511".try_into();
   let dmx_address: Result<DMXAddress, DMXParseError> = "1024".try_into();
}

No runtime deps