Initial commit

Author: tatsuhiro-t

.gitignore

@@ -0,0 +1,2 @@
+/target
+*~

COPYING

@@ -0,0 +1,22 @@
+The MIT License
+
+Copyright (c) 2024 sfparse-rs contributors
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Cargo.lock

@@ -0,0 +1,6 @@
+[package]
+name = "sfparse"
+version = "0.1.0"
+edition = "2021"
+
+[dependencies]

Cargo.toml

@@ -0,0 +1 @@
+See README.rst

README

@@ -0,0 +1,36 @@
+sfparse-rs
+==========
+
+sfparse-rs is `RFC 9651
+<https://datatracker.ietf.org/doc/html/rfc9651>`_ Structured Field
+Values parser written in Rust.  It is the port of `sfparse
+<https://github.com/ngtcp2/sfparse>`_ written in C.
+
+It is designed not to do any extra allocation, like allocating maps,
+lists, and Strings, and do the minimal stuff to parse the input data.
+
+.. code-block:: rust
+
+    use sfparse::{Parser, Value};
+
+    let mut urgency :i32 = 3;
+    let mut incremental = false;
+    let mut p = Parser::new("u=2, i".as_bytes());
+
+    loop {
+        match p.parse_dict().unwrap() {
+            None => break,
+            Some(("u", Value::Integer(v))) if (0i64..=7i64).contains(&v) => urgency = v as i32,
+            Some(("i", Value::Bool(v))) => incremental = v,
+            _ => (),
+        }
+    }
+
+    println!("urgency={urgency} incremental={incremental}");
+
+License
+-------
+
+The MIT License
+
+Copyright (c) 2024 sfparse-rs contributors

README.rst

@@ -0,0 +1,35 @@
+//! [RFC 9651](https://datatracker.ietf.org/doc/html/rfc9651)
+//! Structured Field Values parser.
+//!
+//! Provides Structured Field Values parser that is designed not to do
+//! any extra allocation, like allocating maps, lists, and Strings,
+//! and do the minimal stuff to parse the input data.
+//!
+//! This is an example of parsing [RFC
+//! 9218](https://datatracker.ietf.org/doc/html/rfc9218) Priority
+//! header field:
+//!
+//! ```
+//! use sfparse::{Parser, Value};
+//!
+//! let mut urgency :i32 = 3;
+//! let mut incremental = false;
+//! let mut p = Parser::new("u=2, i".as_bytes());
+//!
+//! loop {
+//!     match p.parse_dict().unwrap() {
+//!         None => break,
+//!         Some(("u", Value::Integer(v))) if (0i64..=7i64).contains(&v) => urgency = v as i32,
+//!         Some(("i", Value::Bool(v))) => incremental = v,
+//!         _ => (),
+//!     }
+//! }
+//!
+//! println!("urgency={urgency} incremental={incremental}");
+//! ```
+mod parser;
+mod utf8;
+mod value;
+
+pub use crate::parser::{Parser, Error};
+pub use crate::value::Value;