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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79

//! [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE-MIT)
//! [![Apache License 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](./LICENSE-APACHE)
//! [![docs.rs](https://docs.rs/ldap-parser/badge.svg)](https://docs.rs/ldap-parser)
//! [![crates.io](https://img.shields.io/crates/v/ldap-parser.svg)](https://crates.io/crates/ldap-parser)
//! [![Github CI](https://github.com/rusticata/ldap-parser/workflows/Continuous%20integration/badge.svg)](https://github.com/rusticata/ldap-parser/actions)
//! [![Minimum rustc version](https://img.shields.io/badge/rustc-1.44.0+-lightgray.svg)](#rust-version-requirements)
//!
//! # LDAP Parser
//!
//! A Lightweight Directory Access Protocol (LDAP) ([RFC4511]) parser, implemented with the
//! [nom](https://github.com/Geal/nom) parser combinator framework.
//!
//! It is written in pure Rust, fast, and makes extensive use of zero-copy. A lot of care is taken
//! to ensure security and safety of this crate, including design (recursion limit, defensive
//! programming), tests, and fuzzing. It also aims to be panic-free.
//!
//! The code is available on [Github](https://github.com/rusticata/ldap-parser)
//! and is part of the [Rusticata](https://github.com/rusticata) project.
//!
//! # Examples
//!
//! Parsing an LDAP message (in BER format):
//!
//! ```rust
//! use ldap_parser::FromBer;
//! use ldap_parser::ldap::{LdapMessage, MessageID, ProtocolOp, ProtocolOpTag};
//!
//! static DATA: &[u8] = include_bytes!("../assets/message-search-request-01.bin");
//!
//! # fn main() {
//! let res = LdapMessage::from_ber(DATA);
//! match res {
//!     Ok((rem, msg)) => {
//!         assert!(rem.is_empty());
//!         //
//!         assert_eq!(msg.message_id, MessageID(4));
//!         assert_eq!(msg.protocol_op.tag(), ProtocolOpTag::SearchRequest);
//!         match msg.protocol_op {
//!             ProtocolOp::SearchRequest(req) => {
//!                 assert_eq!(req.base_object.0, "dc=rccad,dc=net");
//!             },
//!             _ => panic!("Unexpected message type"),
//!         }
//!     },
//!     _ => panic!("LDAP parsing failed: {:?}", res),
//! }
//! # }
//! ```
//!
//! [RFC4511]: https://tools.ietf.org/html/rfc4511

#![deny(/*missing_docs,*/
        unstable_features,
        unused_import_braces, unused_qualifications)]
#![warn(
    missing_debug_implementations,
    /* missing_docs,
    rust_2018_idioms,*/
    unreachable_pub
)]
#![forbid(unsafe_code)]
#![deny(broken_intra_doc_links)]
#![doc(test(
    no_crate_inject,
    attr(deny(warnings, rust_2018_idioms), allow(dead_code, unused_variables))
))]
#![cfg_attr(docsrs, feature(doc_cfg))]

pub mod error;
pub mod filter;
mod filter_parser;
pub mod ldap;
mod parser;

pub use parser::*;

pub use asn1_rs;
pub use asn1_rs::nom::{Err, IResult};
pub use asn1_rs::FromBer;