Projects, targets & dependencies프로젝트, 타깃, 의존성

Layout구조

A project is a uv workspace. Each package is a workspace member and, under toolchain, one Gradle module.

프로젝트는 uv 워크스페이스입니다. 패키지마다 워크스페이스 멤버이며, toolchain 에서는 Gradle 모듈 하나입니다.

<project>/
├── .venv/                 # dev environment for building the project
├── pyproject.toml, uv.lock
└── <package>/
    ├── pyproject.toml
    ├── src/main/  src/<family>/  src/test/
    ├── build/crossenv/<triple>/                               # per-target installs
    ├── build/packpack/<bundle type>/<build type>/<level>/     # bundles
    └── dist/<triple>/<build type>/<level>/                    # `ppp build` output

Targets타깃

Targets are canonical triples; a few aliases are accepted and normalized. ppp target list prints them all.

타깃은 정식 트리플이며, 몇 가지 별칭은 받아서 정규화합니다. ppp target list 가 전부 보여 줍니다.

ppp target add <target>...            # the project and every workspace member
ppp target remove <target>...
ppp core target add <target>...       # one package

target add edits [tool.ppp.dependencies].platforms and creates src/<family>/__init__.py in each affected package. A new package inherits the project's targets.

target add 는 [tool.ppp.dependencies].platforms 를 고치고, 영향받는 패키지마다 src/<family>/__init__.py 를 만듭니다. 새 패키지는 프로젝트의 타깃을 물려받습니다.

The dev environment개발 환경

Root-level commands act on the project's .venv with plain uv:

루트 수준 명령은 프로젝트의 .venv 에 그대로 uv 를 실행합니다.

ppp add <pypi name>...        # uv add, in the project root
ppp remove <pypi name>...     # uv remove
ppp sync                      # uv sync
ppp tree [--target <t>...]    # uv tree --python-platform <t>, host by default

Per-package, per-target dependencies패키지별, 타깃별 의존성

A marker typed into the dependency string (numpy; …) is refused; use --target. ppp package sync|tree <pkg> are explicit spellings of the same commands.

의존성 문자열에 직접 쓴 마커 (numpy; …) 는 거부됩니다. --target 을 쓰세요. ppp package sync|tree <pkg> 는 같은 명령의 명시적 형태입니다.

Missing wheels and uv flags없는 휠과 uv 플래그

Whether a wheel exists for a target is only known by trying. When uv fails, the error names the package and the target and says whether only an sdist exists (NoWheelForTargetException).

타깃용 휠이 있는지는 설치해 봐야 압니다. uv 가 실패하면 오류가 패키지와 타깃을 밝히고, sdist 만 있는지 알려 줍니다 (NoWheelForTargetException).

Unknown --flag [value] tokens are passed to uv. --flag=value always carries its value. Written with a space, only --python-version, --only-binary, --python, --index, --default-index, --index-url, --extra-index-url, --find-links, --index-strategy and --resolution take the next token; every other flag is passed bare.

알 수 없는 --flag [value] 는 uv 로 넘어갑니다. --flag=value 형태는 언제나 값을 함께 넘깁니다. 공백으로 쓰면 --python-version, --only-binary, --python, --index, --default-index, --index-url, --extra-index-url, --find-links, --index-strategy, --resolution 만 다음 토큰을 값으로 받고, 나머지는 값 없이 넘어갑니다.