Python uv virtualenv e requirements.md

uv com Python

Instalando o uv

https://docs.astral.sh/uv/

curl -LsSf https://astral.sh/uv/install.sh | sh

Atualizando o uv

uv self update

Para iniciar o uv

Dentro da pasta do projeto

uv init

Para iniciar com uma versõa definida do python

uv init -p 3.8

Para instalar as dependências do requirements migrando da versão antiga para usar somenteo uv

uv add -r requirements.txt

Em caso de erro, adicione essa parte abaixo no seu pyproject.toml

[project.optional-dependencies]
build = ["setuptools==56.0.0", "wheel>=0.44.0", "clang"]

[tool.uv]
no-build-isolation-package = ["django-allauth"]

Depois execute

uv sync --extra build

E depois execute

uv add -r requirements.txt

Ou dessa maneira abaixo, que não atualiza o pyproject.toml

uv pip sync docs/requirements.txt

Se a venv não foi criada no comando uv init execute o comando abaixo para criar a venv

uv venv

para instalar pip ou bibliotecas mais antigas

uv pip install pip==23.0.1

uv add setuptools==60.*

Como adiconar o Django por exemplo

uv add Django==5.1

Instalar bibliotecas de desenvolvimento

uv add --dev ruff

uv add --dev ipython

uv add --dev ipdb

Exemplo de como executar o script na env isolada

uv run python hello.py

ou simplesmente

uv run hello.py

uv run python -V

Fazer o uv autocomplementar o código

Para demais shells https://docs.astral.sh/uv/getting-started/installation/#shell-autocompletion

echo 'eval "$(uv generate-shell-completion bash)"' >> ~/.bashrc

echo 'eval "$(uvx --generate-shell-completion bash)"' >> ~/.bashrc

Feche e abra novamente o seu shell

Versões do Python

Instalando e gerenciando o próprio Python.

• uv python install: Instalar versões do Python.
• uv python list: Veja as versões disponíveis do Python.
• uv python find: Encontre uma versão instalada do Python.
• uv python pin: Fixe o projeto atual para usar uma versão específica do Python.
• uv python uninstall: Desinstale uma versão do Python.

Para instalar uma ferramenta a ser usada em todo o computador

uv tool install ruff

Para executar uma ferramenta em qualquer pasta

uvx ruff