tempest-fastapi-sdk 0.1.0__tar.gz

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

@@ -0,0 +1,89 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  python:
+    name: Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.13"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install project with all extras + dev dependencies
+        run: uv sync --all-extras
+
+      - name: Lint
+        run: uv run ruff check .
+
+      - name: Format check
+        run: uv run ruff format --check .
+
+      - name: Type check
+        run: uv run mypy tempest_fastapi_sdk
+
+      - name: Run tests
+        run: uv run pytest
+
+      - name: Build sdist and wheel
+        run: uv build
+
+      - name: Verify distributions
+        run: |
+          uv tool install twine
+          uv tool run twine check dist/*
+
+      - name: Verify wheel contains package source
+        run: |
+          python -c "import zipfile, glob; \
+            wheel = glob.glob('dist/*.whl')[0]; \
+            members = zipfile.ZipFile(wheel).namelist(); \
+            py_files = [n for n in members if n.startswith('tempest_fastapi_sdk/') and n.endswith('.py')]; \
+            template = [n for n in members if n.endswith('env.py.template')]; \
+            print('Python files in wheel:', len(py_files)); \
+            print('Alembic templates in wheel:', len(template)); \
+            assert len(py_files) >= 20, f'wheel suspiciously empty ({len(py_files)} files)'; \
+            assert len(template) == 1, f'env.py.template missing from wheel'; \
+            print('OK')"
+
+      - name: Smoke-install built wheel in a clean venv
+        run: |
+          uv venv --python ${{ matrix.python-version }} /tmp/smoke-core
+          uv pip install --python /tmp/smoke-core/bin/python --quiet dist/*.whl
+          /tmp/smoke-core/bin/python -c "import tempest_fastapi_sdk as m; \
+            assert m.__version__, 'no __version__'; \
+            assert m.BaseModel and m.BaseRepository and m.AsyncDatabaseManager, 'core primitives missing'; \
+            assert m.AlembicHelper and m.NAMING_CONVENTION, 'alembic helpers missing'; \
+            assert m.AppException and m.NotFoundException and m.ConflictException, 'exceptions missing'; \
+            assert m.BaseSchema and m.BaseResponseSchema and m.BasePaginationSchema, 'schemas missing'; \
+            assert m.BaseAppSettings, 'settings missing'; \
+            assert m.register_exception_handlers, 'api helpers missing'; \
+            assert m.is_valid_cpf and m.is_valid_cnpj and m.is_valid_phone_br, 'BR regex helpers missing'; \
+            print('Core smoke OK · version =', m.__version__)"
+
+      - name: Smoke-install with [all] extras and verify utilities
+        run: |
+          uv venv --python ${{ matrix.python-version }} /tmp/smoke-all
+          uv pip install --python /tmp/smoke-all/bin/python --quiet "$(ls dist/*.whl)[all]"
+          /tmp/smoke-all/bin/python -c "from tempest_fastapi_sdk import (\
+            PasswordUtils, JWTUtils, EmailUtils, UploadUtils); \
+            assert PasswordUtils and JWTUtils and EmailUtils and UploadUtils, 'utils missing'; \
+            print('Extras smoke OK')"

tempest_fastapi_sdk-0.1.0/.github/workflows/release-pypi.yml

@@ -0,0 +1,108 @@
+name: Release to PyPI
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build distributions
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Verify tag matches project version
+        run: |
+          TAG_VERSION="${GITHUB_REF_NAME#v}"
+          PYPROJECT_VERSION=$(python -c "import tomllib; print(tomllib.loads(open('pyproject.toml','rb').read().decode())['project']['version'])")
+          PACKAGE_VERSION=$(python -c "import re; print(re.search(r'__version__:\s*str\s*=\s*\"([^\"]+)\"', open('tempest_fastapi_sdk/__init__.py').read()).group(1))")
+          echo "Tag:        $TAG_VERSION"
+          echo "pyproject:  $PYPROJECT_VERSION"
+          echo "__version__: $PACKAGE_VERSION"
+          if [ "$TAG_VERSION" != "$PYPROJECT_VERSION" ] || [ "$TAG_VERSION" != "$PACKAGE_VERSION" ]; then
+            echo "Version mismatch — bump pyproject.toml AND tempest_fastapi_sdk/__init__.py to match the tag before retagging."
+            exit 1
+          fi
+
+      - name: Install project with all extras
+        run: uv sync --all-extras
+
+      - name: Run full test suite
+        run: uv run pytest
+
+      - name: Lint + format + type check
+        run: |
+          uv run ruff check .
+          uv run ruff format --check .
+          uv run mypy tempest_fastapi_sdk
+
+      - name: Build sdist and wheel
+        run: uv build
+
+      - name: Verify metadata
+        run: |
+          uv tool install twine
+          uv tool run twine check dist/*
+
+      - name: Verify wheel contains package source
+        run: |
+          python -c "import zipfile, glob; \
+            wheel = glob.glob('dist/*.whl')[0]; \
+            members = zipfile.ZipFile(wheel).namelist(); \
+            py_files = [n for n in members if n.startswith('tempest_fastapi_sdk/') and n.endswith('.py')]; \
+            template = [n for n in members if n.endswith('env.py.template')]; \
+            print('Python files in wheel:', len(py_files)); \
+            print('Alembic templates in wheel:', len(template)); \
+            assert len(py_files) >= 20, f'wheel suspiciously empty ({len(py_files)} files)'; \
+            assert len(template) == 1, 'env.py.template missing from wheel'; \
+            print('OK')"
+
+      - name: Smoke-install built wheel in a clean venv
+        run: |
+          uv venv --python 3.13 /tmp/smoke-venv
+          uv pip install --python /tmp/smoke-venv/bin/python --quiet "$(ls dist/*.whl)[all]"
+          /tmp/smoke-venv/bin/python -c "import tempest_fastapi_sdk as m; \
+            assert m.__version__, 'no __version__'; \
+            assert m.BaseModel and m.BaseRepository and m.AsyncDatabaseManager, 'core primitives missing'; \
+            assert m.AlembicHelper and m.NAMING_CONVENTION, 'alembic helpers missing'; \
+            assert m.PasswordUtils and m.JWTUtils and m.EmailUtils and m.UploadUtils, 'utils missing'; \
+            assert m.is_valid_cpf and m.is_valid_cnpj and m.is_valid_phone_br, 'BR regex helpers missing'; \
+            print('Smoke OK · version =', m.__version__)"
+
+      - name: Upload distributions artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/tempest-fastapi-sdk
+    permissions:
+      id-token: write
+    steps:
+      - name: Download distributions artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: python-dist
+          path: dist
+
+      - name: Publish to PyPI (Trusted Publishing)
+        uses: pypa/gh-action-pypi-publish@release/v1

tempest_fastapi_sdk-0.1.0/.gitignore

@@ -0,0 +1,22 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Test + tooling caches
+.coverage
+.coverage.*
+htmlcov/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# Editor
+.vscode/
+.idea/

tempest_fastapi_sdk-0.1.0/.python-version

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

tempest_fastapi_sdk-0.1.0/Makefile

@@ -0,0 +1,101 @@
+# tempest-fastapi-sdk — developer & release automation.
+#
+# Run `make` (or `make help`) to see every target.
+# Override defaults: `make release VERSION=0.2.0`.
+
+PACKAGE := tempest_fastapi_sdk
+PYTHON_VERSION := 3.13
+
+.DEFAULT_GOAL := help
+.PHONY: help install sync clean test cov lint fmt fmt-check type check ci build smoke release tag version
+
+help: ## List available targets
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) \
+		| awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-14s\033[0m %s\n", $$1, $$2}'
+
+## ---------- setup ----------
+
+install: ## Sync dependencies with all extras (auth, email, upload)
+	uv sync --all-extras
+
+sync: install ## Alias for `install`
+
+## ---------- code quality ----------
+
+test: ## Run pytest with coverage
+	uv run pytest
+
+cov: ## Open the last coverage HTML report (run `pytest --cov-report=html` first)
+	@command -v xdg-open >/dev/null && xdg-open htmlcov/index.html || open htmlcov/index.html
+
+lint: ## Run ruff lint
+	uv run ruff check .
+
+fmt: ## Auto-format with ruff
+	uv run ruff format .
+
+fmt-check: ## Verify formatting without modifying files
+	uv run ruff format --check .
+
+type: ## Run mypy in strict mode
+	uv run mypy $(PACKAGE)
+
+check: lint fmt-check type test ## Run every gate (lint + format check + mypy + tests)
+
+ci: check build smoke ## Full local mirror of the GitHub Actions pipeline
+
+## ---------- packaging ----------
+
+build: ## Build sdist + wheel into dist/
+	rm -rf dist
+	uv build
+
+smoke: build ## Install the freshly built wheel in a clean venv and import the top-level surface
+	@rm -rf /tmp/$(PACKAGE)-smoke
+	uv venv --python $(PYTHON_VERSION) /tmp/$(PACKAGE)-smoke
+	uv pip install --python /tmp/$(PACKAGE)-smoke/bin/python --quiet "$$(ls dist/*.whl)[all]"
+	/tmp/$(PACKAGE)-smoke/bin/python -c "import $(PACKAGE) as m; \
+		assert m.__version__, 'no __version__'; \
+		assert m.BaseModel and m.BaseRepository and m.AsyncDatabaseManager, 'core primitives missing'; \
+		assert m.AlembicHelper and m.NAMING_CONVENTION, 'alembic helpers missing'; \
+		assert m.PasswordUtils and m.JWTUtils and m.EmailUtils and m.UploadUtils, 'utils missing'; \
+		assert m.is_valid_cpf and m.is_valid_cnpj and m.is_valid_phone_br, 'BR regex helpers missing'; \
+		print('Smoke OK · version =', m.__version__)"
+	@rm -rf /tmp/$(PACKAGE)-smoke
+
+version: ## Print the version recorded in pyproject.toml and __init__.py
+	@printf "pyproject.toml: "
+	@grep -E '^version =' pyproject.toml | head -1
+	@printf "__init__.py:    "
+	@grep -E "^__version__" $(PACKAGE)/__init__.py | head -1
+
+## ---------- release ----------
+
+tag: ## Tag the current commit with the project version (no push)
+	@VER=$$(grep -E '^version =' pyproject.toml | head -1 | sed -E 's/.*"([^"]+)".*/\1/'); \
+		git tag "v$$VER" && echo "Tagged v$$VER (run \`git push origin v$$VER\` when ready)"
+
+release: ## Bump versions, commit, tag and push. Usage: make release VERSION=0.2.0
+	@test -n "$(VERSION)" || (echo "Usage: make release VERSION=0.2.0"; exit 1)
+	@if [ -n "$$(git status --porcelain)" ]; then \
+		echo "Working tree dirty. Commit or stash first."; exit 1; \
+	fi
+	@echo "Bumping pyproject.toml and $(PACKAGE)/__init__.py to $(VERSION)"
+	sed -i -E 's/^version = "[^"]+"/version = "$(VERSION)"/' pyproject.toml
+	sed -i -E 's/^__version__: str = "[^"]+"/__version__: str = "$(VERSION)"/' $(PACKAGE)/__init__.py
+	$(MAKE) check
+	git add pyproject.toml $(PACKAGE)/__init__.py
+	git commit -m "chore: release v$(VERSION)"
+	git tag "v$(VERSION)"
+	@echo
+	@echo "Ready to push. Review with \`git show v$(VERSION)\` then:"
+	@echo "    git push origin main"
+	@echo "    git push origin v$(VERSION)"
+
+## ---------- housekeeping ----------
+
+clean: ## Remove caches, build artifacts and coverage data
+	rm -rf dist build *.egg-info
+	rm -rf .pytest_cache .mypy_cache .ruff_cache htmlcov
+	rm -f .coverage .coverage.*
+	find . -type d -name __pycache__ -prune -exec rm -rf {} +