The viaspf-record library contains a data model and parser for SPF records. SPF records are described in the Sender Policy Framework specification, version 1 ([RFC 7208]).
The data structures in this library constitute a complete and faithful encoding of the ABNF in [RFC 7208, section 12]. Extensive checking ensures correctness and conformance with the specification.
This library is used in [viaspf], where you can find a complete implementation of SPF, including APIs for performing SPF queries. The viaspf-record library is a stand-alone product and could also be used in other projects.
The minimum supported Rust version is 1.56.1.
This is a Rust library. Include viaspf-record in Cargo.toml as usual.
The struct [Record] represents a syntactically valid SPF record. A Record
can be constructed programmatically or parsed from a string.
```rust use std::net::Ipv4Addr; use viaspf_record::*;
let record = "v=spf1 mx ip4:12.34.56.78/24 -all".parse();
asserteq!( record, Ok(Record { terms: vec![ Term::Directive(Directive { qualifier: None, mechanism: Mechanism::Mx(Mx { domainspec: None, prefixlen: None, }), }), Term::Directive(Directive { qualifier: None, mechanism: Mechanism::Ip4(Ip4 { addr: Ipv4Addr::new(12, 34, 56, 78), prefixlen: Some(Ip4CidrLength::new(24).unwrap()), }), }), Term::Directive(Directive { qualifier: Some(Qualifier::Fail), mechanism: Mechanism::All, }), ], }) ); ```
Refer to the [API documentation] for details.
Copyright © 2020–2022 David Bürgin
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.