relinker 0.6.0__tar.gz

relinker-0.6.0/.editorconfig

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

relinker-0.6.0/.github/dependabot.yml

@@ -0,0 +1,24 @@
+version: 2
+
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      github-actions:
+        patterns:
+          - "*"
+
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      python-dev-tools:
+        patterns:
+          - "pytest*"
+          - "ruff"
+          - "mypy"
+          - "build"
+          - "hatchling"

relinker-0.6.0/.github/pull_request_template.md

@@ -0,0 +1,12 @@
+## Summary
+
+Describe what changed and why.
+
+## Checklist
+
+- [ ] Tests were added or updated when needed.
+- [ ] `python -m ruff format --check .` passes.
+- [ ] `python -m ruff check .` passes.
+- [ ] `python -m mypy src` passes.
+- [ ] `python -m pytest` passes.
+- [ ] Documentation was updated when behavior changed.

relinker-0.6.0/.github/workflows/ci.yml

@@ -0,0 +1,95 @@
+name: CI
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["main"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  quality:
+    name: Quality checks
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+          cache: pip
+
+      - name: Install package with development dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+
+      - name: Check formatting
+        run: python -m ruff format --check .
+
+      - name: Run lint
+        run: python -m ruff check .
+
+      - name: Run type checks
+        run: python -m mypy src
+
+  tests:
+    name: Tests on Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    needs: quality
+
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install package with development dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+
+      - name: Run tests
+        run: python -m pytest
+
+  build:
+    name: Build package
+    runs-on: ubuntu-latest
+    needs: tests
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+          cache: pip
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+
+      - name: Build distribution
+        run: python -m build

relinker-0.6.0/.github/workflows/publish.yml

@@ -0,0 +1,42 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    name: Build and publish to PyPI
+    runs-on: ubuntu-latest
+
+    environment:
+      name: pypi
+      url: https://pypi.org/project/relinker/
+
+    permissions:
+      id-token: write
+      contents: read
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Install build tooling
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish package to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

relinker-0.6.0/.gitignore

@@ -0,0 +1,32 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# Build
+build/
+dist/
+*.egg-info/
+
+# Environments
+.venv/
+venv/
+env/
+
+# Editors
+.vscode/
+.idea/
+
+# OS
+.DS_Store
+Thumbs.db
+
+.venv/
+venv/
+env/

relinker-0.6.0/.pre-commit-config.yaml

@@ -0,0 +1,7 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.9
+    hooks:
+      - id: ruff
+        args: ["--fix"]
+      - id: ruff-format

relinker-0.6.0/APPLYING_DOCS_PATCH.md

@@ -0,0 +1,38 @@
+# Applying this documentation patch
+
+This archive focuses only on documentation and examples.
+
+It replaces or adds:
+
+- `README.md`
+- `CHANGELOG.md`
+- `docs/`
+- `examples/`
+
+It does not change Relinker runtime source code under `src/relinker/`.
+
+## Apply
+
+From the repository root:
+
+```bash
+unzip -o relinker_docs_examples_patch.zip -d .
+```
+
+Then run:
+
+```bash
+python -m ruff format .
+python -m ruff check .
+python -m mypy src
+python -m pytest
+```
+
+Because this patch only changes Markdown and examples, runtime tests should not change unless an example is imported by tests.
+
+## Suggested commit message
+
+```bash
+git add README.md CHANGELOG.md docs examples
+git commit -m "Expand documentation and examples"
+```

relinker-0.6.0/APPLYING_RELINKER_PATCH.md

@@ -0,0 +1,31 @@
+# Relinker implementation patch
+
+This ZIP contains replacement and new files using the same project structure.
+Copy the files into the repository root and allow your file manager to replace
+existing files.
+
+## What changed
+
+- Added `RetryPolicy.doctor()` with a `PolicyHealthReport`.
+- Added `RetryPolicy.preview()` for a concise timing preview.
+- Improved `RetryPolicy.explain()` to be more human-readable.
+- Added event shortcut methods:
+  - `on_before_attempt()`
+  - `on_success()`
+  - `on_failure()`
+  - `on_retry()`
+  - `on_giveup()`
+- Added `RetryPolicy.with_structured_logging()` with safe JSON log fields.
+- Hardened HTTP helpers with validation and safer `Retry-After` parsing.
+- Added `http_retry_policy()` as a friendly HTTP recipe.
+- Exported new public helpers from `relinker.__init__`.
+- Added tests for the new HTTP helpers and guidance features.
+
+## Suggested checks
+
+```bash
+python -m ruff format --check .
+python -m ruff check .
+python -m mypy src
+python -m pytest
+```

relinker-0.6.0/CHANGELOG.md

@@ -0,0 +1,56 @@
+# Changelog
+
+All notable changes to Relinker will be documented in this file.
+
+Relinker follows practical semantic versioning while the project is still pre-1.0. Breaking changes may happen before 1.0, but they should be documented clearly.
+
+## 0.6.0
+
+### Added
+
+- Added `RetryPolicy.doctor()` for human-friendly policy health reports.
+- Added `PolicyHealthReport` with risk levels and JSON-friendly output.
+- Added `RetryPolicy.preview()` for concise retry timing previews.
+- Added more human-friendly `RetryPolicy.explain()` output.
+- Added shortcut event methods:
+  - `on_before_attempt()`
+  - `on_success()`
+  - `on_failure()`
+  - `on_retry()`
+  - `on_giveup()`
+- Added `with_structured_logging()` for compact JSON logs.
+- Added dependency-free HTTP helpers:
+  - `should_retry_http_status()`
+  - `retry_if_status()`
+  - `retry_after_delay()`
+  - `parse_retry_after()`
+  - `http_retry_policy()`
+- Added safer handling for large or invalid `Retry-After` headers.
+- Added documentation-focused examples for production-style workflows.
+
+### Improved
+
+- Improved policy diagnostics for risky retry loops.
+- Improved simulation and preview readability.
+- Improved structured logging safety by excluding error messages by default.
+- Improved the public API exports for HTTP and diagnostics helpers.
+- Improved tests around diagnostics, HTTP helpers, simulation, logging, and policy guidance.
+
+### Notes
+
+This release strengthens the core project direction:
+
+> Simple by default, powerful by composition, safe by guidance.
+
+## 0.4.0
+
+### Added
+
+- Added the initial public retry policy builder.
+- Added retry decorator support.
+- Added sync and async execution.
+- Added retry by exception and result.
+- Added core delay strategies.
+- Added presets.
+- Added result objects and statistics.
+- Added initial diagnostics and simulation support.

relinker-0.6.0/CONTRIBUTING.md

@@ -0,0 +1,47 @@
+# Contributing
+
+Thank you for considering contributing to Relinker.
+
+## Local setup
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
+## Run checks
+
+Run the same checks used by GitHub Actions:
+
+```bash
+./scripts/ci.sh
+```
+
+Or run them separately:
+
+```bash
+python -m ruff format --check .
+python -m ruff check .
+python -m mypy src
+python -m pytest
+python -m build
+```
+
+## Auto-format code
+
+```bash
+python -m ruff check . --fix
+python -m ruff format .
+```
+
+## Code principles
+
+- Keep modules small.
+- Prefer clear names over clever names.
+- Avoid hidden behavior.
+- Validate impossible configurations only.
+- Keep user control at the center of the API.
+- Prefer explicit behavior over magic.
+- Add tests for bug fixes and new behavior.

relinker-0.6.0/LICENSE

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