aup-parser 0.1.0

Audacity .aup3 parser with Rust core and Python interface

aup-parser

aup-parser is an Audacity .aup3 parser package with a Rust core and typed Python interface.

Highlights

• Rust core for binary XML and sampleblocks analysis
• Class-based Python API (AUPParser) with TypedDict return types
• Optional audio export helper
• CLI entrypoint: aup-parser

Package Layout

• src/: Rust core (PyO3 extension)
• python/aup_parser/: Python API, types, exports, and CLI
• tests/: API/CLI/parity tests and golden fixtures

Build (local dev)

cd /Users/joonholee/deeply/aup3-parser
python3 -m pip install --user --break-system-packages maturin
python3 -m maturin build --release -i python3
python3 -m pip install --user --break-system-packages --force-reinstall target/wheels/aup_parser-*.whl

Python API (Class-only)

from aup_parser import AUPParser

parser = AUPParser("tests/test.aup3")
essential = parser.parse(profile="essential")
full = parser.parse(profile="full")

AUPParser.parse() signature:

def parse(
    self,
    *,
    profile: Literal["essential", "full"] = "essential",
    audio_output_path: str | pathlib.Path | None = None,
    sample_rate: int = 48000,
) -> ParseResultTD: ...

• audio_output_path: None이 아니면 WAV를 export
  • 싱글 채널 프로젝트: 단일 WAV 파일 출력
  • 멀티 채널 프로젝트: audio_output_path를 폴더로 사용하여 채널별 WAV 파일 생성
  • 멀티 채널 + 파일처럼 보이는 경로(out.wav) 입력 시: 자동으로 out_channels/ 폴더로 정규화
  • 타임라인 복원: clip metadata(offset, trimLeft, trimRight)를 우선 적용하고, 불가능한 경우 waveblock.start 기준으로 배치
  • gap 구간은 zero-fill, 겹침 구간은 later block overwrite 규칙 사용
• sample_rate: audio_output_path export 시 사용할 샘플레이트

CLI

aup-parser tests/test.aup3 --json
aup-parser tests/test.aup3 --full-json --json
aup-parser tests/test.aup3 --json --audio-output-path /tmp/output --sample-rate 48000

Compatibility Notes

• Python 3.11+
• abi3-py311 build strategy
• CI validates install + runtime parse on:
  • Linux (ubuntu-latest)
  • macOS (macos-latest)
  • Windows (windows-latest)
• Release wheels are built for:
  • Linux (ubuntu-latest)
  • Windows (windows-latest)
  • macOS Intel (macos-13)
  • macOS Apple Silicon (macos-14)
• If a wheel is unavailable for your environment, pip falls back to sdist build and requires a Rust toolchain.

Release

GitHub Actions workflow (.github/workflows/release.yml) runs:

1. Matrix tests on PRs
2. Wheel/sdist build on version tags (v*)
3. PyPI publish via trusted publishing