fastapi-cli 0.0.31__tar.gz → 0.0.33__tar.gz

{fastapi_cli-0.0.31 → fastapi_cli-0.0.33}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: fastapi-cli
-Version: 0.0.31
+Version: 0.0.33
 Summary: Run and manage FastAPI apps from the command line with FastAPI CLI. 🚀
-Author-Email: =?utf-8?q?Sebasti=C3=A1n_Ram=C3=ADrez?= <tiangolo@gmail.com>
+Author-Email: Sebastián Ramírez <tiangolo@gmail.com>
 License-Expression: MIT
 License-File: LICENSE
 Classifier: Intended Audience :: Information Technology
@@ -24,13 +24,14 @@ 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
 Project-URL: Homepage, https://github.com/fastapi/fastapi-cli
 Project-URL: Documentation, https://fastapi.tiangolo.com/fastapi-cli/
 Project-URL: Repository, https://github.com/fastapi/fastapi-cli
 Project-URL: Issues, https://github.com/fastapi/fastapi-cli/issues
 Project-URL: Changelog, https://github.com/fastapi/fastapi-cli/blob/main/release-notes.md
 Requires-Python: >=3.10
-Requires-Dist: typer>=0.16.0
+Requires-Dist: typer>=0.26.1
 Requires-Dist: uvicorn[standard]>=0.15.0
 Requires-Dist: rich-toolkit>=0.14.8
 Requires-Dist: tomli>=2.0.0; python_version < "3.11"
@@ -121,6 +122,10 @@ By default, it will have **auto-reload** enabled, so it will automatically reloa
 
 By default it will listen on the IP address `127.0.0.1`, which is the IP for your machine to communicate with itself alone (`localhost`).
 
+Before importing your app, `fastapi dev` sets the `FASTAPI_ENV` environment variable to `development`. If `FASTAPI_ENV` is already set, its existing value is preserved. This lets app startup code choose development-friendly behavior while allowing you to provide an app-specific environment such as `staging`.
+
+The conventional `FASTAPI_ENV` values are `development` and `production`. `fastapi run` currently leaves `FASTAPI_ENV` unchanged, so set it explicitly if your app needs to detect production mode.
+
 ## `fastapi run`
 
 When you run `fastapi run`, it will run on production mode by default.

{fastapi_cli-0.0.31 → fastapi_cli-0.0.33}/README.md

@@ -76,6 +76,10 @@ By default, it will have **auto-reload** enabled, so it will automatically reloa
 
 By default it will listen on the IP address `127.0.0.1`, which is the IP for your machine to communicate with itself alone (`localhost`).
 
+Before importing your app, `fastapi dev` sets the `FASTAPI_ENV` environment variable to `development`. If `FASTAPI_ENV` is already set, its existing value is preserved. This lets app startup code choose development-friendly behavior while allowing you to provide an app-specific environment such as `staging`.
+
+The conventional `FASTAPI_ENV` values are `development` and `production`. `fastapi run` currently leaves `FASTAPI_ENV` unchanged, so set it explicitly if your app needs to detect production mode.
+
 ## `fastapi run`
 
 When you run `fastapi run`, it will run on production mode by default.

{fastapi_cli-0.0.31 → fastapi_cli-0.0.33}/pyproject.toml

@@ -31,14 +31,15 @@ classifiers = [
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
 ]
 dependencies = [
-    "typer >= 0.16.0",
+    "typer >= 0.26.1",
     "uvicorn[standard] >= 0.15.0",
     "rich-toolkit >= 0.14.8",
     "tomli >= 2.0.0; python_version < '3.11'",
 ]
-version = "0.0.31"
+version = "0.0.33"
 
 [project.optional-dependencies]
 standard = [
@@ -71,7 +72,7 @@ github-actions = [
 tests = [
     "coverage[toml]>=6.2,<8.0",
     "fastapi>=0.128.0",
-    "mypy==2.1.0",
+    "mypy==2.4.0",
     "pytest>=7.4.0,<10.0.0",
     "ruff>=0.15.15",
     "uvicorn>=0.39.0",
@@ -106,6 +107,7 @@ xfail_strict = true
 junit_family = "xunit2"
 
 [tool.coverage.run]
+core = "ctrace"
 parallel = true
 data_file = "coverage/.coverage"
 source = [

fastapi_cli-0.0.33/src/fastapi_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.0.33"

{fastapi_cli-0.0.31 → fastapi_cli-0.0.33}/src/fastapi_cli/cli.py

@@ -45,7 +45,7 @@ SOURCE_DESCRIPTIONS: dict[ModuleConfigSource | AppConfigSource, str] = {
 try:
     import uvicorn
 except ImportError:  # pragma: no cover
-    uvicorn = None  # type: ignore[assignment]  # ty: ignore[invalid-assignment]
+    uvicorn = None  # type: ignore[assignment]
 
 
 try:
@@ -399,6 +399,8 @@ def dev(
 
     Otherwise, it uses the first [bold]FastAPI[/bold] app found in the imported module or package.
     """
+    os.environ.setdefault("FASTAPI_ENV", "development")
+
     _run(
         path=path,
         host=host,

{fastapi_cli-0.0.31 → fastapi_cli-0.0.33}/src/fastapi_cli/discover.py

@@ -12,7 +12,7 @@ logger = getLogger(__name__)
 try:
     from fastapi import FastAPI
 except ImportError:  # pragma: no cover
-    FastAPI = None  # type: ignore[misc, assignment]  # ty: ignore[invalid-assignment]
+    FastAPI = None  # type: ignore[misc, assignment]
 
 
 def get_default_path() -> Path:

fastapi_cli-0.0.33/tests/assets/environment_app.py

@@ -0,0 +1,12 @@
+import os
+
+from fastapi import FastAPI
+
+app = FastAPI()
+
+fastapi_env_at_import = os.environ.get("FASTAPI_ENV")
+
+
+@app.get("/fastapi-env")
+def get_fastapi_env() -> dict[str, str | None]:
+    return {"fastapi_env": fastapi_env_at_import}

{fastapi_cli-0.0.31 → fastapi_cli-0.0.33}/tests/test_cli.py

@@ -6,7 +6,10 @@ from unittest.mock import patch
 
 import pytest
 import uvicorn
+from fastapi.testclient import TestClient
+from httpx import Response
 from typer.testing import CliRunner
+from uvicorn.importer import import_from_string
 
 from fastapi_cli.cli import app
 from fastapi_cli.utils.cli import get_uvicorn_log_config
@@ -18,7 +21,8 @@ assets_path = Path(__file__).parent / "assets"
 
 
 @pytest.fixture(autouse=True)
-def force_rich_logs(monkeypatch: pytest.MonkeyPatch) -> None:
+def isolate_cli_environment(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.delenv("FASTAPI_ENV", raising=False)
     monkeypatch.setattr("fastapi_cli.cli.should_use_rich_logs", lambda: True)
 
 
@@ -53,6 +57,49 @@ def test_dev() -> None:
         assert "Configuration sources:" not in result.output
 
 
+def _get_fastapi_env_response(*, command: str, fastapi_env: str | None) -> Response:
+    module_name = "environment_app"
+    sys.modules.pop(module_name, None)
+
+    try:
+        with changing_dir(assets_path):
+            with patch.object(uvicorn, "run") as mock_run:
+                result = runner.invoke(
+                    app,
+                    [command, f"{module_name}.py"],
+                    env={"FASTAPI_ENV": fastapi_env},
+                )
+
+        assert result.exit_code == 0, result.output
+        assert mock_run.call_args
+        imported_app = import_from_string(mock_run.call_args.kwargs["app"])
+        with TestClient(imported_app) as test_client:
+            return test_client.get("/fastapi-env")
+    finally:
+        sys.modules.pop(module_name, None)
+
+
+def test_dev_sets_fastapi_env_before_app_import() -> None:
+    response = _get_fastapi_env_response(command="dev", fastapi_env=None)
+
+    assert response.status_code == 200
+    assert response.json() == {"fastapi_env": "development"}
+
+
+def test_dev_does_not_override_existing_fastapi_env() -> None:
+    response = _get_fastapi_env_response(command="dev", fastapi_env="chicken")
+
+    assert response.status_code == 200
+    assert response.json() == {"fastapi_env": "chicken"}
+
+
+def test_run_does_not_set_fastapi_env() -> None:
+    response = _get_fastapi_env_response(command="run", fastapi_env=None)
+
+    assert response.status_code == 200
+    assert response.json() == {"fastapi_env": None}
+
+
 def test_run_uses_uvicorn_default_log_config_without_rich_logs(
     monkeypatch: pytest.MonkeyPatch,
 ) -> None:

{fastapi_cli-0.0.31 → fastapi_cli-0.0.33}/tests/test_requirements.py

@@ -18,7 +18,7 @@ def test_no_uvicorn() -> None:
 
     import fastapi_cli.cli
 
-    fastapi_cli.cli.uvicorn = None  # type: ignore[attr-defined, assignment]  # ty: ignore[invalid-assignment]
+    fastapi_cli.cli.uvicorn = None  # type: ignore[attr-defined, assignment]
 
     with changing_dir(assets_path):
         result = runner.invoke(fastapi_cli.cli.app, ["dev", "single_file_app.py"])
@@ -37,7 +37,7 @@ def test_no_fastapi() -> None:
 
     import fastapi_cli.discover
 
-    fastapi_cli.discover.FastAPI = None  # type: ignore[attr-defined, assignment]  # ty: ignore[invalid-assignment]
+    fastapi_cli.discover.FastAPI = None  # type: ignore[attr-defined, assignment]
     with changing_dir(assets_path):
         with pytest.raises(FastAPICLIException) as exc_info:
             get_import_data(path=Path("single_file_app.py"))

fastapi_cli-0.0.31/src/fastapi_cli/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.0.31"