python-rust-binding

이 레포는 Rust로 작성한 Python 확장 모듈(netcheck)을 maturin으로 빌드하고, 별도의 Python 앱(py-project)에서 사용하는 예시 프로젝트입니다.

구성

python-rust-binding/
├─ netcheck/        # Rust ↔ Python 바인딩 라이브러리 (PyO3 + maturin)
├─ py-project/      # 라이브러리를 사용하는 Python 앱 (uv로 의존성 관리)
└─ python-rust-binding.code-workspace

요구 사항

• Rust (rustup)
• Python 3.12+
• maturin
• uv (선택, py-project에서 의존성 관리용)

빠른 시작

1) Rust 라이브러리 개발 설치(Editable)

py-project는 로컬 netcheck를 소스 의존성으로 사용합니다. 루트에서:

cd py-project
uv sync

• py-project/pyproject.toml의 [tool.uv.sources] 설정으로 ../netcheck가 editable로 연결됩니다.
• uv를 쓰지 않는다면 pip로도 가능합니다:

pip install -e ../netcheck

2) Python 앱 실행

cd py-project
uv run python main.py

또는 가상환경에서:

python -m venv .venv
source .venv/bin/activate
pip install -e ../netcheck
python main.py

개발 흐름

1. netcheck에서 Rust 코드를 수정
2. py-project에서 스크립트 실행 → 확장 모듈이 자동 리빌드되어 반영(Editable)
3. 필요 시 netcheck에서 wheel 빌드

cd netcheck
maturin build --release  # target/wheels/*.whl 생성

문제 해결

• macOS에서 arm64 타겟로 빌드된 wheel을 사용 중이라면 Python/가상환경도 동일 아키텍처인지 확인하세요.
• uv sync 오류 시 py-project/pyproject.toml의 [tool.uv.sources] 경로가 올바른지 확인하세요.
• 심볼 로드 오류 발생 시, 이전에 설치된 오래된 wheel이 남아있을 수 있습니다. pip uninstall netcheck 후 재설치하세요.