pyhdtkit 0.1.0__py3-none-any.whl

pyhdtkit/__init__.py

@@ -0,0 +1,5 @@
+from pyhdtkit.convert import hdt2ttl, hdtcat, ttl2hdt
+
+__version__ = "0.1.0"
+
+__all__ = ["__version__", "ttl2hdt", "hdt2ttl", "hdtcat"]

pyhdtkit/convert.py

@@ -0,0 +1,66 @@
+"""Public conversion API for pyhdtkit.
+
+These functions are the stable Python-facing surface. They currently raise
+``NotImplementedError`` — this is just the base scaffold. The pure-Python HDT
+read/write and Turtle parse/serialize logic lands in a follow-up phase.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+
+def ttl2hdt(
+    input_path: str | Path,
+    output_path: str | Path,
+    *,
+    base_uri: str | None = None,
+) -> None:
+    """Convert a Turtle (``.ttl``) file to HDT (``.hdt``).
+
+    Args:
+        input_path: Path to the source ``.ttl`` file.
+        output_path: Path to write the resulting ``.hdt`` file.
+        base_uri: Optional base URI for resolving relative IRIs while parsing.
+
+    Raises:
+        ValueError: The ``.ttl`` file could not be parsed or the ``.hdt`` file could
+            not be written (e.g. malformed Turtle, or an unwritable output path).
+    """
+    raise NotImplementedError("ttl2hdt is not implemented yet")
+
+
+def hdt2ttl(
+    input_path: str | Path,
+    output_path: str | Path,
+) -> None:
+    """Convert an HDT (``.hdt``) file to Turtle (``.ttl``).
+
+    Args:
+        input_path: Path to the source ``.hdt`` file.
+        output_path: Path to write the resulting ``.ttl`` file.
+
+    Raises:
+        ValueError: The ``.hdt`` file could not be read or the ``.ttl`` file could
+            not be written (e.g. a malformed HDT file, or an unwritable output path).
+    """
+    raise NotImplementedError("hdt2ttl is not implemented yet")
+
+
+def hdtcat(
+    input_paths: list[str | Path],
+    output_path: str | Path,
+) -> None:
+    """Combine two or more ``.hdt`` files into a single ``.hdt``, de-duplicating triples.
+
+    Args:
+        input_paths: Paths of the ``.hdt`` files to merge (2 or more).
+        output_path: Path to write the merged ``.hdt`` file.
+
+    Raises:
+        ValueError: Fewer than 2 input paths were given, or an input ``.hdt`` could
+            not be read, or the ``.hdt`` file could not be written.
+    """
+    if len(input_paths) < 2:
+        raise ValueError("hdtcat requires at least 2 input .hdt files")
+    raise NotImplementedError("hdtcat is not implemented yet")

pyhdtkit-0.1.0.dist-info/METADATA

@@ -0,0 +1,43 @@
+Metadata-Version: 2.5
+Name: pyhdtkit
+Version: 0.1.0
+Summary: Convert between RDF Turtle (.ttl) and HDT (.hdt) in pure Python — ttl2hdt, hdt2ttl, hdtcat.
+Project-URL: Homepage, https://github.com/Shyam-Sundar-Reddy/pyhdtkit
+Project-URL: Repository, https://github.com/Shyam-Sundar-Reddy/pyhdtkit
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.12
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# pyhdtkit
+
+A pure-Python package to convert between RDF Turtle (`.ttl`) and HDT (`.hdt`):
+
+- `.ttl` → `.hdt`
+- `.hdt` → `.ttl`
+- combine two or more `.hdt` files into one
+
+No CLI — `import pyhdtkit` is the interface. No Rust, no native extension.
+
+## Install (dev)
+
+```bash
+pip install -e ".[dev]"
+```
+
+## Usage
+
+```python
+from pyhdtkit import ttl2hdt, hdt2ttl, hdtcat
+
+ttl2hdt("graph.ttl", "graph.hdt")
+hdt2ttl("graph.hdt", "graph.ttl")
+hdtcat(["a.hdt", "b.hdt"], "combined.hdt")
+```
+
+## Status
+
+Base scaffold. The public API shape above is stable, but conversion is not
+implemented yet — each function currently raises `NotImplementedError`.

pyhdtkit-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+pyhdtkit/__init__.py,sha256=jD7ET34iUletNA1RmWWVJZoa4KusDAQsmpF2eKKN_vo,136
+pyhdtkit/convert.py,sha256=Yg7rL_t7dCfTul29zm3ej4nru6jKEAQLsZqkBReweNQ,2160
+pyhdtkit-0.1.0.dist-info/METADATA,sha256=pbVywcTiki7AD2KkMJzSrk9qctYgsbbRv9knuQ5zXmg,1111
+pyhdtkit-0.1.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+pyhdtkit-0.1.0.dist-info/licenses/LICENSE,sha256=F_16S-wvboW4UBPOriGjEVr4_KBle8BkaFgyf-EieEA,1075
+pyhdtkit-0.1.0.dist-info/RECORD,,

pyhdtkit-0.1.0.dist-info/WHEEL

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

pyhdtkit-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shyam Sundar Reddy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.