feat: bootstrap asyncjsonparser crate

Author: ngutman

.github/workflows/ci.yml

@@ -0,0 +1,34 @@
+name: ci
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: stable
+          components: rustfmt, clippy
+
+      - name: Cache cargo
+        uses: Swatinem/rust-cache@v2
+
+      - name: Format
+        run: cargo fmt --all -- --check
+
+      - name: Clippy
+        run: cargo clippy --all-targets --all-features -- -D warnings
+
+      - name: Test
+        run: cargo test --all-features
+
+      - name: Docs
+        run: cargo doc --no-deps

.gitignore

@@ -0,0 +1,4 @@
+/target
+Cargo.lock
+.idea/
+.DS_Store

CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Initial async JSON streaming parser.
+- `AsyncJsonParser` with streaming and pull-based APIs.
+- `ParserConfig` for buffering and read sizing.

CODE_OF_CONDUCT.md

@@ -0,0 +1,95 @@
+# Code of Conduct
+
+## Our pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our standards
+
+Examples of behavior that contributes to a positive environment include:
+
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes
+- Focusing on what is best for the community
+
+Examples of unacceptable behavior include:
+
+- The use of sexualized language or imagery, and sexual attention or advances
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+- Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+## Scope
+
+This Code of Conduct applies within all community spaces and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+security@singular.net. All complaints will be reviewed and investigated
+promptly and fairly.
+
+## Enforcement guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+1. Correction
+   Community Impact: Use of inappropriate language or other behavior deemed
+   unprofessional or unwelcome in the community.
+   Consequence: A private, written warning from community leaders, providing
+   clarity around the nature of the violation and an explanation of why the
+   behavior was inappropriate. A public apology may be requested.
+
+2. Warning
+   Community Impact: A violation through a single incident or series of
+   actions.
+   Consequence: A warning with consequences for continued behavior. No
+   interaction with the people involved, including unsolicited interaction
+   with those enforcing the Code of Conduct, for a specified period of time.
+
+3. Temporary ban
+   Community Impact: A serious violation of community standards, including
+   sustained inappropriate behavior.
+   Consequence: A temporary ban from any sort of interaction or public
+   communication with the community for a specified period of time.
+
+4. Permanent ban
+   Community Impact: Demonstrating a pattern of violation of community
+   standards, including sustained inappropriate behavior, harassment of an
+   individual, or aggression toward or disparagement of classes of individuals.
+   Consequence: A permanent ban from any sort of public interaction within the
+   community.
+
+## Attribution
+
+This Code of Conduct is adapted from the Contributor Covenant, version 2.1,
+available at https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+
+Community Impact Guidelines were inspired by Mozilla's code of conduct
+enforcement ladder.

CONTRIBUTING.md

@@ -0,0 +1,34 @@
+# Contributing
+
+Thanks for contributing to asyncjsonparser.
+
+## Development setup
+
+- Install stable Rust and Cargo.
+- Clone the repository.
+
+```bash
+cargo test
+cargo fmt --all
+cargo clippy --all-targets --all-features -- -D warnings
+```
+
+## Pull requests
+
+- Keep changes focused and well-scoped.
+- Add tests for bug fixes and new behavior.
+- Update docs and CHANGELOG when appropriate.
+- Ensure `cargo fmt` and `cargo clippy` are clean.
+
+## Reporting issues
+
+Please include:
+
+- Rust version (`rustc -V`)
+- Platform (OS + CPU)
+- A minimal reproduction case
+- Expected vs actual behavior
+
+## Code of conduct
+
+This project follows the [Code of Conduct](CODE_OF_CONDUCT.md).

Cargo.toml

@@ -0,0 +1,28 @@
+[package]
+name = "asyncjsonparser"
+version = "0.1.0"
+edition = "2021"
+rust-version = "1.74"
+description = "Async JSON value streaming parser for AsyncRead sources"
+readme = "README.md"
+license = "MIT OR Apache-2.0"
+repository = "https://github.com/singular-labs/async-json-streamer"
+homepage = "https://github.com/singular-labs/async-json-streamer"
+documentation = "https://docs.rs/asyncjsonparser"
+keywords = ["json", "async", "streaming", "parser", "ndjson"]
+categories = ["asynchronous", "parser-implementations", "encoding"]
+
+[dependencies]
+bytes = "1.6"
+futures = "0.3"
+serde = { version = "1.0", features = ["derive"] }
+serde_json = "1.0"
+thiserror = "1.0"
+
+[dev-dependencies]
+futures = { version = "0.3", features = ["executor"] }
+tokio = { version = "1.37", features = ["fs", "macros", "rt-multi-thread", "io-util"] }
+tokio-util = { version = "0.7", features = ["compat"] }
+
+[package.metadata.docs.rs]
+all-features = true