Metadata-Version: 2.4
Name: vexy_json
Version: 1.5.12
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Rust
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Text Processing
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Requires-Dist: pytest>=7.0 ; extra == 'dev'
Requires-Dist: pytest-benchmark>=4.0 ; extra == 'dev'
Requires-Dist: maturin>=1.0 ; extra == 'dev'
Provides-Extra: dev
Summary: A forgiving JSON parser - Python bindings for the Rust vexy_json library
Keywords: json,parser,forgiving,lenient,rust
Author-email: Adam Twardoch <adam+github@twardoch.com>
License: MIT OR Apache-2.0
Requires-Python: >=3.8
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Documentation, https://twardoch.github.io/vexy_json/
Project-URL: Homepage, https://github.com/vexyart/vexy-json
Project-URL: Issues, https://github.com/vexyart/vexy-json/issues
Project-URL: Repository, https://github.com/vexyart/vexy-json.git

# this_file: crates/python/README.md

# vexy_json Python Bindings

Python bindings for the vexy_json library - a forgiving JSON parser written in Rust.

## Installation

```bash
pip install vexy_json
```

## Usage

```python
import vexy_json

# Parse forgiving JSON
result = vexy_json.parse('{"key": "value", trailing: true,}')
print(result)  # {'key': 'value', 'trailing': True}

# Use NumPy integration
import numpy as np
arr = vexy_json.loads_numpy('[1, 2, 3, 4, 5]')
print(type(arr))  # <class 'numpy.ndarray'>
```

## Features

- Standard JSON parsing with forgiving extensions
- Comments (single-line and multi-line)
- Trailing commas in arrays and objects
- Unquoted object keys
- Single-quoted strings
- Implicit top-level objects and arrays
- NumPy integration for efficient array parsing
- Streaming parser for large files
- pandas DataFrame integration
- JSON repair functionality

For more information, see the [main vexy_json documentation](https://github.com/vexyart/vexy-json).
