octseq/
lib.rs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
//! Variable length octet sequences.
//!
//! This crate provides a set of basic traits that allow defining types that
//! are generic over a variable length sequence of octets (or, vulgo: bytes).
//!
//! There are two groups of traits: those that represent behavior of immutable
//! octets sequences are collected in the module _[octets]_ and those for
//! building such sequences are in _[builder]_. Most traits from these modules
//! are also re-exported at the crate root for convenience.
//!
//! These traits are implemented for a number of types. Apart from `[u8]`,
//! the implementations are opt-in via features. These are:
//!
//! * `std` for `Vec<u8>`, `Cow<[u8]>`, and `Arc<[u8]>`,
//! * `bytes` for the `Bytes` and `BytesMut` types from the
//!   [bytes](https://crates.io/crates/bytes) crate,
//! * `heapless` for the `Vec<u8, N>` type from the
//!   [heapless](https://crates.io/crates/heapless) crate, and
//! * `smallvec` for a smallvec for item type `u8` from the
//!   [smallvec](https://crates.io/crates/smallvec) crate.
//!
//! A number of additional modules exist that provide a few helpful things:
//!
//! * The _[mod@array]_ module provides an octets builder backed by an octets
//!   array.
//! * The _[mod@str]_ module provides both immutable and buildable string types
//!   that are generic over the octets sequence they wrap.
//! * The
#![cfg_attr(feature = "serde", doc = "  _[serde]_")]
#![cfg_attr(not(feature = "serde"), doc = "  _serde_")]
//!   module, which needs to be enabled via the `serde`
//!   feature, provides traits and functions to more efficiently serialize
//!   octets sequences.

#![cfg_attr(not(feature = "std"), no_std)]
#![allow(renamed_and_removed_lints)]
#![allow(clippy::unknown_clippy_lints)]
#![cfg_attr(docsrs, feature(doc_cfg))]

pub use self::array::Array;
pub use self::builder::{
    EmptyBuilder, FreezeBuilder, FromBuilder, IntoBuilder, OctetsBuilder,
    ShortBuf, Truncate,
};
pub use self::octets::{Octets, OctetsFrom, OctetsInto};
pub use self::parse::{Parser, ShortInput};
pub use self::str::{Str, StrBuilder};

pub mod array;
pub mod builder;
pub mod octets;
pub mod parse;
pub mod serde;
pub mod str;