rusticata-macros

Rusticata-macros

Helper macros for the rusticata project.

This crate contains some additions to nom.

For example, the error_if! macro allows to test a condition and return an error from the parser if the condition fails:

use rusticata_macros::error_if;
let r : IResult<&[u8],()> = do_parse!(
    s,
    l: be_u8 >>
    error_if!(l < 4, ErrorKind::Verify) >>
    data: take!(l - 4) >>
    (())
    );

See the documentation for more details and examples.

Nom versions

Different versions of this crate are available, depending on nom version.

rusticata-macros 4.x depends on nom 7
rusticata-macros 3.x depends on nom 6
rusticata-macros 2.x depends on nom 5

Documentation

Crate is documented, do running cargo doc will crate the offline documentation.

Reference documentation can be found here

Changes

4.0.0

Upgrade to nom 7
- Remove macros

3.0.1

Add be_var_u64 and le_var_u64

3.0.0

Upgrade to nom 6

2.1.0

Add common trait Serialize for structures serialization

2.0.4

Add function version of most combinators

2.0.3

Add macros q (quote) and align32

2.0.2

Add upgrade_error and upgrade_error_to

2.0.1

Add macro custom_check
Add macro flat_take

2.0.0

Upgrade to nom 5
Debug types: use newtypes

1.1.0

Add macro newtype_enum

1.0.0

Upgrade to nom 4.0
- Warning: this is a breaking change!
Mark parse_uint24 as deprecated

License

Licensed under either of

Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.