poetry.md

Poetry

• NOTE: it's possible to use the built-in .venv virtual environment (e.g., troubleshooting SolverProblemError dependency hell)

  poetry env use .venv/bin/python

• Install from the Setup section
• Normal usage

  # Install
  curl -sSL https://install.python-poetry.org | $(which python3) -
  
  # Uninstall
  export POETRY_UNINSTALL=1
  curl -sSL https://install.python-poetry.org | $(which python3) -
  
  # Change config
  poetry config virtualenvs.in-project true           # .venv in `pwd`
  
  # Activate virtual environment (venv)
  poetry shell
  
  # Deactivate venv
  exit  # ctrl-d
  
  # Initialize existing project
  poetry init
  
  # Install from requirements.txt
  poetry add `cat requirements.txt`
  
  # Install multiple libraries
  poetry add google-auth google-api-python-client
  
  # dev dependencies
  poetry add --group dev rich
  
  # Install virtual environment w/o dev deps (creates venv if not present)
  poetry install --no-ansi --without dev
  
  # Run script and exit environment
  poetry run python your_script.py
  
  # Update dependencies
  poetry update
  
  # Remove library
  poetry remove google-auth
  
  # Generate requirements.txt
  poetry export -f requirements.txt --output requirements.txt --without-hashes

• Poetry with asdf

   # Add poetry asdf plugin
  asdf plugin-add poetry https://github.com/asdf-community/asdf-poetry.git
  
  # Install latest version via asdf
  asdf install poetry latest
  
  # Set latest version as default
  asdf global poetry latest
  
  # Install via asdf w/version
  ASDF_POETRY_INSTALL_URL=https://install.python-poetry.org asdf install poetry 1.3.2
  asdf local poetry latest    # 1.3.2