fastapi_di

Depends で依存を明示する汎用 DI。解決戦略（リゾルバ）を差し替えられる。

名前のとおり FastAPI の DI に似せている。Depends / Dependant / solve_dependencies の設計を踏襲しつつ、HTTP 依存（Request、query/path/body、 pydantic 検証）を全て剥がした。FastAPI には依存せず（依存パッケージなし）、 Web に限らずパイプライン処理・バッチ・CLI・ライブラリ内部の配線に使える。

  • 依存は明示 Depends のみ。型アノテーションによる自動ワイヤリングはしない。 書いていないものは注入されない。
  • 解析と実行が分かれている。シグネチャを辿るだけで依存グラフが得られる（実行しない）。
  • 参照の意味を差し替えられる。Depends("name") の "name" が何を指すかは リゾルバが決める。既定は完全一致だが、チェーンや凍結表に差し替えられる。

要件: Python >= 3.14 / 依存パッケージなし。

インストール

uv add fastapi_di

使う

import asyncio
from typing import Annotated

from fastapi_di import Depends, Injector


def get_settings() -> dict:
    return {"dsn": "postgres://localhost"}


def get_dsn(settings: Annotated[dict, Depends(get_settings)]) -> str:
    return settings["dsn"]


class Database:
    def __init__(self, dsn: str = Depends(get_dsn)) -> None:
        self.dsn = dsn


async def main() -> None:
    injector = Injector()
    async with injector as scope:            # スコープ = 依存の生存期間
        db = await scope.inject(Database)    # Database -> get_dsn -> get_settings
        print(db.dsn)


asyncio.run(main())

クラス内の派生値（depend_property）

depend_property は getter の引数を同じクラスのメンバから解決するプロパティ。 Injector とは無縁の同期ディスクリプタで、Depends の構文だけを共有する。 既定はキャッシュしない（毎回再計算）。cache="auto" にすると依存から戦略が 伝搬し（cached_property だけに依存すれば自分もキャッシュ、property が混ざれば 毎回再計算）、cache=True で強制キャッシュする。

from functools import cached_property

from fastapi_di import Depends, depend_property


class Service:
    @cached_property
    def user(self) -> dict:
        return {"name": "alice", "deleted_at": None}

    @depend_property(cache="auto")
    def is_active_user(self, user=Depends(user)) -> bool:
        return user["deleted_at"] is None


print(Service().is_active_user)  # True（user が cached かつ cache="auto" なのでキャッシュされる）

詳細は 使う を参照。

ビジョン

狙いは依存性の解決を標準化すること。三段階で考えている。

  1. 小回りの利く小さな DI — 数十行のスクリプトから使える。フレームワークを 持ち込まず、Depends を書くだけ。今ここ。
  2. パイプライン処理などへの展開 — 依存グラフは DAG そのもの。同じ宣言から 実行順序・並列性・キャッシュ境界を導ける。DI とワークフローを別物にしない。
  3. 依存関係の定義フォーマット — OpenAPI が HTTP インターフェースに対して 果たした役割を、依存関係に対して果たすもの。何が何に依存しているかを 機械可読な形で宣言・可視化・検証でき、言語や実装をまたいで共有できる形式。

graph.to_json() と bindings.json は、その 3 番目に向けた最初の一歩。 前者が「どう繋がっているか」、後者が「なぜそう繋がったか」を外に出す。

ドキュメント

Project links

Data verified by PyPI on Jul 23, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for sasano8 from gravatar.com sasano8

Credits

Author: sasano8

GitHub Statistics

Data verified by PyPI on Jul 23, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.14

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fastapi_di-0.1.0.tar.gz (67.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fastapi_di-0.1.0-py3-none-any.whl (34.4 kB view details)

Uploaded Python 3

File details

Details for the file fastapi_di-0.1.0.tar.gz.

File metadata

  • Download URL: fastapi_di-0.1.0.tar.gz
  • Upload date:
  • Size: 67.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for fastapi_di-0.1.0.tar.gz
Algorithm Hash digest
SHA256 a263dafa08fb6dba08c71c1549889c50bde14ce6d0a9e496101740a25bb25093
MD5 077053fcfdeb7d0e15c86fa368d1054c
BLAKE2b-256 ff8daf42fe65682d9939f5ac2fc8455f75b02dc81ee1aa4b9de35a69bbc02428

See more details on using hashes here.

Provenance

The following attestation bundles were made for fastapi_di-0.1.0.tar.gz:

Publisher: release.yml on sasano8/fastapi_di

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file fastapi_di-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: fastapi_di-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 34.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for fastapi_di-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 fc1b3e4fade4d3f79d07c1c991e886a07f7df8117d3825c7f8cca3377eba8419
MD5 f53091ee4374a42f533d2455a9a09e30
BLAKE2b-256 bfe85c5f8ef0d4e807319a1a8163dd7148d90a707d3efff4261d8fb14f85780a

See more details on using hashes here.

Provenance

The following attestation bundles were made for fastapi_di-0.1.0-py3-none-any.whl:

Publisher: release.yml on sasano8/fastapi_di

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.1.2

2 files

0.1.1

2 files

This release

0.1.0 This release

2 files

0.0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page