litestar-queues 0.1.0__tar.gz

litestar_queues-0.1.0/.gitignore

@@ -0,0 +1,202 @@
+# 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
+tmp/
+docs-build/
+# 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
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_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/
+
+# Generated demo GIFs (created by VHS during CI)
+docs/_static/demos/*.gif
+
+# 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/#use-with-ide
+.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/
+
+# vscode
+.vscode
+
+node_modules
+.aider*
+
+.DS_Store
+*.swo
+*.swp
+.venv
+
+
+# AI Agent Systems (Gemini & Claude)
+# All AI infrastructure is local-only and not tracked in git
+specs/
+.gemini/
+.claude/
+.codex/
+AGENTS.md
+CLAUDE.md
+GEMINI.md
+coverage/
+coverage.json
+.agent/
+.beads/
+.agents
+
+# Beads / Dolt files (added by bd init)
+.dolt/
+*.db
+.beads-credential-key
+GEMINI.md
+test-build
+.antigravitycli/
+opencode.json

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

@@ -0,0 +1,48 @@
+default_language_version:
+  python: "3"
+repos:
+  - repo: local
+    hooks:
+      - id: no-future-annotations
+        name: Disallow future annotations import
+        entry: python tools/no_future_annotations.py
+        language: python
+        types_or: [python]
+  - repo: https://github.com/compilerla/conventional-pre-commit
+    rev: v4.4.0
+    hooks:
+      - id: conventional-pre-commit
+        stages: [commit-msg]
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-ast
+      - id: check-case-conflict
+      - id: check-toml
+      - id: debug-statements
+      - id: end-of-file-fixer
+      - id: mixed-line-ending
+      - id: trailing-whitespace
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: "v0.15.20"
+    hooks:
+      - id: ruff-check
+        args: ["--fix"]
+      - id: ruff-format
+  - repo: https://github.com/codespell-project/codespell
+    rev: v2.4.2
+    hooks:
+      - id: codespell
+        additional_dependencies:
+          - tomli
+  - repo: https://github.com/python-formate/flake8-dunder-all
+    rev: v0.5.0
+    hooks:
+      - id: ensure-dunder-all
+        exclude: "test*|tools"
+        args: ["--use-tuple"]
+  - repo: https://github.com/ariebovenberg/slotscheck
+    rev: v0.20.0
+    hooks:
+      - id: slotscheck
+        exclude: "docs|.github"

litestar_queues-0.1.0/.python-version

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

litestar_queues-0.1.0/LICENSE

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

litestar_queues-0.1.0/Makefile

@@ -0,0 +1,215 @@
+SHELL := /bin/bash
+.SHELLFLAGS := -euo pipefail -c
+
+# =============================================================================
+# Configuration and Environment Variables
+# =============================================================================
+
+.DEFAULT_GOAL:=help
+.ONESHELL:
+.EXPORT_ALL_VARIABLES:
+MAKEFLAGS += --no-print-directory
+UV_SYNC_ARGS ?= --all-extras --dev
+
+# -----------------------------------------------------------------------------
+# Display Formatting and Colors
+# -----------------------------------------------------------------------------
+BLUE := $(shell printf "\033[1;34m")
+GREEN := $(shell printf "\033[1;32m")
+RED := $(shell printf "\033[1;31m")
+YELLOW := $(shell printf "\033[1;33m")
+NC := $(shell printf "\033[0m")
+INFO := $(shell printf "$(BLUE)i$(NC)")
+OK := $(shell printf "$(GREEN)ok$(NC)")
+WARN := $(shell printf "$(YELLOW)!$(NC)")
+ERROR := $(shell printf "$(RED)x$(NC)")
+
+# =============================================================================
+# Help and Documentation
+# =============================================================================
+
+.PHONY: help
+help:                                               ## Display this help text for Makefile
+	@awk 'BEGIN {FS = ":.*##"; printf "\nUsage:\n  make \033[36m<target>\033[0m\n"} /^[a-zA-Z0-9_-]+:.*?##/ { printf "  \033[36m%-15s\033[0m %s\n", $$1, $$2 } /^##@/ { printf "\n\033[1m%s\033[0m\n", substr($$0, 5) } ' $(MAKEFILE_LIST)
+
+# =============================================================================
+# Installation and Environment Setup
+# =============================================================================
+
+.PHONY: install-uv
+install-uv:                                         ## Install latest version of uv
+	@echo "${INFO} Installing uv..."
+	@curl -LsSf https://astral.sh/uv/install.sh | sh >/dev/null 2>&1
+	@echo "${OK} UV installed successfully"
+
+.PHONY: install
+install: clean                                      ## Install the project and dependencies for local development
+	@echo "${INFO} Starting fresh installation..."
+	@uv sync $(UV_SYNC_ARGS)
+	@echo "${OK} Installation complete"
+
+.PHONY: install-test-adapters
+install-test-adapters:                              ## Install test dependencies for the full integration matrix
+	@echo "${INFO} Installing test dependencies..."
+	@uv sync --group tests $(UV_SYNC_ARGS)
+	@echo "${OK} Test dependencies installed"
+
+.PHONY: destroy
+destroy:                                            ## Destroy the virtual environment
+	@echo "${INFO} Destroying virtual environment..."
+	@rm -rf .venv
+	@echo "${OK} Virtual environment destroyed"
+
+# =============================================================================
+# Dependency Management
+# =============================================================================
+
+.PHONY: upgrade
+upgrade:                                            ## Upgrade all dependencies to latest stable versions
+	@echo "${INFO} Updating all dependencies..."
+	@uv lock --upgrade
+	@echo "${OK} Dependencies updated"
+	@uvx prek autoupdate
+	@echo "${OK} Updated prek hooks"
+
+.PHONY: lock
+lock:                                               ## Rebuild lockfiles from scratch
+	@echo "${INFO} Rebuilding lockfiles..."
+	@uv lock --upgrade
+	@echo "${OK} Lockfiles updated"
+
+# =============================================================================
+# Build and Release
+# =============================================================================
+
+.PHONY: build
+build:                                              ## Build the project
+	@echo "${INFO} Building package..."
+	@uv build
+	@echo "${OK} Package build complete"
+
+# =============================================================================
+# Documentation
+# =============================================================================
+
+.PHONY: docs
+docs:                                               ## Build documentation
+	@echo "${INFO} Building docs..."
+	@uv run sphinx-build -b html docs docs/_build/html
+	@echo "${OK} Docs build complete"
+
+.PHONY: docs-linkcheck
+docs-linkcheck:                                     ## Check documentation links
+	@echo "${INFO} Checking docs links..."
+	@uv run sphinx-build -b linkcheck docs docs/_build/linkcheck
+	@echo "${OK} Docs linkcheck complete"
+
+.PHONY: docs-clean
+docs-clean:                                         ## Clean documentation artifacts
+	@echo "${INFO} Cleaning docs artifacts..."
+	@rm -rf docs/_build docs-build >/dev/null 2>&1
+	@echo "${OK} Docs artifacts cleaned"
+
+# =============================================================================
+# Cleaning and Maintenance
+# =============================================================================
+
+.PHONY: clean
+clean:                                              ## Cleanup temporary build artifacts
+	@echo "${INFO} Cleaning working directory..."
+	@rm -rf .pytest_cache .ruff_cache .hypothesis build/ dist/ .eggs/ .coverage coverage.xml coverage.json htmlcov/ src/tests/.pytest_cache src/tests/**/.pytest_cache .mypy_cache >/dev/null 2>&1
+	@find . -name '*.egg-info' -exec rm -rf {} + >/dev/null 2>&1
+	@find . -type f -name '*.egg' -exec rm -f {} + >/dev/null 2>&1
+	@find . -name '*.pyc' -exec rm -f {} + >/dev/null 2>&1
+	@find . -name '*.pyo' -exec rm -f {} + >/dev/null 2>&1
+	@find . -name '*~' -exec rm -f {} + >/dev/null 2>&1
+	@find . -name '__pycache__' -exec rm -rf {} + >/dev/null 2>&1
+	@find . -name '.ipynb_checkpoints' -exec rm -rf {} + >/dev/null 2>&1
+	@echo "${OK} Working directory cleaned"
+
+# =============================================================================
+# Testing and Quality Checks
+# =============================================================================
+
+.PHONY: test
+test:                                               ## Run the tests
+	@echo "${INFO} Running test cases..."
+	@uv run pytest src/tests
+	@echo "${OK} Tests complete"
+
+.PHONY: test-all
+test-all: test                                      ## Run all tests
+
+.PHONY: test-unit
+test-unit:                                          ## Run unit tests only (no Docker required)
+	@echo "${INFO} Running unit tests..."
+	@uv run pytest src/tests/unit -n auto
+	@echo "${OK} Unit tests complete"
+
+.PHONY: test-integration
+test-integration:                                   ## Run integration tests only (autoskips without Docker)
+	@echo "${INFO} Running integration tests..."
+	@uv run pytest src/tests/integration -n auto
+	@echo "${OK} Integration tests complete"
+
+.PHONY: coverage
+coverage:                                           ## Run tests with coverage report
+	@echo "${INFO} Running tests with coverage..."
+	@uv run pytest src/tests --cov -n auto
+	@uv run coverage html >/dev/null 2>&1
+	@uv run coverage xml >/dev/null 2>&1
+	@echo "${OK} Coverage report generated"
+
+# -----------------------------------------------------------------------------
+# Type Checking
+# -----------------------------------------------------------------------------
+
+.PHONY: mypy
+mypy:                                               ## Run mypy
+	@echo "${INFO} Running mypy..."
+	@uv run dmypy run
+	@echo "${OK} Mypy checks passed"
+
+.PHONY: mypy-nocache
+mypy-nocache:                                       ## Run Mypy without cache
+	@echo "${INFO} Running mypy without cache..."
+	@uv run mypy
+	@echo "${OK} Mypy checks passed"
+
+.PHONY: pyright
+pyright:                                            ## Run pyright
+	@echo "${INFO} Running pyright..."
+	@uv run pyright
+	@echo "${OK} Pyright checks passed"
+
+.PHONY: type-check
+type-check: mypy pyright                            ## Run all type checking
+
+# -----------------------------------------------------------------------------
+# Linting and Formatting
+# -----------------------------------------------------------------------------
+
+.PHONY: prek
+prek:                                               ## Run prek hooks
+	@echo "${INFO} Running prek checks..."
+	@uvx prek run --show-diff-on-failure --color=always --all-files
+	@echo "${OK} prek checks passed"
+
+.PHONY: slotscheck
+slotscheck:                                         ## Run slotscheck
+	@echo "${INFO} Running slots check..."
+	@uv run slotscheck src/litestar_queues/
+	@echo "${OK} Slots check passed"
+
+.PHONY: fix
+fix:                                                ## Fix linting issues
+	@echo "${INFO} Fixing linting issues..."
+	@uv run ruff check --fix --unsafe-fixes src/
+	@uv run ruff format src/
+	@echo "${OK} Linting issues fixed"
+
+.PHONY: lint
+lint: prek type-check slotscheck                    ## Run all linting checks
+
+.PHONY: check-all
+check-all: lint test-all coverage                   ## Run all checks (lint, test, coverage)