Metadata-Version: 2.4
Name: xwformats
Version: 0.9.0.8
Summary: Convenience wrapper for exonware-xwformats - provides 'import xwformats' alias
Project-URL: Homepage, https://exonware.com
Project-URL: Repository, https://github.com/exonware/xwformats
Project-URL: Documentation, https://github.com/exonware/xwformats#readme
Author-email: eXonware Backend Team <connect@exonware.com>
License: MIT
License-File: LICENSE
Keywords: avro,enterprise,exonware,formats,hdf5,netcdf,parquet,protobuf,scientific,serialization,thrift
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT 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: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.12
Requires-Dist: exonware-xwformats
Provides-Extra: full
Requires-Dist: exonware-xwformats[full]; extra == 'full'
Provides-Extra: lazy
Requires-Dist: exonware-xwformats[lazy]; extra == 'lazy'
Description-Content-Type: text/markdown

# xwformats - Enterprise Serialization Formats

**Company:** eXonware.com  
**Author:** eXonware Backend Team  
**Email:** connect@exonware.com  
**Version:** 0.0.1.2
**Date:** 02-Nov-2025

---

## Overview

Extended serialization format library providing heavyweight enterprise formats for specialized domains.

**Note:** This library is separated from `xwsystem` to keep the core lightweight and fast.

---

## What's Inside

### 18 Enterprise Formats (~87 MB):

**Schema Formats (7):**
- Protocol Buffers
- Apache Avro
- Apache Parquet
- Apache Thrift
- Apache ORC
- Cap'n Proto
- FlatBuffers

**Scientific Formats (5):**
- HDF5
- Feather
- Zarr
- NetCDF
- MATLAB MAT

**Database Formats (3):**
- LMDB
- GraphDB (Neo4j, Dgraph)
- LevelDB

**Binary Formats (2):**
- BSON
- UBJSON

**Text Formats (1):**
- XML (enterprise features)

---

## Installation

```bash
# Standard installation
pip install exonware-xwformats

# With xwsystem
pip install exonware-xwsystem exonware-xwformats

# Or use xwsystem[lazy] for auto-installation
pip install exonware-xwsystem[lazy]
```

---

## Usage

```python
from exonware.xwformats import (
    ParquetSerializer,
    ProtobufSerializer,
    Hdf5Serializer,
    # ... all enterprise formats
)

# Or through xwsystem
from exonware.xwsystem import XWIO

io = XWIO()
io.serialize(data, format="parquet")  # Auto-discovers xwformats!
```

---

## Why Separate from xwsystem?

**Performance:**
- xwsystem: ~5 MB (core formats only)
- xwformats: ~87 MB (enterprise formats)
- Install only what you need!

**Startup Time:**
- xwsystem alone: ~0.1s (20x faster!)
- With xwformats: ~2s (when actually used)

**Coverage:**
- xwsystem: 14 core formats (80%+ use cases)
- xwformats: 18 enterprise formats (specialized needs)

---

## License

MIT License - See LICENSE file

---

**Part of the eXonware ecosystem**

