parse-avidemux-project 0.1.0__py3-none-any.whl

parse_avidemux_project/__init__.py

@@ -0,0 +1,11 @@
+from .models import AudioTrack, AvidemuxProject, Segment
+from .parser import parse_project, parse_project_file, us_to_iso_time
+
+__all__ = [
+    "AudioTrack",
+    "AvidemuxProject",
+    "Segment",
+    "parse_project",
+    "parse_project_file",
+    "us_to_iso_time",
+]

parse_avidemux_project/cli.py

@@ -0,0 +1,38 @@
+import argparse
+import json
+import sys
+
+from . import parse_project_file
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Parse an Avidemux TinyPY project file to JSON."
+    )
+    parser.add_argument("input", help="Path to the Avidemux project file (.py)")
+    parser.add_argument(
+        "-o", "--output",
+        help="Path to write JSON output (default: stdout)",
+    )
+    args = parser.parse_args()
+
+    try:
+        project = parse_project_file(args.input)
+    except FileNotFoundError as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+    except ValueError as e:
+        print(f"Parse error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    output = json.dumps(project.to_dict(), indent=4)
+
+    if args.output:
+        with open(args.output, "w", encoding="utf-8") as f:
+            f.write(output)
+    else:
+        print(output)
+
+
+if __name__ == "__main__":
+    main()

parse_avidemux_project/models.py

@@ -0,0 +1,44 @@
+from dataclasses import dataclass, field, asdict
+
+
+@dataclass
+class Segment:
+    start: int
+    duration: int
+
+    @property
+    def end(self) -> int:
+        return self.start + self.duration
+
+
+@dataclass
+class AudioTrack:
+    index: int
+    language: str | None = None
+    codec: str | None = None
+
+
+@dataclass
+class AvidemuxProject:
+    video_file: str | None = None
+    segments: list[Segment] = field(default_factory=list)
+    marker_a: int | None = None
+    marker_b: int | None = None
+    video_codec: str | None = None
+    container: str | None = None
+    container_options: dict[str, str] = field(default_factory=dict)
+    audio_tracks: list[AudioTrack] = field(default_factory=list)
+    hdr_config: tuple[int, ...] = field(default_factory=tuple)
+
+    def to_dict(self) -> dict:
+        return {
+            "video_file": self.video_file,
+            "segments": [asdict(s) | {"end": s.end} for s in self.segments],
+            "marker_a": self.marker_a,
+            "marker_b": self.marker_b,
+            "video_codec": self.video_codec,
+            "container": self.container,
+            "container_options": self.container_options,
+            "audio_tracks": [asdict(t) for t in self.audio_tracks],
+            "hdr_config": list(self.hdr_config),
+        }

parse_avidemux_project/parser.py

@@ -0,0 +1,163 @@
+import re
+
+from .models import AudioTrack, AvidemuxProject, Segment
+
+
+def parse_project(content: str) -> AvidemuxProject:
+    """
+    Parse an Avidemux TinyPY script into a structured AvidemuxProject object.
+
+    Parameters:
+    content (str): The full text of an Avidemux TinyPY project file.
+
+    Returns:
+    AvidemuxProject: Structured representation of the project.
+
+    Raises:
+    ValueError: If the content cannot be parsed as a valid Avidemux project.
+    """
+    video_file = _parse_video_file(content)
+    segments = _parse_segments(content)
+
+    if video_file is None and not segments:
+        raise ValueError("No Avidemux project data found in content")
+
+    return AvidemuxProject(
+        video_file=video_file,
+        segments=segments,
+        marker_a=_parse_marker(content, "A"),
+        marker_b=_parse_marker(content, "B"),
+        video_codec=_parse_video_codec(content),
+        container=_parse_container(content),
+        container_options=_parse_container_options(content),
+        audio_tracks=_parse_audio_tracks(content),
+        hdr_config=_parse_hdr_config(content),
+    )
+
+
+def parse_project_file(path: str) -> AvidemuxProject:
+    """
+    Read and parse an Avidemux TinyPY project file.
+
+    Parameters:
+    path (str): Filesystem path to a TinyPY project file.
+
+    Returns:
+    AvidemuxProject: Structured representation of the project.
+    """
+    with open(path, encoding="utf-8") as f:
+        return parse_project(f.read())
+
+
+def us_to_iso_time(us: int) -> str:
+    """
+    Convert microseconds to the format HH:MM:SS.mmm.
+
+    Parameters:
+    us (int): Microseconds to convert.
+
+    Returns:
+    str: Formatted time string.
+    """
+    ms = int(us) // 1000
+    hours = ms // 3600000
+    minutes = (ms % 3600000) // 60000
+    seconds = (ms % 60000) // 1000
+    milliseconds = ms % 1000
+    return f"{hours:02}:{minutes:02}:{seconds:02}.{milliseconds:03}"
+
+
+_PATTERN_VIDEO = re.compile(
+    r"adm = Avidemux\(\)\s*\n"
+    r'if not adm\.loadVideo\("(.+?)"\):\s*raise'
+)
+
+_PATTERN_SEGMENT = re.compile(r"adm\.addSegment\(0, (\d+), (\d+)\)")
+
+_PATTERN_MARKER = re.compile(r"adm\.marker([AB])\s*=\s*(\d+)")
+
+_PATTERN_VIDEO_CODEC = re.compile(r'adm\.videoCodec\("(.+?)"\)')
+
+_PATTERN_CONTAINER = re.compile(r"adm\.setContainer\(([^)]+)\)")
+
+_PATTERN_HDR_CONFIG = re.compile(r"adm\.setHDRConfig\(([^)]+)\)")
+
+_PATTERN_SOURCE_LANG = re.compile(r'adm\.setSourceTrackLanguage\((\d+),"(.+?)"\)')
+
+_PATTERN_AUDIO_ADD = re.compile(r"adm\.audioAddTrack\((\d+)\)")
+
+_PATTERN_AUDIO_CODEC = re.compile(r'adm\.audioCodec\((\d+), "(.+?)"\)')
+
+
+def _parse_video_file(content: str) -> str | None:
+    match = _PATTERN_VIDEO.search(content)
+    return match.group(1) if match else None
+
+
+def _parse_segments(content: str) -> list[Segment]:
+    matches = _PATTERN_SEGMENT.findall(content)
+    return [Segment(start=int(start), duration=int(duration)) for start, duration in matches]
+
+
+def _parse_marker(content: str, marker: str) -> int | None:
+    for m, val in _PATTERN_MARKER.findall(content):
+        if m == marker:
+            return int(val)
+    return None
+
+
+def _parse_video_codec(content: str) -> str | None:
+    match = _PATTERN_VIDEO_CODEC.search(content)
+    return match.group(1) if match else None
+
+
+def _parse_container(content: str) -> str | None:
+    match = _PATTERN_CONTAINER.search(content)
+    if not match:
+        return None
+    parts = re.findall(r'"([^"]*)"', match.group(1))
+    return parts[0] if parts else None
+
+
+def _parse_container_options(content: str) -> dict[str, str]:
+    match = _PATTERN_CONTAINER.search(content)
+    if not match:
+        return {}
+    parts = re.findall(r'"([^"]*)"', match.group(1))
+    options = {}
+    for part in parts[1:]:
+        if "=" in part:
+            key, value = part.split("=", 1)
+            options[key] = value
+    return options
+
+
+def _parse_hdr_config(content: str) -> tuple[int, ...]:
+    match = _PATTERN_HDR_CONFIG.search(content)
+    if not match:
+        return ()
+    return tuple(int(x.strip()) for x in match.group(1).split(","))
+
+
+def _parse_audio_tracks(content: str) -> list[AudioTrack]:
+    source_languages = {
+        int(index): lang
+        for index, lang in _PATTERN_SOURCE_LANG.findall(content)
+    }
+    codecs = {
+        int(index): codec
+        for index, codec in _PATTERN_AUDIO_CODEC.findall(content)
+    }
+    track_indices = sorted({
+        int(index)
+        for index in _PATTERN_AUDIO_ADD.findall(content)
+    }.union(codecs.keys()))
+
+    tracks = []
+    for idx in track_indices:
+        tracks.append(AudioTrack(
+            index=idx,
+            language=source_languages.get(idx),
+            codec=codecs.get(idx),
+        ))
+    return tracks

parse_avidemux_project-0.1.0.dist-info/METADATA

@@ -0,0 +1,85 @@
+Metadata-Version: 2.4
+Name: parse-avidemux-project
+Version: 0.1.0
+Summary: Parser for Avidemux TinyPY project scripts
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ferrous-lux/parse_avidemux_project
+Project-URL: Source, https://github.com/ferrous-lux/parse_avidemux_project
+Project-URL: BugTracker, https://github.com/ferrous-lux/parse_avidemux_project/issues
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Dynamic: license-file
+
+# parse-avidemux-project
+
+Standalone Python library for parsing [Avidemux](https://avidemux.sourceforge.net/) TinyPY project scripts into structured data (video path, segments, filters, audio tracks, etc.). No ffmpeg, ccextractor, or Avidemux CLI required.
+
+## Installation
+
+```bash
+pip install parse-avidemux-project
+```
+
+## CLI Usage
+
+```bash
+parse-avidemux-project input.py -o output.json
+```
+
+Omitting `-o` prints the JSON to stdout.
+
+## Python API
+
+```python
+from parse_avidemux_project import (
+    AvidemuxProject,
+    Segment,
+    AudioTrack,
+    parse_project,
+    parse_project_file,
+    us_to_iso_time,
+)
+
+# Parse a file
+project: AvidemuxProject = parse_project_file("project.py")
+
+# Or parse a string
+project = parse_project('''
+    adm = Avidemux()
+    if not adm.loadVideo("/path/to/video.mkv"):
+        raise
+    adm.addSegment(0, 1000000, 5000000)
+    adm.markerA = 0
+    adm.markerB = 6000000
+''')
+
+print(project.video_file)       # /path/to/video.mkv
+print(project.segments)         # [Segment(start=1000000, duration=5000000)]
+print(project.segments[0].end)  # 6000000 (computed property)
+
+# Convert to dict for JSON serialization
+print(project.to_dict())
+
+# Microsecond to ISO time conversion
+print(us_to_iso_time(3661000000))  # 01:01:01.000
+```
+
+### Data model
+
+| Attribute | Type | Description |
+|---|---|---|
+| `video_file` | `str \| None` | Path to the source video |
+| `segments` | `list[Segment]` | List of cut segments (each has `start`, `duration`, and `end` property) |
+| `marker_a`, `marker_b` | `int \| None` | A/B markers in microseconds |
+| `video_codec` | `str \| None` | Output video codec |
+| `container` | `str \| None` | Output container format |
+| `container_options` | `dict[str, str]` | Container options |
+| `audio_tracks` | `list[AudioTrack]` | Audio track configs (each has `index`, `language`, `codec`) |
+| `hdr_config` | `tuple[int, ...]` | HDR parameters |
+
+## License
+
+MIT

parse_avidemux_project-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+parse_avidemux_project/__init__.py,sha256=HjRpiN_FU_1LWKVCfTBlR9R9qDjl6FyNO8yJfMGBAU8,267
+parse_avidemux_project/cli.py,sha256=EeoL5OuIjkscFJI_HW6aWHmVlGXWL3FHer68M3TYPZM,924
+parse_avidemux_project/models.py,sha256=MvEVIUjuXDNu5eoxF0C1eX3m6tUVGz0E_CQWoEbJ1B4,1273
+parse_avidemux_project/parser.py,sha256=e65eRAO-UOJKGd9S49OY50b-Al17mWw_HFhJNWG6v18,4678
+parse_avidemux_project-0.1.0.dist-info/licenses/LICENSE,sha256=6kDns8-hV9Ad7UFJpzgNy7trIwxIXnigztgbaN2jVAo,1069
+parse_avidemux_project-0.1.0.dist-info/METADATA,sha256=-OOha-ZRFA_LxSVuiPuNYnDOBTd0oT0W_--e-WSVxpw,2472
+parse_avidemux_project-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+parse_avidemux_project-0.1.0.dist-info/entry_points.txt,sha256=v8MHhnCteas_G6ttVEWcI8o4pdARaRkNAe_R8twcbgs,75
+parse_avidemux_project-0.1.0.dist-info/top_level.txt,sha256=zl4Hhp2LHojYm-TYykTSDgMQzTRUjHth7_wj3uz3Wx0,23
+parse_avidemux_project-0.1.0.dist-info/RECORD,,

parse_avidemux_project-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

parse_avidemux_project-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+parse-avidemux-project = parse_avidemux_project.cli:main

parse_avidemux_project-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ferris Luxor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

parse_avidemux_project-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+parse_avidemux_project