Installation

시스템 요구사항¶

요구사항	세부 정보
Python	≥ 3.8 (CPython), 3.14t free-threaded 포함
플랫폼	Linux, macOS, Windows
빌드	Rust 툴체인 (소스 빌드에만 필요)

PyPI에서 설치¶

패키지는 PyPI에 게시되었습니다. pip로 설치:

PyPI에서 설치

pip install pyrs-yaml

패키지는 ABI3 휠로 빌드되며, 단일 휠로 Python 3.8부터 3.15까지 지원 — 재컴파일 불필요.

소스에서 설치¶

개발용 또는 최신 미출시 변경용:

소스에서 설치

git clone https://github.com/759401524/pyrs-yaml.git
cd pyrs-yaml
uv run --frozen maturin develop --release

프리-스레디드 Python (cp314t)¶

CPython 3.14t용 프리-스레디드(no-GIL) 휠은 NumPy 통합을 포함합니다. 환경에 NumPy가 설치된 경우 safe_dump / from_dict는 numpy.ndarray 값을 정상적으로 직렬화합니다. NumPy가 없는 경우 통합은 비활성화되며 호출은 기본 객체 핸들러로 폴스루됩니다. GIL 빌드(Python 3.8–3.15)에서는 전체 ndarray 직렬화를 지원합니다.

NumPy는 런타임에 자동 감지됩니다

NumPy 통합은 모든 휠(GIL 및 프리-스레디드)에 컴파일되어 있지만, NumPy를 임포트할 수 있을 때만 활성화됩니다. NumPy가 설치되어 있지 않으면 numpy.ndarray에 safe_dump를 호출하면 YamlTypeError가 발생합니다(값이 인식된 타입이 아님).

개발용 설치¶

소스에서 설치 (개발 또는 테스트용):

소스에서 설치

git clone https://github.com/759401524/pyrs-yaml.git
cd pyrs-yaml
uv run --frozen maturin develop --release

설치 확인¶

설치 확인

pyrs_yaml.__version__을 출력하고 간단한 파싱 테스트로 설치를 검증할 수 있습니다.

설치 확인

import pyrs_yaml

# Check version
print(pyrs_yaml.__version__)  # e.g., "0.2.0"

# Quick smoke test
doc = pyrs_yaml.parse("key: value")
assert doc.to_yaml() == "key: value\n"
print("✓ Installation verified")