Metadata-Version: 2.4
Name: datacortex
Version: 0.4.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Rust
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: System :: Archiving :: Compression
Summary: The best standalone JSON/NDJSON compressor. Beats zstd and brotli on every file.
Keywords: compression,json,ndjson,zstd,brotli,lossless
Author: Rushikesh More
License: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Homepage, https://github.com/rushikeshmore/DataCortex
Project-URL: Repository, https://github.com/rushikeshmore/DataCortex

# datacortex

Python bindings for [DataCortex](https://github.com/rushikeshmore/DataCortex), the best standalone JSON/NDJSON compressor.

Beats zstd-19 and brotli-11 on every JSON file tested.

## Install

```
pip install datacortex
```

## Usage

```python
import datacortex

# Compress bytes
compressed = datacortex.compress(json_bytes, mode="fast")
original = datacortex.decompress(compressed)

# Compress files
datacortex.compress_file("data.json", "data.dcx", mode="fast")
datacortex.decompress_file("data.dcx", "output.json")

# Inspect compressed data
info = datacortex.info(compressed)
# {'mode': 'fast', 'format': 'json', 'original_size': 435889, ...}

# Detect format
fmt = datacortex.detect_format(json_bytes)
# 'json', 'ndjson', 'generic', etc.
```

## Modes

- `"fast"` (default) - Best for JSON/NDJSON. Uses format-aware preprocessing + zstd/brotli.
- `"balanced"` - Context mixing engine. Better on general text, slower.
- `"max"` - Maximum compression. Slowest.

## License

MIT

