pyjsonparser

A custom JSON parser implementation written in Python, featuring a lexer-parser architecture for robust JSON parsing and serialization.

Overview

pyjsonparser is a lightweight JSON parser that implements the complete JSON specification. It includes:

• Lexer: Tokenizes JSON input strings
• Parser: Builds Python objects from tokens
• Serializer: Converts Python objects back to JSON strings

Features

• Parse JSON strings into Python objects (dictionaries, lists, strings, numbers, booleans, null)
• Serialize Python objects back to JSON format
• Clean separation of concerns with abstract contracts and concrete implementations
• Comprehensive test coverage with pytest

Requirements

• Python >= 3.12

Installation

You can install pyjsonparser in two ways:

1. Using pip:

   pip install pyjsonparser

2. Cloning the repository:

   git clone <repository-url>
   cd pyjsonparser

   Install dependencies:

   poetry install

Usage

from pyjson import JsonParser

parser = JsonParser()

# Parse JSON string
json_object = parser.from_string('{"name": "John", "age": 30}')
# Result: {'name': 'John', 'age': 30}

# Convert to JSON string
json_string = parser.to_string({"name": "John", "age": 30})
# Result: '{"name": "John", "age": 30}'

Project Structure

pyjsonparser/
├── src/pyjson/
│   ├── abstract/           # Abstract base contracts
│   ├── core/
│   │   ├── lexer/         # Tokenization logic
│   │   ├── parser/        # Parsing logic
│   │   └── shared/        # Shared constants
│   └── impl/              # Concrete implementations
└── tests/                 # Test suite

Development

Run tests:

poetry run pytest

Author

Ionut-Alexandru Prodan (prodanalexandru1999@gmail.com)

License

See LICENSE file for details.