Expose host for several apps.

CHANGELOG.md

@@ -18,6 +18,8 @@ The **third number** is for emergencies when we need to start branches for older
   ([#58](https://github.com/Tinche/uapi/pull/58))
 - Dictionaries are now supported in the OpenAPI schema, rendering to object schemas with `additionalProperties`.
   ([#58](https://github.com/Tinche/uapi/pull/58))
+- {meth}`uapi.flask.FlaskApp.run`, {meth}`uapi.quart.QuartApp.run` and {meth}`uapi.starlette.StarletteApp.run` now expose `host` parameters.
+  ([#59](https://github.com/Tinche/uapi/pull/59))
 
 ## [v23.3.0](https://github.com/tinche/uapi/compare/v23.2.0...v23.3.0) - 2023-12-20
 

pyproject.toml

@@ -43,6 +43,7 @@ test = [
     "uapi[lint, frameworks]",
     "python-multipart>=0.0.6",
     "pytest-mypy-plugins>=3.0.0",
+    "pytest-xdist>=3.5.0",
 ]
 frameworks = [
     "aiohttp==3.9.0b0",

src/uapi/flask.py

@@ -143,8 +143,9 @@ def adapter(**kwargs):
 
         return f
 
-    def run(self, import_name: str, port: int = 8000):
-        self.to_framework_app(import_name).run(port=port)
+    def run(self, import_name: str, host: str | None = None, port: int = 8000):
+        """Start serving the app using the Flask development server."""
+        self.to_framework_app(import_name).run(host=host, port=port)
 
     @staticmethod
     def _path_param_parser(p: str) -> tuple[str, list[str]]:

src/uapi/quart.py

@@ -164,6 +164,7 @@ async def adapter(**kwargs):
     async def run(
         self,
         import_name: str,
+        host: str = "127.0.0.1",
         port: int = 8000,
         handle_signals: bool = True,
         log_level: str | int | None = None,
@@ -176,6 +177,7 @@ async def run(
 
         config = Config(
             self.to_framework_app(import_name),
+            host=host,
             port=port,
             access_log=False,
             log_level=log_level,

src/uapi/starlette.py

@@ -178,6 +178,7 @@ async def adapted(
 
     async def run(
         self,
+        host: str = "127.0.0.1",
         port: int = 8000,
         handle_signals: bool = True,
         log_level: str | int | None = None,
@@ -189,7 +190,11 @@ async def run(
         from uvicorn import Config, Server
 
         config = Config(
-            self.to_framework_app(), port=port, access_log=False, log_level=log_level
+            self.to_framework_app(),
+            host=host,
+            port=port,
+            access_log=False,
+            log_level=log_level,
         )
 
         if handle_signals:

tests/quart.py

@@ -68,4 +68,4 @@ def request_method_native(req_method: Method) -> Response:
 
 
 async def run_on_quart(app: App, port: int) -> None:
-    await app.run(__name__, port, handle_signals=False, log_level="critical")
+    await app.run(__name__, port=port, handle_signals=False, log_level="critical")

tests/starlette.py

@@ -68,4 +68,4 @@ def request_method_native(req_method: Method) -> Response:
 
 
 async def run_on_starlette(app: App, port: int) -> None:
-    await app.run(port, handle_signals=False)
+    await app.run(port=port, handle_signals=False)

tox.ini

@@ -1,16 +1,16 @@
 # Keep docs in sync with docs env and .readthedocs.yml.
 [gh-actions]
 python =
-    3.10: py310, lint
+    3.10: py310
     3.11: py311
-    3.12: py312
+    3.12: py312, lint
 
 [tox]
 envlist = py310, py311, py312, lint
 isolated_build = True
 
 [testenv:lint]
-basepython = python3.10
+basepython = python3.12
 allowlist_externals =
     make
     pdm
@@ -21,9 +21,12 @@ commands =
 [testenv]
 setenv =
     PDM_IGNORE_SAVED_PYTHON="1"
+    COVERAGE_PROCESS_START={toxinidir}/pyproject.toml
+commands_pre =
+    pdm sync -G test
+    python -c 'import pathlib; pathlib.Path("{env_site_packages_dir}/cov.pth").write_text("import coverage; coverage.process_startup()")'
 commands =
-    pdm install -G test
-    pdm run coverage run -m pytest tests --mypy-only-local-stub {posargs}
+    pdm run coverage run -m pytest tests --mypy-only-local-stub -n auto {posargs}
 allowlist_externals = pdm
 package = wheel
 wheel_build_env = .pkg