pyhdtkit 0.1.0__tar.gz

pyhdtkit-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: Tests
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v5
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Install package with dev extras
+        run: uv sync --extra dev
+
+      - name: Run tests
+        run: uv run pytest -q

pyhdtkit-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,57 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Install package with dev extras
+        run: uv sync --extra dev
+
+      - name: Run tests
+        run: uv run pytest -q
+
+  build:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Build sdist and wheel
+        run: uv build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

pyhdtkit-0.1.0/.gitignore

@@ -0,0 +1,45 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+*.pyd
+build/
+dist/
+wheels/
+*.egg-info/
+*.egg
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Environment files
+.env
+.env.*
+
+# Testing / coverage
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+
+# Type checking / linting
+.mypy_cache/
+.ruff_cache/
+.pytype/
+
+# Packaging
+*.tar.gz
+*.whl
+
+# Editors / OS
+.vscode/
+.idea/
+.DS_Store
+Thumbs.db
+
+# Local notes / agent context
+agentskill.md

pyhdtkit-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

pyhdtkit-0.1.0/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.

pyhdtkit-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,30 @@
+# 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/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pyhdtkit"
+version = "0.1.0"
+description = "Convert between RDF Turtle (.ttl) and HDT (.hdt) in pure Python — ttl2hdt, hdt2ttl, hdtcat."
+readme = "README.md"
+requires-python = ">=3.12"
+license = { text = "MIT" }
+dependencies = []
+
+[project.optional-dependencies]
+dev = ["pytest>=8"]
+
+[project.urls]
+Homepage = "https://github.com/Shyam-Sundar-Reddy/pyhdtkit"
+Repository = "https://github.com/Shyam-Sundar-Reddy/pyhdtkit"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pyhdtkit"]

pyhdtkit-0.1.0/src/pyhdtkit/__init__.py

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

pyhdtkit-0.1.0/src/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/tests/test_api.py

@@ -0,0 +1,26 @@
+import pytest
+
+import pyhdtkit
+from pyhdtkit import hdt2ttl, hdtcat, ttl2hdt
+
+
+def test_exports() -> None:
+    assert pyhdtkit.__version__
+    assert callable(ttl2hdt)
+    assert callable(hdt2ttl)
+    assert callable(hdtcat)
+
+
+def test_hdtcat_requires_at_least_two_inputs() -> None:
+    with pytest.raises(ValueError):
+        hdtcat(["only-one.hdt"], "out.hdt")
+
+
+def test_ttl2hdt_not_implemented_yet(tmp_path) -> None:
+    with pytest.raises(NotImplementedError):
+        ttl2hdt(tmp_path / "in.ttl", tmp_path / "out.hdt")
+
+
+def test_hdt2ttl_not_implemented_yet(tmp_path) -> None:
+    with pytest.raises(NotImplementedError):
+        hdt2ttl(tmp_path / "in.hdt", tmp_path / "out.ttl")

pyhdtkit-0.1.0/uv.lock

@@ -0,0 +1,78 @@
+version = 1
+revision = 3
+requires-python = ">=3.12"
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },
+]
+
+[[package]]
+name = "packaging"
+version = "26.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/7d/fa/3944b40b07da9ce895c0e6303a5ab7d53da063554f534556b134a54d6093/packaging-26.3.tar.gz", hash = "sha256:94edc256424af38762eb31306eed28beb9f0efc50a8837492c9d6fd6004aed79", size = 313412, upload-time = "2026-08-04T18:15:28.737Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/63/34/ba1c580383c9eada3711951fef0795c80b829a078d72188184bcab9dd527/packaging-26.3-py3-none-any.whl", hash = "sha256:d7193f7c8e4e93f444fde0262bf90af30e16fa0ad0ad44cb553c87339b23cd1c", size = 129956, upload-time = "2026-08-04T18:15:27.159Z" },
+]
+
+[[package]]
+name = "pluggy"
+version = "1.6.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.21.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/49/2e/ced460408999b33da6b31b0021b0f37d329e202d4169aeb164493778f25b/pygments-2.21.0.tar.gz", hash = "sha256:610ca751c9bc2492b38eb9a38a7fbc93edbbb2d7182edaf34e66ae493dee5c8c", size = 5005329, upload-time = "2026-08-17T08:02:48.824Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/71/46/17f022dd3e953bf20a04a028a21ec746d942f8d2af30fa0f124fa0e6a684/pygments-2.21.0-py3-none-any.whl", hash = "sha256:2363c69b61c4a97c838da3b130dcd6468f4848992b21a82f2a63ec34377137d9", size = 1250147, upload-time = "2026-08-17T08:02:44.912Z" },
+]
+
+[[package]]
+name = "pyhdtkit"
+version = "0.1.0"
+source = { editable = "." }
+
+[package.optional-dependencies]
+dev = [
+    { name = "pytest" },
+]
+
+[package.metadata]
+requires-dist = [{ name = "pytest", marker = "extra == 'dev'", specifier = ">=8" }]
+provides-extras = ["dev"]
+
+[[package]]
+name = "pytest"
+version = "9.1.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/e4/47/b9efed96c114afcfa3c9d3fe98a76a1d14c74a9e266d397cf6eb64be5e01/pytest-9.1.1.tar.gz", hash = "sha256:1088fbde8f2b49d95a549a195707afa7a76a3ce9bcadc26b6d71f0ffda5fe313", size = 1636369, upload-time = "2026-06-19T10:58:32.857Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/24/25/1de2678b631f5a49215c6c96fff41ba892b0a34df68d6d80292b1b48aa7f/pytest-9.1.1-py3-none-any.whl", hash = "sha256:37a86b45efb9a47a61a36449063e8e18d0cab3161329fc099eb21783169c4f0c", size = 386536, upload-time = "2026-06-19T10:58:31.347Z" },
+]