Skip to main content

Convenience wrapper for exonware-xwformats - provides 'import xwformats' alias

Project description

xwformats

Many serialization formats, one package. Schema (Protobuf, Parquet, Thrift, …), scientific (HDF5, Feather, Zarr, …), database (LMDB, LevelDB, …), plus binary and text. Same converter style as xwsystem; formats register on import. Pick lite, lazy, full, or dev extras to match how you deploy.

Company: eXonware.com · Author: eXonware Backend Team · Email: connect@exonware.com

Status Python License


Install

Install What you get When to use
pip install exonware-xwformats Lite - exonware-xwsystem + exonware-xwlazy Small install; add formats via [full] or lazy hooks.
pip install exonware-xwformats[lazy] Lazy - xwsystem[lazy] + lazy extras Matches lazy-optional stack in docs.
pip install exonware-xwformats[full] Full - common format deps installed up front Production or CI; on Windows, LevelDB/RocksDB wheels may be missing (see docs/REF_54_BENCH.md).
pip install exonware-xwformats[dev] Dev - pytest, black, mypy, … Contributors

Base install always pulls exonware-xwsystem and exonware-xwlazy. [lazy], [dev], and [full] are extras.


Quick start

from exonware.xwformats import XWFormats

xf = XWFormats()
print(xf.list_formats())                       # All registered formats
data = xf.convert(json_bytes, "json", "yaml")  # Bidirectional conversion
ser = xf.get_serializer("parquet")
ser.encode(value)
ser.decode(data)

Importing xwformats registers its formats with xwsystem; use xwsystem's codec/facade for detection by file extension. See REF_14_DX and REF_15_API.


What you get

Area What's in it
Schema Protobuf, Parquet, Thrift, ORC, Cap'n Proto, FlatBuffers, Arrow. Avro is optional (may be off default import on some platforms - see __init__.py and docs/_archive/KNOWN_ISSUES.md).
Scientific HDF5, Feather, Zarr, NetCDF, MAT.
Database LMDB, LevelDB, RocksDB, GraphDB.
Binary / text BSON, UBJSON; CSV, YAML, TOML, XML, RON.
Integration Same converter/facade as xwsystem; codec registry updated on import.

Lite = few deps. Lazy = optional format wheels on first use. Full = common optionals pre-installed. Platform notes (e.g. RocksDB on Windows): docs/logs/setup/. Known issues: docs/_archive/KNOWN_ISSUES.md and REF_22_PROJECT.md.


Docs and tests

Aligned with project REFs and docs/GUIDE_01_USAGE.md (see GUIDE_63_README in the monorepo).


License and links

MIT - see LICENSE.

Built with ❤️ by eXonware.com - Revolutionizing Python Development Since 2025

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xwformats-0.9.0.23.tar.gz (58.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

xwformats-0.9.0.23-py3-none-any.whl (6.0 kB view details)

Uploaded Python 3

File details

Details for the file xwformats-0.9.0.23.tar.gz.

File metadata

  • Download URL: xwformats-0.9.0.23.tar.gz
  • Upload date:
  • Size: 58.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for xwformats-0.9.0.23.tar.gz
Algorithm Hash digest
SHA256 3f6fa9005101ced763e4ebbf26742fed3eecb73a76335a469a14ded7d8a33a65
MD5 72ab72f6d300b205577691bbb2630ed9
BLAKE2b-256 cb1169e7e487962dcda870a03b28bb99bcc7328180ec9a836703f195e3cd2416

See more details on using hashes here.

File details

Details for the file xwformats-0.9.0.23-py3-none-any.whl.

File metadata

  • Download URL: xwformats-0.9.0.23-py3-none-any.whl
  • Upload date:
  • Size: 6.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for xwformats-0.9.0.23-py3-none-any.whl
Algorithm Hash digest
SHA256 e9da91e604f7a378c3df95cb2d17f072cf54ec12cc5fa0592bc79742e77f7cd7
MD5 aaac97d0bfe3be05c74460a82965123d
BLAKE2b-256 d1738dc1956da773efdd7b9f8516b3f9c3bbf11f212d672c927fc2132df7130c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page