x-pug-utils 0.0.2__tar.gz

x_pug_utils-0.0.2/PKG-INFO

@@ -0,0 +1,21 @@
+Metadata-Version: 2.4
+Name: x-pug-utils
+Version: 0.0.2
+Summary: Parse PubChem PUG JSON into xsimple property and safety data.
+License-Expression: MIT
+Keywords: pubchem,pug,chemistry
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# x-pug-utils
+
+Parse a PubChem PUG/PUG-View JSON document into the xsimple property and safety schema.
+
+```python
+from x_pug_utils import parse_pug, parse_pug_file
+
+result = parse_pug_file("COMPOUND_CID_2244.json")
+# or: result = parse_pug(pug_json_dict)
+```
+
+The package uses only the Python standard library and always returns the xsimple schema.

x_pug_utils-0.0.2/README.md

@@ -0,0 +1,12 @@
+# x-pug-utils
+
+Parse a PubChem PUG/PUG-View JSON document into the xsimple property and safety schema.
+
+```python
+from x_pug_utils import parse_pug, parse_pug_file
+
+result = parse_pug_file("COMPOUND_CID_2244.json")
+# or: result = parse_pug(pug_json_dict)
+```
+
+The package uses only the Python standard library and always returns the xsimple schema.

x_pug_utils-0.0.2/pyproject.toml

@@ -0,0 +1,18 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "x-pug-utils"
+version = "0.0.2"
+description = "Parse PubChem PUG JSON into xsimple property and safety data."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+keywords = ["pubchem", "pug", "chemistry"]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

x_pug_utils-0.0.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

x_pug_utils-0.0.2/src/x_pug_utils/__init__.py

@@ -0,0 +1,33 @@
+"""Public API for parsing PubChem PUG data into the xsimple schema."""
+
+from __future__ import annotations
+
+import json
+from collections.abc import Mapping
+from pathlib import Path
+from typing import Any
+
+from ._parser import PubChemPugParser
+
+__all__ = ["parse_pug", "parse_pug_file", "parse_pug_json"]
+
+
+def parse_pug_json(pug_data: Mapping[str, Any]) -> dict[str, Any]:
+    """Parse a PUG JSON mapping and return only the xsimple schema."""
+    return PubChemPugParser(dict(pug_data)).parse(mode="xsimple")
+
+
+def parse_pug_file(path: str | Path) -> dict[str, Any]:
+    """Read and parse a local PUG JSON file into the xsimple schema."""
+    with Path(path).open("r", encoding="utf-8") as handle:
+        data = json.load(handle)
+    if not isinstance(data, Mapping):
+        raise ValueError("PUG JSON root must be an object.")
+    return parse_pug_json(data)
+
+
+def parse_pug(pug_data: Mapping[str, Any] | str | Path) -> dict[str, Any]:
+    """Parse a PUG JSON mapping or local JSON path into the xsimple schema."""
+    if isinstance(pug_data, Mapping):
+        return parse_pug_json(pug_data)
+    return parse_pug_file(pug_data)