Closed
Description
Refs: #22810
- macOS @Tyriar
- windows @karthiknadig
- linux @connor4312
Complexity: 4
Authors: @flying-sheep, @karrtikr
- Install Hatch
-
using the GUI installers on macOS or windows
-
using your system package manager on Arch Linux or Fedora
-
using
pipx install Hatchon other Linux distributions. Please make sure you set your PATH correctly in this case.Setting PATH on Linux
If you cannot install Hatch system-wide, you might need to add
$HOME/.local/binto your PATH environment variable for your graphical session, not just your terminal. Check like this:$ pgrep bin/code # or some other graphical application 1234 $ cat /proc/1234/environ | tr '\0' '\n' | grep -E '^PATH=' PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
If the the directory is not in there, you need to add it in your session startup script, in a way that depends on your desktop environment:
-
- In an empty VS Code project, add two files:
- testproj.py containing
import session_info session_info.show()
- … and a pyproject.toml specifying
dependencies:[project] name = "testproj" version = "0.1.0" dependencies = ["session-info"] [build-system] requires = ["hatchling"] build-backend = "hatchling.build"
- testproj.py containing
- Make Hatch install the project and its dependencies to an environment using
hatch run ..., e.g.hatch run python -V(there is no configuration necessary for Hatch to work in a simple case like this) - Select the
testprojas an interpreter using Python: Select Interpreter command
- Run it using the play icon on top right
- The file is successfully run and prints the session info:
- Open a new terminal: If you have the
python.terminal.activateEnvironmentsetting set totrue, the environment should be activated:
Runpip -Vand compare if the path starts with the path displayed byhatch env find(pip’s contains an additionallib/pythonX.YZ/site-packages/pip)