From: Yurii Motov <109919500+YuriiMotov@users.noreply.github.com> Date: Sat, 23 May 2026 16:35:54 +0000 (+0200) Subject: 📝 Document `--entrypoint` CLI option (#15464) X-Git-Tag: 0.136.2~6 X-Git-Url: http://git.ipfire.org/gitweb/index.cgi?a=commitdiff_plain;h=7b57e42986bb4d40c9eb6580537d13fb8e76097e;p=thirdparty%2Ffastapi%2Ffastapi.git 📝 Document `--entrypoint` CLI option (#15464) --- diff --git a/docs/en/docs/fastapi-cli.md b/docs/en/docs/fastapi-cli.md index 17898888f..9d8f415d9 100644 --- a/docs/en/docs/fastapi-cli.md +++ b/docs/en/docs/fastapi-cli.md @@ -95,7 +95,7 @@ which would be equivalent to: from backend.main import app ``` -### `fastapi dev` with path { #fastapi-dev-with-path } +### `fastapi dev` with path or with `--entrypoint` CLI option { #fastapi-dev-with-path-or-with-entrypoint-cli-option } You can also pass the file path to the `fastapi dev` command, and it will guess the FastAPI app object to use: @@ -103,7 +103,13 @@ You can also pass the file path to the `fastapi dev` command, and it will guess $ fastapi dev main.py ``` -But you would have to remember to pass the correct path every time you call the `fastapi` command. +Or, you can also pass the `--entrypoint` option to the `fastapi dev` command: + +```console +$ fastapi dev --entrypoint main:app +``` + +But you would have to remember to pass the correct path\entrypoint every time you call the `fastapi` command. Additionally, other tools might not be able to find it, for example the [VS Code Extension](editor-support.md) or [FastAPI Cloud](https://fastapicloud.com), so it is recommended to use the `entrypoint` in `pyproject.toml`. diff --git a/docs/en/docs/tutorial/first-steps.md b/docs/en/docs/tutorial/first-steps.md index 96aaa7463..ae43e401b 100644 --- a/docs/en/docs/tutorial/first-steps.md +++ b/docs/en/docs/tutorial/first-steps.md @@ -180,7 +180,7 @@ which would be equivalent to: from backend.main import app ``` -### `fastapi dev` with path { #fastapi-dev-with-path } +### `fastapi dev` with path or with `--entrypoint` CLI option { #fastapi-dev-with-path-or-with-entrypoint-cli-option } You can also pass the file path to the `fastapi dev` command, and it will guess the FastAPI app object to use: @@ -188,7 +188,13 @@ You can also pass the file path to the `fastapi dev` command, and it will guess $ fastapi dev main.py ``` -But you would have to remember to pass the correct path every time you call the `fastapi` command. +Or, you can also pass the `--entrypoint` option to the `fastapi dev` command: + +```console +$ fastapi dev --entrypoint main:app +``` + +But you would have to remember to pass the correct path\entrypoint every time you call the `fastapi` command. Additionally, other tools might not be able to find it, for example the [VS Code Extension](../editor-support.md) or [FastAPI Cloud](https://fastapicloud.com), so it is recommended to use the `entrypoint` in `pyproject.toml`.