Skip to content

Python uv virtualenv e requirements.md

Latest commit

 

History

History
144 lines (120 loc) · 2.79 KB

Python uv virtualenv e requirements.md

File metadata and controls

144 lines (120 loc) · 2.79 KB

uv com Python

Instalando o uv

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

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

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

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

Para listar

uv pip list

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

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

Para exportar para o requirements.txt

uv pip freeze > requirements.txt

Para atualizar a versão do python para uma env já existente

  1. Altere a versão nos arquivos pyproject.toml e .python-version
  2. Isso deleta e cria uma nova .venv/ com a nova versão:
uv sync

(Geralmente não executar) Se necessário reinstale as dependências do projeto

uv pip install -e .