Python Monorepo com UV e Namespace Packages - Guia Definitivo

Neste vídeo, vou te ensinar a criar uma estrutura de projeto Python robusta e escalável, utilizando Namespace Packages e a ferramenta UV (da Astral). Vamos montar um Monorepo do zero, inspirado na arquitetura da biblioteca LangGraph.

Você vai aprender como organizar múltiplas bibliotecas dentro de um único repositório e, o mais importante, como usar os Workspaces do UV para gerenciar tudo isso com um único ambiente virtual. Essa técnica é essencial para quem quer profissionalizar seus projetos e fugir da bagunça de múltiplos venvs.

Neste vídeo você vai ver:

Como funciona a estrutura de um Monorepo Python.
O que são Namespace Packages e por que usá-los.
Como configurar o pyproject.toml para Workspaces UV.
Como sincronizar dependências locais e externas com o UV.
Solução de problemas comuns como Importações Circulares e Type Stubs.

Se você quer levar sua organização de código para o próximo nível, esse tutorial é para você.

Links Mencionados:

Repositório do projeto (Titan):
https://github.com/luizomf/uvpypackages

Vídeo anterior:
   • Pacotes de Namespace no Python  

Meus Cursos: https://www.otaviomiranda.com.br/
Newsletter: https://luizomf.substack.com/

Capítulos

00:00:00 - Inspiração no LangGraph Monorepo
00:01:36 - O Conceito de Workspaces no UV
00:03:50 - Criando a Estrutura de Pastas do Zero
00:06:50 - Configurando o Workspace e Venv Único
00:09:50 - Criando os Pacotes, Packages e Libs
00:13:30 - Entendendo Namespace Packages na Prática
00:16:40 - Configurando o pyproject.toml da Raiz
00:20:50 - Configurando Dependências Locais
00:25:00 - Configurando Ruff e Pyright para Linting
00:31:00 - Criando o Ambiente Virtual com UV Sync
00:35:00 - Testando os Namespaces e Imports
00:41:00 - UV Sync vs UV Run para All Packages
00:45:00 - O Perigo das Importações Circulares
00:46:40 - Resolvendo Problemas de Stubs e Tipagem
00:51:00 - Conclusão e Repositório

#python #uv #monorepo #python3 #programação