2026년 7월 28일 - Link Blog

uv 0.12.0. 이번 uv 릴리스에는 몇 가지 흥미로운 중대한 변경 사항(breaking changes)이 있으며, 특히 uv init 명령어로 생성되는 기본 프로젝트 구조에 변화가 있습니다.

uv init은 새로운 프로젝트를 생성하기 위한 uv의 단축 명령어입니다. 이전 버전인 uv 0.11.x 버전에서는 uv init uv-init을 실행했을 때 다음과 같은 디렉토리가 생성되었습니다.

uv 0.12 버전에서 생성되는 결과물은 다음과 같습니다. 저는 uv init의 출력을 자동으로 스냅샷으로 찍는 GitHub 저장소를 운영하고 있으므로, 전체 차이점(diff)을 확인하실 수 있습니다:

GitHub diff view. uv-init/main.py is an old name=="main" file that has been entirely deleted. The pyproject.toml now has an authors list and a new project.scripts block defining uv-init as uv_init:main - and a new build-system block that uses uv_build as the build-backend. A new src/uv_init/init.py file contains a main() method with a -> None type annotation that prints Hello from uv-init.

이제 uv init은 프로젝트 루트에 main.py를 두는 대신, 기본적으로 src/ 형태의 패키지 구조를 사용합니다. 또한 uv build를 실행할 때 휠(wheels) 및 .tar.gz 배포 파일을 빌드하기 위해 uv_build 백엔드를 구성합니다. 마지막으로, uv-init을 스크립트 별칭(script alias)으로 설정하여, uv run uv-init으로 실행 시 src/uv_init/__init__.py에 있는 새로운 main() 함수를 실행합니다.

저는 지금까지 그저 관성 때문에 제 프로젝트에서 src 레이아웃 사용을 피해 왔습니다. 이제는 전환할 때가 된 것 같습니다.

최근 기사

• OpenAI가 Hugging Face를 상대로 의도치 않게 감행한 사이버 공격은 실제로 일어난 SF다 - 2026년 7월 22일
• Claude Code 팀의 Cat 및 Thariq와 함께하는 Fireside Chat - 2026년 7월 21일
• Kimi K3, 그리고 pelican 벤치마크에서 우리가 여전히 배울 수 있는 것 - 2026년 7월 16일