sap-knowledge-pipeline 0.1.0a1__tar.gz

sap_knowledge_pipeline-0.1.0a1/.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.py]
+indent_style = space
+indent_size = 4
+
+[*.{yml,yaml}]
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false

sap_knowledge_pipeline-0.1.0a1/.gitattributes

@@ -0,0 +1,9 @@
+* text=auto
+
+*.py text eol=lf
+*.md text eol=lf
+*.toml text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf
+*.svg text eol=lf
+

sap_knowledge_pipeline-0.1.0a1/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,58 @@
+name: Bug report
+description: Report reproducible incorrect behavior
+title: "[Bug]: "
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a problem. Never include SAP credentials, private hostnames, continuation URLs, or customer data.
+  - type: input
+    id: version
+    attributes:
+      label: Package version
+      placeholder: 0.1.0a1
+    validations:
+      required: true
+  - type: dropdown
+    id: source
+    attributes:
+      label: Source
+      options:
+        - OData V2
+        - OData V4
+        - SAP HANA
+        - Knowledge transformation
+        - Vector indexing or retrieval
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened?
+      description: Explain the observed and expected behavior.
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Minimal reproduction
+      description: Use synthetic data and remove all secrets and private identifiers.
+      render: python
+    validations:
+      required: true
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Include Python, operating system, Django if relevant, and SAP interface versions.
+    validations:
+      required: true
+  - type: checkboxes
+    id: safety
+    attributes:
+      label: Data safety
+      options:
+        - label: I removed credentials, tokens, private URLs, customer data, and production records.
+          required: true

sap_knowledge_pipeline-0.1.0a1/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security report
+    url: https://github.com/yassinbahri/sap-knowledge-pipeline/security/advisories/new
+    about: Report vulnerabilities privately. Do not open a public issue.

sap_knowledge_pipeline-0.1.0a1/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,26 @@
+name: Feature request
+description: Propose a focused source, transformation, or retrieval improvement
+title: "[Feature]: "
+labels: [enhancement]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What SAP-to-knowledge workflow is difficult today?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed behavior
+      description: Describe the smallest useful public contract.
+    validations:
+      required: true
+  - type: textarea
+    id: safety
+    attributes:
+      label: Security and data considerations
+      description: Explain authorization, sensitive fields, provenance, and compatibility concerns.
+    validations:
+      required: true

sap_knowledge_pipeline-0.1.0a1/.github/dependabot.yml

@@ -0,0 +1,13 @@
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: /
+    schedule:
+      interval: weekly
+    groups:
+      python-dependencies:
+        patterns: ["*"]
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly

sap_knowledge_pipeline-0.1.0a1/.github/pull_request_template.md

@@ -0,0 +1,23 @@
+## Summary
+
+Describe the problem and the behavior introduced by this change.
+
+Fixes #
+
+## Testing
+
+- [ ] Added or updated focused tests.
+- [ ] Ran `ruff check .`.
+- [ ] Ran `ruff format --check .`.
+- [ ] Ran `mypy src`.
+- [ ] Ran `pytest`.
+
+## SAP data safety
+
+- [ ] This change contains no credentials, private SAP URLs, customer data, production metadata, or sensitive continuation URLs.
+- [ ] New fields are explicitly allow-listed and provenance remains available.
+- [ ] Tests are offline and use synthetic fixtures or fake connections.
+
+## Documentation
+
+- [ ] Updated user documentation and `CHANGELOG.md` when behavior changed.

sap_knowledge_pipeline-0.1.0a1/.github/workflows/ci.yml

@@ -0,0 +1,62 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+      - name: Upgrade pip
+        run: python -m pip install --upgrade pip
+      - name: Install project and development dependencies
+        run: python -m pip install --group dev -e .
+      - name: Lint
+        run: ruff check .
+      - name: Check formatting
+        run: ruff format --check .
+      - name: Type check
+        run: mypy src
+      - name: Test
+        run: pytest
+
+  package:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.13"
+          cache: pip
+      - run: python -m pip install build check-wheel-contents twine
+      - run: python -m build
+      - run: twine check --strict dist/*
+      - run: check-wheel-contents dist/*.whl
+      - name: Smoke test the built wheel
+        run: |
+          python -m venv /tmp/sap-knowledge-wheel
+          /tmp/sap-knowledge-wheel/bin/python -m pip install dist/*.whl
+          /tmp/sap-knowledge-wheel/bin/python -c "import sap_knowledge; print(sap_knowledge.__version__)"
+          /tmp/sap-knowledge-wheel/bin/sap-knowledge --version
+      - uses: actions/upload-artifact@v7
+        with:
+          name: distributions
+          path: dist/
+          if-no-files-found: error

sap_knowledge_pipeline-0.1.0a1/.github/workflows/publish.yml

@@ -0,0 +1,43 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build and validate distributions
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.13"
+      - run: python -m pip install build check-wheel-contents twine
+      - run: python -m build
+      - run: twine check --strict dist/*
+      - run: check-wheel-contents dist/*.whl
+      - uses: actions/upload-artifact@v7
+        with:
+          name: distributions
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    name: Publish distributions
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/sap-knowledge-pipeline
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: distributions
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@v1.14.2

sap_knowledge_pipeline-0.1.0a1/.gitignore

@@ -0,0 +1,12 @@
+.venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+dist/
+build/
+*.egg-info/
+.env
+/data/
+/state/

sap_knowledge_pipeline-0.1.0a1/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+All notable changes to SAP Knowledge Pipeline are documented here. The project
+uses semantic versioning and publishes pre-releases while the public API is
+still evolving.
+
+## [Unreleased]
+
+## [0.1.0a1] - 2026-08-01
+
+### Added
+
+- OData V2 and V4 clients with safe server-driven pagination.
+- EDMX metadata inspection and validated Business Partner recipes.
+- Allow-listed document rendering, deterministic chunking, and citations.
+- Resumable OData synchronization with JSONL upsert/delete events.
+- Local FastEmbed embeddings, Qdrant indexing, search, and grounded prompts.
+- Certificate-validated SAP HANA connectivity and explicit snapshot datasets.
+- Privilege-filtered HANA catalog discovery for schemas, objects, and columns.
+- HANA snapshot conversion into the portable knowledge-event format.
+- Python 3.11 through 3.14 support and a fully offline automated test suite.
+
+[Unreleased]: https://github.com/yassinbahri/sap-knowledge-pipeline/compare/0.1.0a1...HEAD
+[0.1.0a1]: https://github.com/yassinbahri/sap-knowledge-pipeline/releases/tag/0.1.0a1

sap_knowledge_pipeline-0.1.0a1/CODE_OF_CONDUCT.md

@@ -0,0 +1,27 @@
+# Code of Conduct
+
+## Our commitment
+
+We are committed to making participation in this project a respectful,
+harassment-free experience for everyone, regardless of background, identity,
+experience level, or personal characteristics.
+
+## Expected behavior
+
+- Be respectful, patient, and constructive.
+- Focus criticism on ideas and code, not people.
+- Welcome questions and contributors with different experience levels.
+- Protect private SAP, customer, and security information.
+- Accept maintainer decisions gracefully and help improve the discussion.
+
+## Unacceptable behavior
+
+Harassment, discrimination, personal attacks, deliberate intimidation,
+publication of private information, and sustained disruptive behavior are not
+acceptable.
+
+## Enforcement
+
+Report conduct concerns privately through the maintainer's GitHub profile.
+Maintainers may edit or remove contributions and temporarily or permanently ban
+participants whose behavior is harmful to the community.

sap_knowledge_pipeline-0.1.0a1/CONTRIBUTING.md

@@ -0,0 +1,62 @@
+# Contributing
+
+Thank you for helping build SAP Knowledge Pipeline. The project is in an early
+stage, so small protocol fixtures, documentation improvements, and focused bug
+fixes are especially valuable.
+
+## Set up the project
+
+Fork the repository, clone your fork, and create a branch from `main`:
+
+```console
+git clone https://github.com/YOUR-USERNAME/sap-knowledge-pipeline.git
+cd sap-knowledge-pipeline
+git switch -c fix/short-description
+python -m venv .venv
+```
+
+Activate the environment and install the development dependencies:
+
+```console
+# Windows PowerShell
+.venv\Scripts\Activate.ps1
+python -m pip install --group dev -e .
+
+# macOS or Linux
+source .venv/bin/activate
+python -m pip install --group dev -e .
+```
+
+## Run the checks
+
+Run the same checks used by CI before opening a pull request:
+
+```console
+ruff check .
+ruff format --check .
+mypy src
+pytest
+```
+
+Use `ruff format .` to apply formatting. Add a regression test for every bug
+fix. Tests must not require credentials or a live SAP system; use an
+`httpx.MockTransport`, fake DB-API connection, and sanitized fixtures instead.
+
+## Security and test data
+
+Never commit SAP credentials, cookies, tokens, internal hostnames, customer
+data, or metadata copied from a private system. Reduce payloads to the smallest
+synthetic fixture that demonstrates the behavior.
+
+Please do not open a public issue for a suspected vulnerability. Until a
+private security contact is published, follow [SECURITY.md](SECURITY.md).
+
+By participating, you agree to follow the project's
+[Code of Conduct](CODE_OF_CONDUCT.md).
+
+## Pull requests
+
+Keep pull requests focused. In the description, explain the problem, the chosen
+behavior, and how it was tested. Link the related issue with `Fixes #123` when
+appropriate. Maintainers may ask for changes when a contribution expands the
+public API or weakens continuation-link validation.

sap_knowledge_pipeline-0.1.0a1/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Yassin Bahri
+
+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.
+