Skip to content

Update run fastapi doc and initial python setup doc per issue 2008#2317

Merged
kcmartin merged 3 commits intomainfrom
issue-2008-poetry-fastapi-docs-fix
Feb 25, 2026
Merged

Update run fastapi doc and initial python setup doc per issue 2008#2317
kcmartin merged 3 commits intomainfrom
issue-2008-poetry-fastapi-docs-fix

Conversation

@kcmartin
Copy link
Contributor

@kcmartin kcmartin commented Dec 12, 2025

Summary

Fixes #2008 — Poetry 2.0+ removed the built-in poetry shell command, breaking the documented workflow.

Changes

  • _poetry_new.erb (shared partial): Remove poetry shell, add a callout about Poetry 2.0+ with poetry run and poetry env activate alternatives
  • initial-setup.html.md: Replace poetry shell with poetry env activate, add note about the shell plugin for users who prefer it
  • fastapi.html.markerb: Restore poetry add "fastapi[standard]" to the FastAPI page (was previously removed and incorrectly placed in the shared partial)

Testing

Verified the full Poetry 2.0 workflow locally with Poetry 2.3.2:

  • poetry new creates a project with PEP 621 format ([project] dependencies)
  • poetry add "fastapi[standard]" works correctly
  • poetry run fastapi dev runs the app successfully
  • poetry shell confirms the expected error on 2.0+
  • poetry env activate works as documented

Notes

The related fly launch scanner issue (not recognizing [extras] in PEP 621 dependencies) was already fixed in superfly/flyctl#4458.

Remove hardcoded FastAPI content from the shared _poetry_new partial,
restore poetry add to the FastAPI page, and update initial-setup with
poetry env activate guidance and a callout about the Poetry 2.0 change.
@kcmartin kcmartin marked this pull request as ready for review February 25, 2026 19:40
@kcmartin kcmartin changed the title DRAFT: update run fastapi doc and initial python setup doc per issue 2008 Update run fastapi doc and initial python setup doc per issue 2008 Feb 25, 2026
@kcmartin kcmartin merged commit c9f442f into main Feb 25, 2026
2 checks passed
@kcmartin kcmartin deleted the issue-2008-poetry-fastapi-docs-fix branch February 25, 2026 20:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Issue with the "Run a FastAPI app" doc: poetry shell is no longer available

1 participant