dms-py 0.1.0

Pure-Python parser for DMS, a data syntax with strong typing, ordered maps, and heredocs.

dms-py

Python implementations of DMS, a data syntax with strong typing, ordered maps, multi-line heredocs, and front-matter metadata.

Two packages live in this repo:

dir	PyPI name	description
dms/	dms-py	pure-Python reference parser
dms-c/	dms-c	CPython extension wrapping the C parser (much faster)

The dms-c package compiles external/dms-c/dms.c (a git submodule). After cloning, run:

git submodule update --init --recursive

Install (pure Python)

pip install dms-py

import dms_py

with open("config.dms") as f:
    doc = dms_py.parse(f.read())

Install (C-extension)

pip install dms-c

import dms_c

doc = dms_c.parse(open("config.dms").read())

Same API surface; the C variant is several times faster on wide-flat documents.

Build & test (development)

python -m pip install -e .                  # pure-py, editable
python -m pip install -e ./dms-c             # C-ext, editable

python -m pytest tests/                      # round-trip + comment tests

Conformance

The fixture corpus lives in dms-tests (4500+ pairs). Clone it once as a sibling:

git clone https://gitlab.com/flo-labs/pub/dms-tests.git ../dms-tests

Then run the sweep:

python3 ../dms-tests/run_conformance.py "python3 encoder.py"

dms-tests can also drive every implementation in one shot — see its README for the cross-language workflow.

Publish

# pure Python
python -m build                              # creates dist/dms_py-0.1.0*
twine upload dist/dms_py-*

# C extension
cd dms-c && python -m build && twine upload dist/*

You'll need pip install build twine and a PyPI token configured (~/.pypirc). The C-ext sdist must include external/dms-c/dms.c — either initialise the submodule before python -m build, or use a build-time hook to copy the file.

License

MIT OR Apache-2.0