openstatspec 0.1.0__py3-none-any.whl

openstatspec-0.1.0.dist-info/METADATA

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: openstatspec
+Version: 0.1.0
+Summary: Reference adapter for the OpenStatSpec relational contract
+Author: OpenStatSpec
+License: Apache-2.0
+Requires-Python: >=3.11
+Requires-Dist: openstatspec-pyspssio==0.5.1.post2
+Requires-Dist: pandas>=2.2
+Requires-Dist: sqlalchemy>=2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == 'dev'
+Provides-Extra: sql
+Requires-Dist: psycopg[binary]>=3.2; extra == 'sql'
+Requires-Dist: pymysql>=1.1; extra == 'sql'
+Description-Content-Type: text/markdown
+
+# OpenStatSpec Python
+
+The reference Python implementation of the OpenStatSpec specification.
+
+This package implements the specification; it does not define or extend it.
+The normative model lives in the `OpenStatSpec/specification` repository.
+
+## Boundaries
+
+For each supported import, one source dataset becomes one dedicated wide SQL
+table. Cases are rows and source variables are physical SQL columns. The
+singular UUID-keyed tables from the specification (`dataset`, `variable`,
+`operation`, `fidelity_event`, and related metadata tables) are the public
+catalog contract. Historical `*_catalog` tables are an internal compatibility
+layer for the current exporter and are not the standard database interface.
+The adapter does not reshape data, create EAV
+or long-form tables, or harmonize studies or waves.
+
+Unsupported source features, SQL targets, or export paths fail explicitly.
+There is no silent truncation, type conversion, metadata loss, or partial
+import.
+
+## Package layout
+
+- `openstatspec.core`: pure standard concepts, validation, versions,
+  capabilities, and loss reports.
+- `openstatspec.sql`: database connection and wide-table/catalog operations.
+- `openstatspec.spss`: SAV/ZSAV adapter boundary.
+
+## Intended workflow
+
+```python
+from openstatspec import export_sav, import_sav
+
+import_sav("responses.sav", database_url="postgresql+psycopg://user:password@server/database", dataset_id="responses-2026")
+export_sav(database_url="postgresql+psycopg://user:password@server/database", dataset_id="responses-2026", destination="responses-roundtrip.sav")
+```
+
+```text
+openstatspec import responses.sav --database-url postgresql+psycopg://... --dataset-id responses-2026
+openstatspec export --database-url postgresql+psycopg://... --dataset-id responses-2026 --output responses-roundtrip.sav
+```
+
+## 0.1.0 support status
+
+The adapter requires `openstatspec-pyspssio==0.5.1.post2` as its sole SPSS
+engine. Its import module remains `pyspssio`; the exact source commit is recorded
+in operation metadata. There is no fallback reader or writer. It supports unencrypted SAV and ZSAV import and
+SAV/ZSAV export for the semantics exposed by that engine. SQLite is the local
+reference path.
+PostgreSQL, MySQL, and MariaDB are each covered by separate service-backed CI
+conformance checks. Use these explicit SQLAlchemy URLs:
+
+- SQLite: `sqlite:///dataset.sqlite`
+- PostgreSQL: `postgresql+psycopg://user:password@host/database`
+- MySQL/MariaDB: `mysql+pymysql://user:password@host/database`
+
+Run `openstatspec capabilities` before an integration to inspect the
+machine-readable feature matrix. Export is deliberately strict: if known
+dictionary semantics cannot be reproduced, it stops until you pass the exact
+diagnostic code with `--allow-loss`. This avoids silent loss while making an
+intentional lossy export auditable.
+
+The matrix is also available to Python callers as
+`openstatspec.capability_matrix()`. It distinguishes supported semantics from
+unobservable and fail-closed paths; see the SAV profile for the exact
+the openstatspec-pyspssio boundary.
+
+See [the SAV profile](docs/sav-profile.md) for feature boundaries and
+[release readiness](docs/release-readiness.md) for the pre-tag checklist.
+Read [third-party notices](THIRD_PARTY_NOTICES.md) before distributing a
+bundled application: the required engine includes IBM redistributables under
+separate terms.

openstatspec-0.1.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+openstatspec/__init__.py,sha256=iRyg5vqDG5vAAKaVd-ydAw3A7zeZnM1VstlBayv93bw,411
+openstatspec/api.py,sha256=Ro8MZOm5gpgLjb_urJ1xxbVWlHwiz1P8BhxqSFKkPQA,4256
+openstatspec/cli.py,sha256=0jgq5nL6KIOnRoPf2vyRH96b41MQJCYbuqWKoOP0LTw,2354
+openstatspec/core/__init__.py,sha256=Qbf46KjoTiQOGdxVmC1w95jI3eFPOlf9dQF6QClETr8,1081
+openstatspec/core/results.py,sha256=hujBICiAWG2rc4opw6RyeetJFO4tfTP8e9LL1rGieto,1413
+openstatspec/spss/__init__.py,sha256=yGwHe2mNYAykpfKqAvUWsiwASZUS1GKiaXNrw0b99Lk,869
+openstatspec/spss/dictionary.py,sha256=orrA3pgfGWmJADS79bZrj-d6ObQWs-TFFMk0szZ7BxM,7285
+openstatspec/spss/raw_dictionary.py,sha256=OEjqIcePtdaYcFtbURkq_rU4jzpR_wuUrvb-3XX3Wjk,15743
+openstatspec/spss/sav.py,sha256=Evj7gQ9zfhGHrOCf1hPI1Vl_7ZbnPFf29FLPTguN-nQ,24025
+openstatspec/sql/__init__.py,sha256=TqBsoucGyI-ETtop-t88czw80ZL8OHZYVf4kRqvsShU,496
+openstatspec/sql/capabilities.py,sha256=JCS2DJX_mAT9a04P8aQELG_YzTOQn1s2gYhmZewhKro,11445
+openstatspec/sql/normative.py,sha256=QNN44RDUGxnPest7_mWTFWxoBxQGL7H4XFuptcvjjtA,24373
+openstatspec/sql/profiles.py,sha256=OPhorXcPBTDO3ItMxeQEthYP71v2WqVhjuaIlkage30,9276
+openstatspec/sql/wide.py,sha256=gSeDTk3n4O_9t1zap_dvhsh8Npn6HTKzqXBlqoeWZFw,53841
+openstatspec-0.1.0.dist-info/METADATA,sha256=pywML9sicWwklme13t-kDn1jll65KA-QCxSERxeigk8,3893
+openstatspec-0.1.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+openstatspec-0.1.0.dist-info/entry_points.txt,sha256=D_2AwhN31w0hQiC_K6auh-GW5FfCH_xF3_QyzjXIuYI,55
+openstatspec-0.1.0.dist-info/RECORD,,

openstatspec-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

openstatspec-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+openstatspec = openstatspec.cli:main