Skip to main content

Pew-style project management for Poetry

Project description


Pew-style project management for Poetry 1.2 and higher.

poetry-alias introduces a new alias command suite for Poetry which allows you to define short names (“aliases”) for you Poetry-based projects, and then use these to switch to the project directories from wherever you are.

$ cd $HOME/src/myproject
[~/src/myproject]$ poetry alias add myproject
[~/src/myproject]$ cd
$ poetry alias go myproject
Spawning shell within /home/user/.cache/pypoetry/virtualenvs/myproject-Hyrvhkrx-py3.8
[~/src/myproject]$ . /home/user/.cache/pypoetry/virtualenvs/myproject-Hyrvhkrx-py3.8/bin/activate


Install poetry-alias by running:

poetry plugin add poetry-alias


  • poetry alias add eggs — define “eggs” as alias for the current project. If a different project already used “eggs” as its alias, the command would abort with a corresponding error message. Multiple aliases can be defined per project.

  • poetry alias show — show all aliases for the current project.

  • poetry alias list — list all project aliases in alphabetical order along with their assigned project directories.

  • poetry alias go eggs — change to the directory of the project aliased “eggs”, and activate the virtualenv.

  • poetry alias rm eggs — remove the “eggs” project alias. The alias name is optional for this command; if omitted, the current projects’ aliases will be removed.

  • poetry alias prune — remove all aliases that no longer point to a project directory.

  • poetry alias clean — remove all alias definitions.



The project is licensed under the MIT license.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

poetry-alias-0.1.0.tar.gz (9.8 kB view hashes)

Uploaded source

Built Distribution

poetry_alias-0.1.0-py3-none-any.whl (12.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page