commit	dbf8de0f607fbcfc2c670767415980026e48303d	[log] [tgz]
author	Android Build Coastguard Worker <android-build-coastguard-worker@google.com>	Wed Jul 21 03:05:36 2021 +0000
committer	Android Build Coastguard Worker <android-build-coastguard-worker@google.com>	Wed Jul 21 03:05:36 2021 +0000
tree	d3d32479033875e0aaee81b99bd0939351efa3fd
parent	61f3cdd73fa997537b62c352e6b36c9b271246da [diff]
parent	64b9a730f06d31232c9d24377268e4145fdcdb3c [diff]

tree: d3d32479033875e0aaee81b99bd0939351efa3fd

README.md

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 0.3.x depends on nom 6
rusticata-macros 0.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

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.