xml_sec/
lib.rs

1//! # xml-sec — Pure Rust XML Security
2//!
3//! Drop-in replacement for libxmlsec1. XMLDSig, XMLEnc, C14N — no C dependencies.
4//!
5//! ## Features
6//!
7//! - **C14N** — XML Canonicalization (inclusive + exclusive)
8//! - **XMLDSig** — XML Digital Signatures (sign + verify)
9//! - **XMLEnc** — XML Encryption (encrypt + decrypt)
10//! - **X.509** — Certificate-based key extraction
11//!
12//! ## Quick Start
13//!
14//! ```rust
15//! # fn main() -> Result<(), Box<dyn std::error::Error>> {
16//! use xml_sec::c14n::{C14nAlgorithm, C14nMode, canonicalize_xml};
17//!
18//! let xml = b"<root b=\"2\" a=\"1\"><empty/></root>";
19//! let algo = C14nAlgorithm::new(C14nMode::Inclusive1_0, false);
20//! let canonical = canonicalize_xml(xml, &algo)?;
21//! assert_eq!(
22//!     String::from_utf8(canonical)?,
23//!     "<root a=\"1\" b=\"2\"><empty></empty></root>"
24//! );
25//! # Ok(())
26//! # }
27//! ```
28
29#![deny(unsafe_code)]
30#![deny(clippy::unwrap_used)]
31#![warn(missing_docs)]
32
33#[cfg(not(any(feature = "xml-backend-xmloxide", feature = "xml-backend-roxmltree")))]
34compile_error!("select one XML backend feature: `xml-backend-xmloxide` or `xml-backend-roxmltree`");
35
36pub mod c14n;
37pub mod document;
38pub mod encoding;
39pub mod error;
40mod hard_limits;
41#[cfg(any(feature = "xmldsig", feature = "xmlenc"))]
42pub mod policy;
43#[cfg(any(feature = "xmldsig", feature = "xmlenc"))]
44pub mod provider;
45mod xml;
46
47pub use xml::IdAttributeRegistration;
48
49#[cfg(feature = "xmldsig")]
50pub mod xmldsig;
51
52#[cfg(feature = "xmlenc")]
53pub mod xmlenc;
54
55#[cfg(any(feature = "xmldsig", feature = "xmlenc"))]
56pub use document::XmlDocumentPolicy;
57pub use document::{
58    AttributeIdentity, DocumentIdentity, DocumentView, NamespaceIdentity, NodeIdentity,
59    SemanticOrder, XmlDocument, XmlDocumentError,
60};
61pub use error::XmlSecError;
xml_sec/lib.rs

xml_sec/
lib.rs
