Initial import of rusticata-macros-3.1.0 am: ebb187258f

Original change: https://android-review.googlesource.com/c/platform/external/rust/crates/rusticata-macros/+/1770171

Change-Id: I5f3b2b1884ff90dbbcd7d9b4600a3638d7db222e
tree: 293b11b9b7e5c859eda0cc9fa0d558321a90fb92
  1. benches/
  2. src/
  3. .cargo_vcs_info.json
  4. .gitignore
  5. .travis.yml
  6. Cargo.toml
  7. Cargo.toml.orig
  8. LICENSE-APACHE
  9. LICENSE-MIT
  10. METADATA
  11. MODULE_LICENSE_APACHE2
  12. OWNERS
  13. README.md
README.md

rusticata-macros

License: MIT Apache License 2.0 Build Status Github CI Crates.io Version

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

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.