senderkit 0.1.0__tar.gz

senderkit-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,48 @@
+name: Bug report
+description: Report a problem with the SenderKit Python SDK
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to file a bug. Please do **not** include API
+        keys, signing secrets, or other credentials in this report.
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: A clear description of the bug and what you expected instead.
+      placeholder: When I call `client.send(...)`, I get ...
+    validations:
+      required: true
+  - type: textarea
+    id: repro
+    attributes:
+      label: Minimal reproduction
+      description: The smallest code snippet that reproduces the issue.
+      render: python
+    validations:
+      required: true
+  - type: input
+    id: sdk-version
+    attributes:
+      label: SDK version
+      description: "Output of `python -c 'import senderkit; print(senderkit.__version__)'`"
+      placeholder: 0.1.0
+    validations:
+      required: true
+  - type: input
+    id: python-version
+    attributes:
+      label: Python version
+      placeholder: "3.12"
+    validations:
+      required: true
+  - type: textarea
+    id: traceback
+    attributes:
+      label: Traceback / logs
+      description: Full traceback, with any secrets redacted.
+      render: shell
+    validations:
+      required: false

senderkit-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Documentation
+    url: https://docs.senderkit.com
+    about: Guides and API reference for SenderKit.
+  - name: Security vulnerability
+    url: https://github.com/senderkit/senderkit-sdk-python/security/advisories/new
+    about: Report security issues privately — please do not open a public issue.
+  - name: Questions & support
+    url: https://senderkit.com
+    about: For account or product questions, contact SenderKit support.

senderkit-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,25 @@
+name: Feature request
+description: Suggest an improvement or new capability for the SDK
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem / use case
+      description: What are you trying to do that the SDK makes hard today?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: What would the ideal API or behavior look like?
+      render: python
+    validations:
+      required: false
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+    validations:
+      required: false

senderkit-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,21 @@
+<!--
+Thanks for contributing! Please read CONTRIBUTING.md first.
+Keep PRs focused — one logical change per PR.
+-->
+
+## Summary
+
+<!-- What does this PR do and why? -->
+
+## Related issues
+
+<!-- e.g. Closes #123 -->
+
+## Checklist
+
+- [ ] `ruff check .` passes
+- [ ] `ruff format .` applied
+- [ ] `mypy src` passes
+- [ ] `pytest` passes (new behavior is covered by tests)
+- [ ] PR title / commits follow [Conventional Commits](https://www.conventionalcommits.org/) (drives versioning & changelog)
+- [ ] Docs / docstrings updated if the public API changed

senderkit-0.1.0/.github/dependabot.yml

@@ -0,0 +1,20 @@
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: "/"
+    schedule:
+      interval: weekly
+    groups:
+      python-dependencies:
+        patterns: ["*"]
+    open-pull-requests-limit: 5
+    labels: ["dependencies"]
+
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: weekly
+    groups:
+      github-actions:
+        patterns: ["*"]
+    labels: ["dependencies", "ci"]

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

@@ -0,0 +1,71 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+# Cancel superseded runs on the same ref to save CI minutes.
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint & type-check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+          cache: pip
+          cache-dependency-path: pyproject.toml
+      - name: Install
+        run: python -m pip install -e ".[dev]"
+      - name: ruff check
+        run: ruff check --output-format=github .
+      - name: ruff format
+        run: ruff format --check .
+      - name: mypy
+        run: mypy src
+
+  test:
+    name: Test (py${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+          cache-dependency-path: pyproject.toml
+      - name: Install
+        run: python -m pip install -e ".[dev]"
+      - name: pytest
+        run: pytest --cov=senderkit --cov-report=term-missing --cov-report=xml
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v7
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          flags: py${{ matrix.python-version }}
+          fail_ci_if_error: false
+
+  # Single required status check that gates merges, so branch protection only
+  # needs to reference one job regardless of how the matrix grows.
+  ci-ok:
+    name: CI
+    if: always()
+    needs: [lint, test]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Verify all jobs succeeded
+        if: contains(needs.*.result, 'failure') || contains(needs.*.result, 'cancelled')
+        run: exit 1

senderkit-0.1.0/.github/workflows/codeql.yml

@@ -0,0 +1,30 @@
+name: CodeQL
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  schedule:
+    - cron: "27 4 * * 1" # weekly, Mondays
+
+permissions:
+  contents: read
+
+jobs:
+  analyze:
+    name: Analyze (Python)
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read # read workflow run metadata
+      contents: read # required for actions/checkout
+      security-events: write # upload CodeQL results
+    steps:
+      - uses: actions/checkout@v6
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v4
+        with:
+          languages: python
+          queries: security-and-quality
+      - name: Perform CodeQL analysis
+        uses: github/codeql-action/analyze@v4

senderkit-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,99 @@
+name: Release
+
+# Automated releases via release-please + PyPI Trusted Publishing.
+#
+# Flow:
+#   1. Pushes to main run release-please, which maintains a "release PR" that
+#      bumps the version (src/senderkit/_version.py) and CHANGELOG.md from the
+#      Conventional Commit history.
+#   2. Merging that release PR tags the version + creates the GitHub Release and,
+#      in the same run, builds and publishes to PyPI.
+#
+# Everything stays in ONE workflow run so it does not depend on the GitHub
+# Release event (events raised by GITHUB_TOKEN do not trigger other workflows).
+#
+# One-time repo setup:
+#   - Settings → Actions → General → Workflow permissions:
+#       enable "Allow GitHub Actions to create and approve pull requests".
+#   - A PyPI Trusted Publisher for this repo → workflow "release.yml" →
+#     environment "pypi". https://docs.pypi.org/trusted-publishers/
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  release-please:
+    name: Release please
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write # create tags + GitHub releases
+      pull-requests: write # open/update the release PR
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+      tag_name: ${{ steps.release.outputs.tag_name }}
+    steps:
+      - uses: googleapis/release-please-action@v4
+        id: release
+        with:
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json
+
+  build:
+    name: Build distributions
+    needs: release-please
+    if: needs.release-please.outputs.release_created == 'true'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+      - name: Install build tooling
+        run: python -m pip install build twine
+      - name: Build sdist and wheel
+        run: python -m build
+      - name: Check metadata
+        run: twine check dist/*
+      - name: Verify built version matches the release tag
+        env:
+          TAG: ${{ needs.release-please.outputs.tag_name }}
+        run: |
+          # Install the freshly built wheel so we verify the artifact that is
+          # about to be published, not an editable/source checkout.
+          python -m pip install dist/*.whl
+          VERSION="$(python -c 'import senderkit; print(senderkit.__version__)')"
+          echo "Package version: $VERSION"
+          echo "Release tag:     $TAG"
+          if [ "${TAG#v}" != "$VERSION" ]; then
+            echo "::error::Release tag ($TAG) does not match package version ($VERSION)."
+            exit 1
+          fi
+      - uses: actions/upload-artifact@v7
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: [release-please, build]
+    if: needs.release-please.outputs.release_created == 'true'
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/senderkit
+    permissions:
+      contents: read
+      id-token: write # required for Trusted Publishing
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: dist
+          path: dist/
+      - name: Publish
+        uses: pypa/gh-action-pypi-publish@release/v1

senderkit-0.1.0/.gitignore

@@ -0,0 +1,21 @@
+.venv/
+venv/
+src/*.egg-info/
+**/__pycache__/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.python-version
+.DS_Store
+dist/
+build/
+.env
+.env.local
+.coverage
+htmlcov/
+
+# Local editor / tooling (not part of the SDK)
+.vscode/
+.claude/
+.idea
+.gitattributes

senderkit-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,18 @@
+# Run `pre-commit install` to enable. Mirrors the CI lint/format gates.
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-merge-conflict
+      - id: check-added-large-files
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.17
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format

senderkit-0.1.0/.release-please-manifest.json

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

senderkit-0.1.0/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+## 0.1.0 (2026-06-13)
+
+Initial release of the hand-written SenderKit Python SDK (replacing the earlier
+Speakeasy-generated client).
+
+- Sync (`SenderKit`) and async (`AsyncSenderKit`) clients over `httpx`.
+- `send`, `send_raw` (email/SMS/push/web-push), and concurrent `send_batch`.
+- `messages` (list/iter/get/cancel) and `templates` (list/get/render) resources.
+- Idempotency keys by default; automatic retries with backoff honoring `Retry-After`.
+- Typed error hierarchy (`SenderKitError` → `APIError` subclasses, `TimeoutError`,
+  `NetworkError`, `SignatureVerificationError`).
+- `WebhookVerifier` for HMAC-SHA256 signature verification.
+- Framework integrations: Django (email backend, client, webhook view), FastAPI
+  (dependencies), Flask (extension), Celery (send task).
+
+### Not yet included
+
+- SSE streaming client for `messages.list(tail=1)` (the raw parameter is available).
+- An `mcp` submodule (present in the TypeScript SDK).

senderkit-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,15 @@
+# Code of Conduct
+
+This project adopts the [Contributor Covenant](https://www.contributor-covenant.org),
+version 2.1, as its code of conduct. The full text is available at:
+
+https://www.contributor-covenant.org/version/2/1/code_of_conduct/
+
+By participating in this project — contributing code, opening issues, or taking
+part in discussions — you agree to uphold this code of conduct.
+
+## Reporting
+
+To report unacceptable behavior, use GitHub's private reporting on this
+repository's **Security** tab, or contact the maintainers privately. All reports
+will be reviewed and handled confidentially.

senderkit-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,75 @@
+# Contributing to the SenderKit Python SDK
+
+Thanks for your interest in improving the SDK! This document covers how to set
+up a development environment and the checks your change needs to pass.
+
+## Development setup
+
+Requires Python 3.10+.
+
+```bash
+git clone https://github.com/senderkit/senderkit-sdk-python.git
+cd senderkit-sdk-python
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+pre-commit install   # optional: runs lint/format on every commit
+```
+
+## Running the checks
+
+All of these run in CI; run them locally before opening a PR. The `Makefile`
+wraps them:
+
+```bash
+make lint       # ruff check
+make format     # ruff format (apply)
+make typecheck  # mypy src
+make test       # pytest with coverage
+make check      # everything CI runs (format --check, lint, typecheck, test)
+```
+
+Or invoke the tools directly:
+
+```bash
+ruff check .
+ruff format .
+mypy src
+pytest --cov=senderkit
+```
+
+## Guidelines
+
+- **Tests.** New behavior needs tests. We use `pytest` with
+  [`respx`](https://lundberg.github.io/respx/) to mock HTTP — no live network
+  calls in the suite.
+- **Typing.** The package ships `py.typed`; keep the public API fully typed and
+  `mypy`-clean.
+- **Style.** `ruff` handles linting and formatting (100-char lines). Match the
+  surrounding code; the CI format gate is enforced.
+- **Commits & PRs.** Keep PRs focused on one logical change. Use
+  [Conventional Commit](https://www.conventionalcommits.org/) messages — the
+  version bump and changelog are derived from them, so the prefix matters:
+  - `fix:` → patch release, `feat:` → minor release.
+  - `feat!:` or a `BREAKING CHANGE:` footer → breaking change.
+  - `docs:`, `chore:`, `test:`, `refactor:`, `ci:` → no release on their own.
+  - On squash-merge GitHub uses the **PR title**, so keep it conventional too.
+- **Changelog.** Generated automatically from commit messages — don't edit
+  `CHANGELOG.md` by hand.
+
+## Releasing (maintainers)
+
+Releases are automated with
+[release-please](https://github.com/googleapis/release-please):
+
+1. Merge PRs to `main` with Conventional Commit messages.
+2. release-please maintains a **release PR** that bumps `VERSION` in
+   `src/senderkit/_version.py` (the single source of truth) and updates
+   `CHANGELOG.md`. Review and edit it as needed.
+3. Merging the release PR tags `vX.Y.Z`, creates the GitHub Release, and the
+   `Release` workflow builds and publishes to PyPI via Trusted Publishing — all
+   in one run.
+
+## Code of Conduct
+
+By participating in this project you agree to abide by the
+[Code of Conduct](CODE_OF_CONDUCT.md).

senderkit-0.1.0/LICENSE

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

senderkit-0.1.0/Makefile

@@ -0,0 +1,33 @@
+.DEFAULT_GOAL := help
+.PHONY: help install lint format format-check typecheck test check build clean
+
+help: ## Show this help
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | \
+		awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-13s\033[0m %s\n", $$1, $$2}'
+
+install: ## Install the package with dev dependencies
+	pip install -e ".[dev]"
+
+lint: ## Lint with ruff
+	ruff check .
+
+format: ## Format with ruff (apply changes)
+	ruff format .
+
+format-check: ## Check formatting without changing files
+	ruff format --check .
+
+typecheck: ## Type-check with mypy
+	mypy src
+
+test: ## Run the test suite with coverage
+	pytest --cov=senderkit --cov-report=term-missing
+
+check: format-check lint typecheck test ## Run everything CI runs
+
+build: ## Build sdist and wheel
+	python -m build
+
+clean: ## Remove build and cache artifacts
+	rm -rf dist build *.egg-info src/*.egg-info .pytest_cache .mypy_cache .ruff_cache .coverage htmlcov
+	find . -type d -name __pycache__ -exec rm -rf {} +