haystack-py 0.1.3__tar.gz

haystack_py-0.1.3/.dockerignore

@@ -0,0 +1,17 @@
+.venv/
+__pycache__/
+*.pyc
+.git/
+.github/
+.claude/
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+dist/
+docs/_build/
+_plan/
+_ctx/
+*.egg-info/
+docker/tls/

haystack_py-0.1.3/.github/workflows/ci.yml

@@ -0,0 +1,102 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+      - run: uv python install
+      - run: uv sync --locked --group lint
+      - name: Ruff check
+        run: uv run ruff check src/ tests/
+      - name: Ruff format check
+        run: uv run ruff format --check src/ tests/
+
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+      - run: uv python install
+      - run: uv sync --locked --group type-check --all-extras
+      - name: Mypy
+        run: uv run mypy
+
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+      - run: uv python install
+      - run: uv sync --locked --group test --all-extras
+      - name: Version consistency check
+        run: |
+          PYPROJECT_VER=$(python3 -c "
+          import re, pathlib
+          text = pathlib.Path('pyproject.toml').read_text()
+          print(re.search(r'^version\s*=\s*\"([^\"]+)\"', text, re.M).group(1))
+          ")
+          INIT_VER=$(python3 -c "
+          import re, pathlib
+          text = pathlib.Path('src/hs_py/__init__.py').read_text()
+          print(re.search(r'^__version__\s*=\s*\"([^\"]+)\"', text, re.M).group(1))
+          ")
+          echo "pyproject.toml: $PYPROJECT_VER"
+          echo "__init__.py:    $INIT_VER"
+          if [ "$PYPROJECT_VER" != "$INIT_VER" ]; then
+            echo "::error::Version mismatch! pyproject.toml and __init__.py must declare the same version."
+            exit 1
+          fi
+      - name: Pytest
+        run: uv run pytest --tb=short -q
+
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+      - run: uv python install
+      - run: uv sync --locked --group docs --all-extras
+      - name: Sphinx build
+        run: uv run sphinx-build -W -b html docs docs/_build/html
+
+  deploy-docs:
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    needs: [lint, typecheck, test, docs]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+      - run: uv python install
+      - run: uv sync --locked --group docs --all-extras
+      - name: Sphinx build
+        run: uv run sphinx-build -W -b html docs docs/_build/html
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/_build/html
+      - id: deployment
+        uses: actions/deploy-pages@v4

haystack_py-0.1.3/.github/workflows/release.yml

@@ -0,0 +1,164 @@
+name: Release
+
+on:
+  workflow_run:
+    workflows: ["CI"]
+    types: [completed]
+    branches: [main]
+
+concurrency:
+  group: release
+  cancel-in-progress: false
+
+jobs:
+  release:
+    if: github.event.workflow_run.conclusion == 'success'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    outputs:
+      new_release: ${{ steps.check_tag.outputs.exists == 'false' }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.workflow_run.head_sha }}
+          fetch-depth: 0
+
+      - name: Extract version from pyproject.toml
+        id: version
+        run: |
+          VERSION=$(python3 -c "
+          import re, pathlib
+          text = pathlib.Path('pyproject.toml').read_text()
+          print(re.search(r'^version\s*=\s*\"([^\"]+)\"', text, re.M).group(1))
+          ")
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          echo "tag=v$VERSION" >> "$GITHUB_OUTPUT"
+
+      - name: Check if tag already exists
+        id: check_tag
+        run: |
+          if git rev-parse "refs/tags/${{ steps.version.outputs.tag }}" >/dev/null 2>&1; then
+            echo "exists=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "exists=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Extract changelog section
+        if: steps.check_tag.outputs.exists == 'false'
+        id: changelog
+        run: |
+          python3 -c "
+          import re, pathlib, os
+          text = pathlib.Path('CHANGELOG.md').read_text()
+          version = '${{ steps.version.outputs.version }}'
+          pattern = rf'## \[{re.escape(version)}\][^\n]*\n(.*?)(?=\n## \[|\Z)'
+          match = re.search(pattern, text, re.DOTALL)
+          body = match.group(1).strip() if match else 'No changelog entry found.'
+          # Write to file to avoid shell escaping issues
+          pathlib.Path('release_body.md').write_text(body)
+          "
+
+      - name: Create and push tag
+        if: steps.check_tag.outputs.exists == 'false'
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git tag -a "${{ steps.version.outputs.tag }}" -m "Release ${{ steps.version.outputs.tag }}"
+          git push origin "${{ steps.version.outputs.tag }}"
+
+      - name: Create GitHub Release
+        if: steps.check_tag.outputs.exists == 'false'
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ steps.version.outputs.tag }}
+          name: ${{ steps.version.outputs.tag }}
+          body_path: release_body.md
+          draft: false
+          prerelease: false
+
+  build:
+    needs: release
+    if: needs.release.outputs.new_release == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.workflow_run.head_sha }}
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Build package
+        run: |
+          pip install build
+          python -m build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  upload-release-assets:
+    needs: [release, build]
+    if: needs.release.outputs.new_release == 'true'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Extract version tag
+        id: version
+        run: |
+          VERSION=$(ls dist/*.tar.gz | sed 's|dist/haystack_py-||;s|\.tar\.gz||')
+          echo "tag=v$VERSION" >> "$GITHUB_OUTPUT"
+
+      - name: Upload assets to GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ steps.version.outputs.tag }}
+          files: dist/*
+
+  # ──────────────────────────────────────────────────────────
+  # PyPI Publish
+  #
+  # Prerequisites (one-time setup):
+  #   1. Go to https://pypi.org/manage/account/publishing/
+  #   2. Add a pending publisher:
+  #      - Package name: haystack-py
+  #      - Owner: jscott3201
+  #      - Repository: hs-py
+  #      - Workflow: release.yml
+  #      - Environment: pypi
+  #   3. In GitHub repo Settings → Environments, create a "pypi"
+  #      environment. Optionally enable required reviewers for
+  #      manual approval before each publish.
+  # ──────────────────────────────────────────────────────────
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/haystack-py
+    permissions:
+      id-token: write
+      attestations: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          print-hash: true

haystack_py-0.1.3/.gitignore

@@ -0,0 +1,49 @@
+# Python-generated files
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+# Distribution / packaging
+build/
+dist/
+wheels/
+*.egg-info/
+*.egg
+
+# Virtual environments
+.venv
+
+# Environment variables
+.env
+.env.*
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing / coverage
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+
+# Jupyter
+.ipynb_checkpoints/
+
+# Claude Code
+CLAUDE.md
+.claude/
+
+# Docs
+docs/_build/
+
+# Context & planning
+_ctx/
+_plan/
+_data/
+
+# Docker local certs
+docker/.certs/

haystack_py-0.1.3/.python-version

@@ -0,0 +1 @@
+3.13

haystack_py-0.1.3/CHANGELOG.md

@@ -0,0 +1,39 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.3] - 2026-02-24
+
+### Changed
+
+- Renamed PyPI package from ``hs-py`` to ``haystack-py``.
+
+## [0.1.2] - 2026-02-24
+
+### Fixed
+
+- Fixed SCRAM middleware tests using monotonic-relative timestamps for reliable CI.
+
+## [0.1.1] - 2026-02-24
+
+### Changed
+
+- Made `rdflib` a core dependency (no longer optional).
+- Local `make` targets now run with `--all-extras` to match CI.
+
+### Fixed
+
+- Fixed SCRAM auth middleware tests (stale handshake purge and token expiry).
+- Fixed RDF turtle export test assertion for prefixed namespace output.
+
+### Added
+
+- MIT license file.
+- License metadata in `pyproject.toml`.
+
+## [0.1.0] - 2026-02-24
+
+Initial release.

haystack_py-0.1.3/Dockerfile

@@ -0,0 +1,36 @@
+# Stage 1: build dependencies + install project
+FROM ghcr.io/astral-sh/uv:python3.13-alpine AS builder
+
+ENV UV_COMPILE_BYTECODE=1 \
+    UV_LINK_MODE=copy \
+    UV_PYTHON_DOWNLOADS=0
+
+WORKDIR /app
+
+# Install dependencies first (cached layer — changes only when lockfile changes)
+RUN --mount=type=cache,target=/root/.cache/uv \
+    --mount=type=bind,source=uv.lock,target=uv.lock \
+    --mount=type=bind,source=pyproject.toml,target=pyproject.toml \
+    uv sync --locked --no-install-project --no-dev --extra server
+
+# Copy source and install the project itself
+COPY . /app
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --locked --no-dev --extra server
+
+# Stage 2: minimal runtime
+FROM python:3.13-alpine
+
+RUN addgroup -g 1000 app && adduser -u 1000 -G app -D app
+
+COPY --from=builder --chown=app:app /app/.venv /app/.venv
+COPY --from=builder --chown=app:app /app/src /app/src
+
+ENV PATH="/app/.venv/bin:$PATH" \
+    DATA_DIR="/app/_data"
+
+WORKDIR /app
+USER app
+EXPOSE 8080
+
+CMD ["python", "-m", "hs_py"]

haystack_py-0.1.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Justin Scott
+
+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.

haystack_py-0.1.3/Makefile

@@ -0,0 +1,89 @@
+.PHONY: lint typecheck test check fix format coverage coverage-html docs \
+       docker-redis docker-test docker-clean \
+       docker-server docker-server-clean docker-test-e2e \
+       docker-tls-certs docker-redis-tls docker-test-tls \
+       docker-timescale docker-test-timescale docker-clean-timescale
+
+lint:
+	uv run ruff check src/ tests/
+	uv run ruff format --check src/ tests/
+
+typecheck:
+	uv run --all-extras mypy
+
+test:
+	uv run --all-extras pytest --tb=short -q
+
+check: lint typecheck test
+
+fix:
+	uv run ruff check --fix src/ tests/
+	uv run ruff format src/ tests/
+
+format:
+	uv run ruff format src/ tests/
+
+coverage:
+	uv run --all-extras pytest --cov --cov-report=term-missing
+
+coverage-html:
+	uv run --all-extras pytest --cov --cov-report=html
+
+docs:
+	uv run --group docs sphinx-build -W -b html docs docs/_build/html
+
+# ---------------------------------------------------------------------------
+# Docker / Server
+# ---------------------------------------------------------------------------
+
+docker-server:
+	$(COMPOSE) up -d --build redis server
+
+docker-server-clean:
+	$(COMPOSE) down
+
+docker-test-e2e: docker-server
+	$(COMPOSE) up -d --wait server
+	HS_PY_DOCKER_E2E=1 uv run pytest tests/test_e2e_docker.py --tb=short -q
+
+# ---------------------------------------------------------------------------
+# Docker / Redis integration tests
+# ---------------------------------------------------------------------------
+
+COMPOSE := docker compose -f docker/docker-compose.yml
+
+docker-redis:
+	$(COMPOSE) up -d redis
+
+docker-test: docker-redis
+	$(COMPOSE) up -d --wait redis
+	uv run pytest tests/test_redis_ops.py --tb=short -q
+
+docker-clean:
+	$(COMPOSE) down -v --remove-orphans
+
+# ---------------------------------------------------------------------------
+# Docker / Redis TLS integration tests
+# ---------------------------------------------------------------------------
+
+docker-tls-certs:
+	uv run python docker/gen_tls_certs.py
+
+docker-redis-tls: docker-tls-certs
+	$(COMPOSE) up -d --wait redis-tls
+
+docker-test-tls: docker-redis-tls
+	uv run pytest tests/test_redis_tls.py --tb=short -q
+
+# ---------------------------------------------------------------------------
+# Docker / TimescaleDB integration tests
+# ---------------------------------------------------------------------------
+
+docker-timescale:
+	$(COMPOSE) up -d --wait timescaledb
+
+docker-test-timescale: docker-timescale
+	uv run pytest tests/test_storage_timescale.py --tb=short -q
+
+docker-clean-timescale:
+	$(COMPOSE) down -v --remove-orphans timescaledb