Skip to content

yarso-su/jsnpar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

jsnpar - JSON Parser 🦀

Crates.io License

Rust JSON parser implementation using parser combinators.

Note

Educational Project: This is a learning project and not recommended for production use. For production, use serde_json.

Motivation

As I'm learning Rust, I decided to write a minimal JSON parser using parser combinators. This is not intended to be used in production, but rather as a learning exercise. Although I plan to iterate until I achieve a more robust implementation, I'm open to suggestions and contributions.

I created this crate thanks to Bodil's article on parser combinators. I highly recommend checking it out.

Installation

Cargo

cargo add jsnpar

Usage

let json = r#"{"name": "yarso", "awesome": true}"#;
let result = jsnpar::parse(json);

if let Ok(jsnpar::JsonValue::Object(map)) = result {
    println!("{:?}", map);
}

Known Limitations

This is a custom implementation tailored to my own needs, so there is plenty of room for improvement.

Feel free to fork the project, open issues, or contribute suggestions.

Missing Features

  • General optimizations
  • Memory optimizations
  • Custom errors types (currently returns a String)
  • Streaming parser for large files
  • Custom number types (only f64)
  • Partial parsing
  • More comprehensive test suite
  • Performance benchmarks
  • Examples and tutorials

Alternatives

For production use, consider these battle-tested alternatives:

Contributing

This is primarily a learning project, but contributions are welcome! Feel free to:

  • Open issues for bugs or feature requests
  • Submit pull requests
  • Share feedback on the code

Acknowledgments

Built with:

  • Rust - Because learning is fun

License

MIT License

About

Rust JSON parser implementation using parser combinators.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages