depende 0.1.0__tar.gz → 0.1.2__tar.gz

depende-0.1.2/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Sebastián Ramírez
+
+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.

depende-0.1.2/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: depende
+Version: 0.1.2
+Summary: Dependency declarations for Python frameworks and tools
+Author: Sebastián Ramírez
+Author-email: Sebastián Ramírez <tiangolo@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Project-URL: Homepage, https://github.com/tiangolo/depende
+Project-URL: Documentation, https://depende.tiangolo.com
+Project-URL: Repository, https://github.com/tiangolo/depende
+Project-URL: Issues, https://github.com/tiangolo/depende/issues
+Project-URL: Changelog, https://depende.tiangolo.com/release-notes/
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <a href="https://depende.tiangolo.com"><img src="https://depende.tiangolo.com/img/logo-margin/logo-margin-vector.svg#only-light" alt="Depende"></a>
+
+</p>
+
+<p align="center">
+  <em>Dependency declarations for Python frameworks and tools.</em>
+</p>
+
+<p align="center">
+<a href="https://github.com/tiangolo/depende/actions?query=workflow%3ATest+event%3Apush+branch%3Amain">
+    <img src="https://github.com/tiangolo/depende/actions/workflows/test.yml/badge.svg?event=push&branch=main" alt="Test">
+</a>
+<a href="https://pypi.org/project/depende">
+    <img src="https://img.shields.io/pypi/v/depende?color=%2334D058&label=pypi%20package" alt="Python package version">
+</a>
+</p>
+
+---
+
+**Documentation**: [https://depende.tiangolo.com](https://depende.tiangolo.com)
+
+**Source Code**: [https://github.com/tiangolo/depende](https://github.com/tiangolo/depende)
+
+---
+
+`depende` provides small dependency declarations in the style of FastAPI for reuse by frameworks and tools.
+
+## Install
+
+```bash
+uv add depende
+```
+
+Or if using pip:
+
+```bash
+pip install depende
+```
+
+## Usage
+
+```python
+from depende import Depends, DependsInfo
+```
+
+`Depends(...)` returns a frozen `DependsInfo` metadata object with:
+
+- `dependency`: a callable dependency, or `None`
+- `use_cache`: whether a framework may reuse the dependency result within its active solving context
+- `scope`: an opaque framework-defined string, or `None`
+
+The package only declares dependency metadata. It does not solve, execute, cache, inject request data, manage lifecycles, generate OpenAPI, or define framework-specific scopes.
+
+## Example
+
+```python
+from depende import Depends
+from typing import Annotated
+
+
+def get_settings() -> dict[str, str]:
+    return {"mode": "prod"}
+
+
+SettingsDep = Annotated[dict[str, str], Depends(get_settings, scope="command")]
+```
+
+Frameworks decide what `scope` means and how dependency solving works.
+
+## License
+
+This project is licensed under the terms of the [MIT license](https://github.com/tiangolo/depende/blob/main/LICENSE).

depende-0.1.2/README.md

@@ -0,0 +1,73 @@
+<p align="center">
+  <a href="https://depende.tiangolo.com"><img src="https://depende.tiangolo.com/img/logo-margin/logo-margin-vector.svg#only-light" alt="Depende"></a>
+
+</p>
+
+<p align="center">
+  <em>Dependency declarations for Python frameworks and tools.</em>
+</p>
+
+<p align="center">
+<a href="https://github.com/tiangolo/depende/actions?query=workflow%3ATest+event%3Apush+branch%3Amain">
+    <img src="https://github.com/tiangolo/depende/actions/workflows/test.yml/badge.svg?event=push&branch=main" alt="Test">
+</a>
+<a href="https://pypi.org/project/depende">
+    <img src="https://img.shields.io/pypi/v/depende?color=%2334D058&label=pypi%20package" alt="Python package version">
+</a>
+</p>
+
+---
+
+**Documentation**: [https://depende.tiangolo.com](https://depende.tiangolo.com)
+
+**Source Code**: [https://github.com/tiangolo/depende](https://github.com/tiangolo/depende)
+
+---
+
+`depende` provides small dependency declarations in the style of FastAPI for reuse by frameworks and tools.
+
+## Install
+
+```bash
+uv add depende
+```
+
+Or if using pip:
+
+```bash
+pip install depende
+```
+
+## Usage
+
+```python
+from depende import Depends, DependsInfo
+```
+
+`Depends(...)` returns a frozen `DependsInfo` metadata object with:
+
+- `dependency`: a callable dependency, or `None`
+- `use_cache`: whether a framework may reuse the dependency result within its active solving context
+- `scope`: an opaque framework-defined string, or `None`
+
+The package only declares dependency metadata. It does not solve, execute, cache, inject request data, manage lifecycles, generate OpenAPI, or define framework-specific scopes.
+
+## Example
+
+```python
+from depende import Depends
+from typing import Annotated
+
+
+def get_settings() -> dict[str, str]:
+    return {"mode": "prod"}
+
+
+SettingsDep = Annotated[dict[str, str], Depends(get_settings, scope="command")]
+```
+
+Frameworks decide what `scope` means and how dependency solving works.
+
+## License
+
+This project is licensed under the terms of the [MIT license](https://github.com/tiangolo/depende/blob/main/LICENSE).

depende-0.1.2/pyproject.toml

@@ -0,0 +1,133 @@
+[build-system]
+requires = ["uv_build>=0.9.11,<0.10.0"]
+build-backend = "uv_build"
+
+[project]
+name = "depende"
+version = "0.1.2"
+description = "Dependency declarations for Python frameworks and tools"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[[project.authors]]
+name = "Sebastián Ramírez"
+email = "tiangolo@gmail.com"
+
+[project.urls]
+Homepage = "https://github.com/tiangolo/depende"
+Documentation = "https://depende.tiangolo.com"
+Repository = "https://github.com/tiangolo/depende"
+Issues = "https://github.com/tiangolo/depende/issues"
+Changelog = "https://depende.tiangolo.com/release-notes/"
+
+[dependency-groups]
+dev = [
+    { include-group = "docs" },
+    { include-group = "tests" },
+    "prek>=0.2.24,<1.0.0",
+    "zizmor >=1.23.1",
+]
+docs = [
+    "griffe-typingdoc >=0.3.0",
+    "griffe-warnings-deprecated >=1.1.0",
+    "markdown-include-variants >=0.0.8",
+    "mdx-include >=1.4.1",
+    "mkdocstrings[python] >=1.0.3",
+    "pyyaml >=5.3.1",
+    "typer >=0.24.1",
+    "zensical>=0.0.42",
+]
+github-actions = [
+    "httpx >=0.28.1",
+    "pydantic >=2.5.3",
+    "pydantic-settings >=2.1.0",
+    "pygithub >=2.3.0",
+    "smokeshow >=0.5.0",
+]
+tests = [
+    "coverage[toml] >=6.2",
+    "pytest >=8.4.0",
+    "ruff >=0.16.0",
+    "ty>=0.0.25",
+]
+
+[tool.coverage.run]
+parallel = true
+data_file = "coverage/.coverage"
+source = [
+    "depende",
+    "tests",
+]
+context = "${CONTEXT}"
+dynamic_context = "test_function"
+relative_files = true
+
+[tool.coverage.report]
+show_missing = true
+sort = "-Cover"
+exclude_lines = [
+    "pragma: no cover",
+    "@overload",
+    'if __name__ == "__main__":',
+    "if TYPE_CHECKING:",
+]
+
+[tool.coverage.html]
+show_contexts = true
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "W",
+    "F",
+    "I",
+    "B",
+    "C4",
+    "UP",
+]
+ignore = [
+    "E501",
+    "B008",
+    "C901",
+]
+
+[tool.ty.terminal]
+error-on-warning = true
+
+[tool.typos.files]
+extend-exclude = [
+    "coverage/",
+    "dist/",
+    "docs/img/",
+    "htmlcov/",
+    "site/",
+    "site_build/",
+    "uv.lock",
+]
+
+[tool.typos.default.extend-identifiers]
+alls = "alls"
+
+[tool.typos.default.extend-words]
+Ines = "Ines"
+
+[tool.uv.build-backend]
+source-include = [
+    "scripts/test.sh",
+    "tests/**",
+]

depende-0.1.2/pyproject.toml.orig

@@ -0,0 +1,132 @@
+[build-system]
+requires = ["uv_build>=0.9.11,<0.10.0"]
+build-backend = "uv_build"
+
+[project]
+name = "depende"
+version = "0.1.2"
+description = "Dependency declarations for Python frameworks and tools"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [
+    { name = "Sebastián Ramírez", email = "tiangolo@gmail.com" },
+]
+license = "MIT"
+license-files = ["LICENSE"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/tiangolo/depende"
+Documentation = "https://depende.tiangolo.com"
+Repository = "https://github.com/tiangolo/depende"
+Issues = "https://github.com/tiangolo/depende/issues"
+Changelog = "https://depende.tiangolo.com/release-notes/"
+
+[dependency-groups]
+dev = [
+    { include-group = "docs" },
+    { include-group = "tests" },
+    "prek>=0.2.24,<1.0.0",
+    "zizmor >=1.23.1",
+]
+docs = [
+    "griffe-typingdoc >=0.3.0",
+    "griffe-warnings-deprecated >=1.1.0",
+    "markdown-include-variants >=0.0.8",
+    "mdx-include >=1.4.1",
+    "mkdocstrings[python] >=1.0.3",
+    "pyyaml >=5.3.1",
+    "typer >=0.24.1",
+    "zensical>=0.0.42",
+]
+github-actions = [
+    "httpx >=0.28.1",
+    "pydantic >=2.5.3",
+    "pydantic-settings >=2.1.0",
+    "pygithub >=2.3.0",
+    "smokeshow >=0.5.0",
+]
+tests = [
+    "coverage[toml] >=6.2",
+    "pytest >=8.4.0",
+    "ruff >=0.16.0",
+    "ty>=0.0.25",
+]
+
+[tool.coverage.run]
+parallel = true
+data_file = "coverage/.coverage"
+source = [
+    "depende",
+    "tests",
+]
+context = '${CONTEXT}'
+dynamic_context = "test_function"
+relative_files = true
+
+[tool.coverage.report]
+show_missing = true
+sort = "-Cover"
+exclude_lines = [
+    "pragma: no cover",
+    "@overload",
+    'if __name__ == "__main__":',
+    "if TYPE_CHECKING:",
+]
+
+[tool.coverage.html]
+show_contexts = true
+
+[tool.ruff.lint]
+select = [
+    "E",  # pycodestyle errors
+    "W",  # pycodestyle warnings
+    "F",  # pyflakes
+    "I",  # isort
+    "B",  # flake8-bugbear
+    "C4", # flake8-comprehensions
+    "UP", # pyupgrade
+]
+ignore = [
+    "E501", # line too long
+    "B008", # do not perform function calls in argument defaults
+    "C901", # too complex
+]
+
+[tool.ty.terminal]
+error-on-warning = true
+
+[tool.typos.files]
+extend-exclude = [
+    "coverage/",
+    "dist/",
+    "docs/img/",
+    "htmlcov/",
+    "site/",
+    "site_build/",
+    "uv.lock",
+]
+
+[tool.typos.default.extend-identifiers]
+alls = "alls"
+
+[tool.typos.default.extend-words]
+Ines = "Ines"
+
+[tool.uv.build-backend]
+source-include = [
+    "scripts/test.sh",
+    "tests/**",
+]

depende-0.1.2/scripts/test.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+
+set -e
+set -x
+
+coverage run -m pytest tests
+coverage combine
+coverage report
+coverage html

depende-0.1.2/src/depende/__init__.py

@@ -0,0 +1,2 @@
+from .main import Depends as Depends
+from .main import DependsInfo as DependsInfo

depende-0.1.2/src/depende/main.py

@@ -0,0 +1,19 @@
+from collections.abc import Callable
+from dataclasses import dataclass
+from typing import Any
+
+
+@dataclass(frozen=True, slots=True)
+class DependsInfo:
+    dependency: Callable[..., Any] | None = None
+    use_cache: bool = True
+    scope: str | None = None
+
+
+def Depends(
+    dependency: Callable[..., Any] | None = None,
+    *,
+    use_cache: bool = True,
+    scope: str | None = None,
+) -> DependsInfo:
+    return DependsInfo(dependency=dependency, use_cache=use_cache, scope=scope)

depende-0.1.2/tests/test_depends.py

@@ -0,0 +1,32 @@
+from dataclasses import FrozenInstanceError
+
+import pytest
+
+from depende import Depends, DependsInfo
+
+
+def dependency() -> str:
+    return "value"
+
+
+def test_depends_returns_depends_info() -> None:
+    info = Depends(dependency)
+
+    assert info == DependsInfo(dependency=dependency, use_cache=True, scope=None)
+    assert info.dependency is not None
+    assert info.dependency() == "value"
+
+
+def test_depends_accepts_declaration_options() -> None:
+    info = Depends(dependency, use_cache=False, scope="command")
+
+    assert info.dependency is dependency
+    assert info.use_cache is False
+    assert info.scope == "command"
+
+
+def test_depends_info_is_frozen() -> None:
+    info = Depends()
+
+    with pytest.raises(FrozenInstanceError):
+        info.use_cache = False  # type: ignore[misc]  # ty: ignore[invalid-assignment]

depende-0.1.0/PKG-INFO

@@ -1,9 +0,0 @@
-Metadata-Version: 2.3
-Name: depende
-Version: 0.1.0
-Summary: Add your description here
-Author: Sebastián Ramírez
-Author-email: Sebastián Ramírez <tiangolo@gmail.com>
-Requires-Python: >=3.14
-Description-Content-Type: text/markdown
-

depende-0.1.0/pyproject.toml

@@ -1,17 +0,0 @@
-[project]
-name = "depende"
-version = "0.1.0"
-description = "Add your description here"
-readme = "README.md"
-authors = [
-    { name = "Sebastián Ramírez", email = "tiangolo@gmail.com" }
-]
-requires-python = ">=3.14"
-dependencies = []
-
-[project.scripts]
-depende = "depende:main"
-
-[build-system]
-requires = ["uv_build>=0.9.11,<0.10.0"]
-build-backend = "uv_build"

depende-0.1.0/src/depende/__init__.py

@@ -1,2 +0,0 @@
-def main() -> None:
-    print("Hello from depende!")