pgiscluster 0.2.0__tar.gz

pgiscluster-0.2.0/.copier-answers.yml

@@ -0,0 +1,13 @@
+# Changes here will be overwritten by Copier
+_commit: v1.5.0
+_src_path: https://github.com/DragonBishop/python-copier-template-ds.git
+github_actions: true
+include_module: true
+include_notebooks: false
+include_reports: false
+module_name: pgiscluster
+project_name: pgiscluster
+project_type: data_science
+publish_to_pypi: true
+python_version: 3.14.7
+use_rumdl: true

pgiscluster-0.2.0/.gitattributes

@@ -0,0 +1 @@
+uv.lock linguist-generated=true

pgiscluster-0.2.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,92 @@
+name: Bug report
+description: Report a defect or error with the project
+title: 'Bug: '
+labels: ["bug"]
+body:
+# Description of issue template
+  - type: markdown
+    attributes:
+      value: >
+        Thank you for reporting a bug! Please provide as much detail as possible in the fields provided.
+# Expected behavior
+  - type: textarea
+    id: exp-behave
+    attributes:
+      label: Expected Behavior
+      description: A concise description of what you expected to happen.
+    validations:
+      required: true
+# Describe the bug
+  - type: textarea
+    id: bug-describe
+    attributes:
+      label: Describe the Bug
+      description: A clear description of what is actually happening.
+    validations:
+      required: true
+# To Reproduce
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: To Reproduce
+      description: List the exact steps to reproduce the bug.
+      value: |
+        1.
+        2.
+        3.
+    validations:
+      required: true
+  - type: checkboxes
+    id: tooling
+    attributes:
+      label: Relevant Tools
+      description: What tools were you using when the bug occurred? Check everything relevant to this report.
+      options:
+        - label: Python script
+        - label: Notebook (Jupyter, JupyterLab, Colab)
+        - label: R environment (RStudio, Rscript, R Markdown)
+        - label: Distributed compute (Spark, Dask, Ray)
+        - label: PostgreSQL
+        - label: SQLite
+        - label: DuckDB
+        - label: MySQL / MariaDB
+        - label: Cloud warehouse (BigQuery, Snowflake, Redshift)
+  - type: input
+    id: tools-other
+    attributes:
+      label: Other Tools
+      description: Add any relevant tools that were not listed above.
+      placeholder: "e.g. dbt, Airflow, Databricks"
+    validations:
+      required: false
+# Type of OS
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating System
+      options:
+        - Windows
+        - macOS
+        - Linux
+        - Android
+        - iOS
+        - Other
+    validations:
+      required: true
+# OS Version
+  - type: input
+    id: os-vers
+    attributes:
+      label: OS Version
+      description: >
+        What version of this operating system did you use? (If you chose other, specify your OS here)
+    validations:
+      required: true
+# Dependencies / Additional Context
+  - type: textarea
+    id: dependencies
+    attributes:
+      label: Dependencies and Additional Context
+      description: >
+        Provide any additional context here, such as the dependencies used in a Python project. Paste uv pip list, pip freeze,
+        conda list, etc. Remember, the most common reason for Python bug reports is dependency management!

pgiscluster-0.2.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

pgiscluster-0.2.0/.github/ISSUE_TEMPLATE/documentation-update.yml

@@ -0,0 +1,46 @@
+name: Documentation Update
+description: Report missing, unclear, outdated, or incorrect documentation
+title: 'Docs: '
+labels: ["documentation"]
+body:
+# Page Location
+  - type: input
+    id: page-location
+    attributes:
+      label: Page Location
+      description: Provide a URL or file path to the page needing update (e.g. `README.md`)
+    validations:
+      required: true
+# Current Problem Types
+  - type: checkboxes
+    id: problem-type
+    attributes:
+      label: Problem Type
+      description: 'Please check all that apply:'
+      options:
+        - label: Outdated info
+        - label: Incorrect info
+        - label: Missing info
+        - label: Broken link / formatting
+        - label: Typo / Grammatical error
+# Describe the Problem
+  - type: textarea
+    id: problem-describe
+    attributes:
+      label: Problem Description
+      description: Explain what's wrong, confusing or missing to you. Copy-paste text if applicable
+    validations:
+      required: true
+# Proposed Changes
+  - type: textarea
+    id: changes
+    attributes:
+      label: Proposed Changes
+      description: >
+        What should the documentation say instead? Make your suggestions here.
+# Additional Context
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional Context
+      description: Provide any additional context about the issue below.

pgiscluster-0.2.0/.github/ISSUE_TEMPLATE/feature-proposal.yml

@@ -0,0 +1,65 @@
+name: Feature Proposal
+description: Propose an enhancement or new feature for the project
+title: 'Proposal: '
+labels: ["enhancement"]
+body:
+# Because
+  - type: markdown
+    attributes:
+      value: >
+        Use this to propose the project do something it currently does not. Use a bug report for broken features. Please be concise!
+  - type: textarea
+    id: rationale
+    attributes:
+      label: Because...
+      description: |
+        What is the problem you are trying to solve?
+        Describe the context of the problem.
+      placeholder: "The same setup steps get repeated by hand in every new project..."
+    validations:
+      required: true
+# I Propose
+  - type: textarea
+    id: proposal
+    attributes:
+      label: I Propose...
+      description: |
+        Describe the change in operational terms.
+        What specifically needs to happen?
+      placeholder: "A single command that runs the whole setup sequence..."
+    validations:
+      required: true
+# So That
+  - type: textarea
+    id: outcome
+    attributes:
+      label: So That...
+      description: |
+        Who benefits from this proposal?
+        What would show that it worked?
+      placeholder: "A new contributor can get moving on a project without being slowed down by..."
+    validations:
+      required: true
+# Alternatives
+  - type: textarea
+    id: alternative
+    attributes:
+      label: Alternatives
+      description: Describe workarounds or alternatives you've tried, if any.
+# Implementing
+  - type: dropdown
+    id: implement
+    attributes:
+      label: Are you willing to work on implementing this change?
+      options:
+        - "Yes"
+        - "No"
+    validations:
+      required: true
+# Additional Notes
+  - type: textarea
+    id: notes
+    attributes:
+      label: Additional Notes
+      description: >
+        Provide relevant file paths, scripts, documentation, or any other additional notes about this proposal.

pgiscluster-0.2.0/.github/ISSUE_TEMPLATE/technical-debt-resolution.yml

@@ -0,0 +1,47 @@
+name: Technical Debt Resolution
+description: Flag code that works but will cost the project later
+title: 'Debt: '
+labels: ["enhancement"]
+body:
+# Context
+  - type: textarea
+    id: context
+    attributes:
+      label: Context
+      description: Explain the source of tech debt in operational terms. What happens?
+    validations:
+      required: true
+# Risk
+  - type: textarea
+    id: risk
+    attributes:
+      label: Risk
+      description: Explain how and why this creates a liability for the project.
+    validations:
+      required: true
+# Urgency
+  - type: dropdown
+    id: urgency
+    attributes:
+      label: When will this become a problem?
+      options:
+        - It Already Has
+        - Soon
+        - Eventually
+    validations:
+      required: true
+# Resolution
+  - type: textarea
+    id: resolution
+    attributes:
+      label: Resolution Proposal
+      description: Explain what specific changes will eliminate this technical debt
+    validations:
+      required: true
+# Additional Notes
+  - type: textarea
+    id: notes
+    attributes:
+      label: Additional Notes
+      description: >
+        Provide relevant file paths, scripts, documentation, or any other additional notes about this issue.

pgiscluster-0.2.0/.github/workflows/lint.yml

@@ -0,0 +1,27 @@
+name: lint
+
+on:
+  workflow_dispatch:
+  pull_request:
+  # push:
+  #   branches: [main]
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+      - name: "Set up Python"
+        uses: actions/setup-python@v6
+        with:
+          python-version-file: ".python-version"
+      - name: Install the project
+        run: uv sync --only-group lint --frozen
+      - name: check format
+        run: uv run ruff format --check --diff .
+      - name: check lints
+        run: uv run ruff check --output-format=github .

pgiscluster-0.2.0/.github/workflows/publish.yml

@@ -0,0 +1,35 @@
+name: publish
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v6
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+      - name: "Set up Python"
+        uses: actions/setup-python@v6
+        with:
+          python-version-file: ".python-version"
+      - name: Add repository URLs to package metadata
+        run: |
+          cat >> pyproject.toml << EOF
+
+          [project.urls]
+          Homepage = "${{ github.server_url }}/${{ github.repository }}"
+          Repository = "${{ github.server_url }}/${{ github.repository }}"
+          Issues = "${{ github.server_url }}/${{ github.repository }}/issues"
+          EOF
+      - name: Build package
+        run: uv build
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

pgiscluster-0.2.0/.github/workflows/release.yml

@@ -0,0 +1,61 @@
+name: release
+
+on:
+  push:
+    branches: [main]
+  pull_request_target:
+    types: [opened, reopened, edited, synchronize]
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+
+concurrency:
+  group: release-${{ github.head_ref || github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  lint-pr-title:
+    if: ${{ github.event_name == 'pull_request_target' }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: amannn/action-semantic-pull-request@v6
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  release-please:
+    if: ${{ github.event_name == 'push' }}
+    runs-on: ubuntu-latest
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+      tag_name: ${{ steps.release.outputs.tag_name }}
+    steps:
+      - uses: actions/create-github-app-token@v2
+        id: app-token
+        with:
+          app-id: ${{ secrets.RELEASE_PLEASE_APP_ID }}
+          private-key: ${{ secrets.RELEASE_PLEASE_APP_PRIVATE_KEY }}
+      - uses: googleapis/release-please-action@v5
+        id: release
+        with:
+          token: ${{ steps.app-token.outputs.token }}
+
+  regenerate-changelog:
+    needs: release-please
+    if: ${{ needs.release-please.outputs.release_created }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: main
+          fetch-depth: 0
+      - uses: orhun/git-cliff-action@v4
+        with:
+          args: -o CHANGELOG.md
+      - run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add CHANGELOG.md
+          git commit -m "docs: regenerate changelog for ${{ needs.release-please.outputs.tag_name }}" || exit 0
+          git push

pgiscluster-0.2.0/.github/workflows/tests.yml

@@ -0,0 +1,34 @@
+name: tests
+
+on:
+  workflow_dispatch:
+  pull_request:
+  # push:
+  #   branches: [main]
+permissions:
+  contents: read
+
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+      - name: "Set up Python"
+        uses: actions/setup-python@v6
+        with:
+          python-version-file: ".python-version"
+      - name: Install the project
+        run: uv sync --all-extras --all-groups --frozen
+      - name: unit tests
+        run: |
+          set -o pipefail && \
+          uv run pytest --cov=src/pgiscluster --cov-report=term-missing:skip-covered --junitxml=pytest.xml \
+          | tee pytest-coverage.txt
+      - name: Pytest coverage comment
+        uses: MishaKav/pytest-coverage-comment@main
+        continue-on-error: true
+        with:
+          pytest-coverage-path: ./pytest-coverage.txt
+          junitxml-path: ./pytest.xml

pgiscluster-0.2.0/.gitignore

@@ -0,0 +1,193 @@
+[Uu]ntitled*
+scratch*
+
+# Windows thumbnail cache files
+Thumbs.db
+Thumbs.db:encryptable
+ehthumbs.db
+ehthumbs_vista.db
+
+# Dump file
+*.stackdump
+
+# Folder config file
+[Dd]esktop.ini
+
+# Recycle Bin used on file shares
+$RECYCLE.BIN/
+
+# Windows Installer files
+*.cab
+*.msi
+*.msix
+*.msm
+*.msp
+
+# Windows shortcuts
+*.lnk
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+lcov.info
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+.ruff_cache/
+.rumdl_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/

pgiscluster-0.2.0/.pre-commit-config.yaml

@@ -0,0 +1,24 @@
+repos:
+-   repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+    -   id: trailing-whitespace
+    -   id: end-of-file-fixer
+    -   id: check-yaml
+        args: [--allow-multiple-documents]
+    -   id: check-merge-conflict
+-   repo: https://github.com/astral-sh/ruff-pre-commit
+    # Ruff version.
+    rev: v0.16.5
+    hooks:
+      # Run the linter.
+    -   id: ruff-check
+        types_or: [python, pyi]
+        # Run the formatter.
+    -   id: ruff-format
+        types_or: [python, pyi]
+-   repo: https://github.com/rvben/rumdl-pre-commit
+    rev: v0.2.62
+    hooks:
+      - id: rumdl      # Lint only (fails on issues)
+      - id: rumdl-fmt  # Auto-format and fail if issues remain

pgiscluster-0.2.0/.python-version

@@ -0,0 +1 @@
+3.14.7

pgiscluster-0.2.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.2.0"
+}

pgiscluster-0.2.0/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+## [0.2.0](https://github.com/DragonBishop/pgiscluster/compare/v0.1.0...v0.2.0) (2026-09-17)
+
+
+### Features
+
+* add dependencies and pyproject.toml metadata ([a06394c](https://github.com/DragonBishop/pgiscluster/commit/a06394c0ac37325e77b3a6dae1cb518e92c9617d))
+* **connector:** add HostDBConnector and HostAdminDBConnector, file-based db_query, pluggable target resolver ([2556cd4](https://github.com/DragonBishop/pgiscluster/commit/2556cd450ce50e745953ca57032b7e8d4c82ab50))
+* **connector:** implement DBConnector._get_target CiliumLocalRedirectPolicy lookup ([5c51b46](https://github.com/DragonBishop/pgiscluster/commit/5c51b46ad49b2630e34991a597f9cf090e0c0722))
+* initialize project via copier template (uv, pytest, CI, notebooks) ([af5469c](https://github.com/DragonBishop/pgiscluster/commit/af5469c8d63cfd6e77fdf920d3800a1da2b280f4))
+* prepare pgiscluster for publication ([cc2e1b9](https://github.com/DragonBishop/pgiscluster/commit/cc2e1b9593042afcb230f74f1c4e11ee4eade194))
+* Update dependencies and configurations across multiple components ([51e42d9](https://github.com/DragonBishop/pgiscluster/commit/51e42d91908444ae48fcb50fee4f088bf629827f))
+
+
+### Documentation
+
+* move package README to repo root, fix repo links ([6c2420c](https://github.com/DragonBishop/pgiscluster/commit/6c2420c034aa5eb8a4623bd8cf8a6c282aacdff7))
+* regenerate changelog for v1.0.0 ([9e258b1](https://github.com/DragonBishop/pgiscluster/commit/9e258b1a27594c8ed8ccb9815cd987ff3578f947))