Python Poetry Cheat Sheet

poetry new myproject          # scaffold a new project with src layoutcd myprojectpoetry init                     # interactively create pyproject.toml in an existing dirpoetry check                      # validate pyproject.tomlpoetry env info                    # show the active virtualenv's details

poetry add requests                     # add a runtime dependencypoetry add pytest --group dev             # add a dev-only dependency (groups)poetry add "django>=4.2,<5.0"               # version constraintpoetry remove requests                        # remove a dependencypoetry update                                   # update all deps within constraintspoetry update requests                            # update just one packagepoetry show --tree                                  # show dependency treepoetry lock                                            # regenerate poetry.lock without installing

poetry install                    # install all deps from poetry.lockpoetry install --no-dev              # (legacy) or: poetry install --only mainpoetry install --sync                   # remove packages not in the lockfilepoetry run python script.py               # run inside the project's venvpoetry run pytest                           # run a tool inside the venvpoetry shell                                  # spawn a subshell with the venv activatedpoetry env use python3.12                       # pin the interpreter version

poetry build                                    # produce dist/*.whl and dist/*.tar.gzpoetry config pypi-token.pypi <token>              # store a PyPI API tokenpoetry publish                                        # build (if needed) and upload to PyPIpoetry publish --build                                  # explicit build + publish in one steppoetry version patch                                      # bump 1.2.3 -> 1.2.4 in pyproject.toml