"""Where the practice media is on disk. The practices' pictures, course data and recordings live in the practices package (https://github.com/waozixyz/practices), pinned in ziran.lock and linked at build/packages/practices. Packages keep their resources under assets/practices/, so a packaged path such as assets/practices/taichi/course.tch names MEDIA / 'taichi/course.tch'. """ import os from pathlib import Path ROOT = Path(__file__).resolve().parents[1] MEDIA = ROOT / 'build/packages/practices' PREFIX = 'assets/practices/' def media_path(path): """The file on disk for a packaged path, or for a path in the project.""" path = str(path) if path.startswith(PREFIX): return MEDIA / path[len(PREFIX):] return ROOT / path def narration_text_path(config, code, default_directory): """Resolve the configured voice's locale text, retaining other defaults.""" selected = config.get('locale_text_files', {}).get(code) if selected is not None: return media_path(selected) return Path(default_directory) / (code + '.txt') def packaged_path(file, media_root=None): """The packaged path of a file in the practice media.""" root = Path(media_root).resolve() if media_root is not None else MEDIA.resolve() return PREFIX + Path(file).resolve().relative_to(root).as_posix() def writable_media(): """The media checkout generators may write into: a working repository mapped in ziran.local.toml, never the locked package cache.""" cache = Path(os.environ.get('XDG_CACHE_HOME') or Path.home() / '.cache') / 'ziran' if not MEDIA.is_dir() or MEDIA.resolve().is_relative_to(cache.resolve()): raise SystemExit(f'{MEDIA} is the locked package; map practices to your ' 'practices checkout in ziran.local.toml to change its media') return MEDIA