typed-ffmpeg-compatible 3.2.2__py3-none-any.whl → 3.2.3__py3-none-any.whl

typed_ffmpeg/_version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '3.2.2'
-__version_tuple__ = version_tuple = (3, 2, 2)
+__version__ = version = '3.2.3'
+__version_tuple__ = version_tuple = (3, 2, 3)

typed_ffmpeg/compile/compile_cli.py

@@ -47,11 +47,23 @@ from .validate import validate
 
 
 def get_options_dict() -> dict[str, FFMpegOption]:
+    """
+    Load and index FFmpeg options from the cache.
+
+    Returns:
+        Dictionary mapping option names to their FFMpegOption definitions
+    """
     options = load(list[FFMpegOption], "options")
     return {option.name: option for option in options}
 
 
 def get_filter_dict() -> dict[str, FFMpegFilter]:
+    """
+    Load and index FFmpeg filters from the cache.
+
+    Returns:
+        Dictionary mapping filter names to their FFMpegFilter definitions
+    """
     filters = load(list[FFMpegFilter], "filters")
     return {filter.name: filter for filter in filters}
 
@@ -99,6 +111,24 @@ def parse_options(tokens: list[str]) -> dict[str, list[str | None | bool]]:
 def parse_stream_selector(
     selector: str, mapping: Mapping[str, FilterableStream]
 ) -> FilterableStream:
+    """
+    Parse a stream selector string and return the corresponding stream.
+
+    This function handles FFmpeg's stream selector syntax:
+    - Simple selectors: "[0]" (first input)
+    - Type selectors: "[0:v]" (first input, video stream)
+    - Index selectors: "[0:v:0]" (first input, first video stream)
+
+    Args:
+        selector: Stream selector string to parse
+        mapping: Dictionary of available streams
+
+    Returns:
+        The selected FilterableStream
+
+    Raises:
+        AssertionError: If the stream label is not found in the mapping
+    """
     selector = selector.strip("[]")
 
     if ":" in selector:
@@ -126,19 +156,48 @@ def parse_stream_selector(
         return stream
 
 
+def _is_filename(token: str) -> bool:
+    """
+    Check if a token is a filename.
+
+    Args:
+        token: The token to check
+
+    Returns:
+        True if the token is a filename, False otherwise
+    """
+    # not start with - and has ext
+    return not token.startswith("-") and len(token.split(".")) > 1
+
+
 def parse_output(
     source: list[str],
     in_streams: Mapping[str, FilterableStream],
     ffmpeg_options: dict[str, FFMpegOption],
 ) -> list[OutputStream]:
+    """
+    Parse output file specifications and their options.
+
+    This function processes the output portion of an FFmpeg command line,
+    handling output file paths, stream mapping, and output-specific options.
+
+    Args:
+        source: List of command-line tokens for output specifications
+        in_streams: Dictionary of available input streams
+        ffmpeg_options: Dictionary of valid FFmpeg options
+
+    Returns:
+        List of OutputStream objects representing the output specifications
+    """
     tokens = source.copy()
 
     export: list[OutputStream] = []
-
     buffer: list[str] = []
+
     while tokens:
         token = tokens.pop(0)
-        if token.startswith("-") or len(buffer) % 2 == 1:
+
+        if not _is_filename(token):
             buffer.append(token)
             continue
 
@@ -161,8 +220,21 @@ def parse_output(
                     if isinstance(in_streams[k], AVStream)
                 ]
 
-        assert inputs, f"No inputs found for output {filename}"
-        export.append(output(*inputs, filename=filename, extra_options=options))
+        parameters: dict[str, str | bool] = {}
+
+        for key, value in options.items():
+            key_base = key.split(":")[0]
+            if key_base in ffmpeg_options:
+                option = ffmpeg_options[key_base]
+
+                if option.is_output_option:
+                    # just ignore not input options
+                    if value[-1] is None:
+                        parameters[key] = True
+                    else:
+                        parameters[key] = value[-1]
+
+        export.append(output(*inputs, filename=filename, extra_options=parameters))
         buffer = []
 
     return export
@@ -171,6 +243,19 @@ def parse_output(
 def parse_input(
     tokens: list[str], ffmpeg_options: dict[str, FFMpegOption]
 ) -> dict[str, FilterableStream]:
+    """
+    Parse input file specifications and their options.
+
+    This function processes the input portion of an FFmpeg command line,
+    handling input file paths and input-specific options.
+
+    Args:
+        tokens: List of command-line tokens for input specifications
+        ffmpeg_options: Dictionary of valid FFmpeg options
+
+    Returns:
+        Dictionary mapping input indices to their FilterableStream objects
+    """
     output: list[AVStream] = []
 
     while "-i" in tokens:
@@ -184,15 +269,15 @@ def parse_input(
         parameters: dict[str, str | bool] = {}
 
         for key, value in options.items():
-            assert key in ffmpeg_options, f"Unknown option: {key}"
-            option = ffmpeg_options[key]
+            if key in ffmpeg_options:
+                option = ffmpeg_options[key]
 
-            if option.is_input_option:
-                # just ignore not input options
-                if value[-1] is None:
-                    parameters[key] = True
-                else:
-                    parameters[key] = value[-1]
+                if option.is_input_option:
+                    # just ignore not input options
+                    if value[-1] is None:
+                        parameters[key] = True
+                    else:
+                        parameters[key] = value[-1]
 
         output.append(input(filename=filename, extra_options=parameters))
 
@@ -322,19 +407,42 @@ def parse_global(
     parameters: dict[str, str | bool] = {}
 
     for key, value in options.items():
-        assert key in ffmpeg_options, f"Unknown option: {key}"
-        option = ffmpeg_options[key]
+        if key in ffmpeg_options:
+            option = ffmpeg_options[key]
 
-        if option.is_global_option:
-            # Process only recognized global options
-            if value[-1] is None:
-                parameters[key] = True
-            else:
-                parameters[key] = value[-1]
+            if option.is_global_option:
+                # Process only recognized global options
+                if value[-1] is None:
+                    parameters[key] = True
+                else:
+                    parameters[key] = value[-1]
     return parameters, remaining_tokens
 
 
 def parse(cli: str) -> Stream:
+    """
+    Parse a complete FFmpeg command line into a Stream object.
+
+    This function takes a full FFmpeg command line string and converts it into
+    a Stream object representing the filter graph. It handles all components:
+    - Global options
+    - Input files and their options
+    - Filter complex
+    - Output files and their options
+
+    Args:
+        cli: Complete FFmpeg command line string
+
+    Returns:
+        Stream object representing the parsed command line
+
+    Example:
+        ```python
+        stream = parse(
+            "ffmpeg -i input.mp4 -filter_complex '[0:v]scale=1280:720[v]' -map '[v]' output.mp4"
+        )
+        ```
+    """
     # ffmpeg [global_options] {[input_file_options] -i input_url} ... {[output_file_options] output_url} ...
     ffmpeg_options = get_options_dict()
     ffmpeg_filters = get_filter_dict()

{typed_ffmpeg_compatible-3.2.2.dist-info → typed_ffmpeg_compatible-3.2.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: typed-ffmpeg-compatible
-Version: 3.2.2
+Version: 3.2.3
 Summary: Modern Python FFmpeg wrappers offer comprehensive support for complex filters, complete with detailed typing and documentation.
 Author-email: lucemia <lucemia@gmail.com>
 License-Expression: MIT

{typed_ffmpeg_compatible-3.2.2.dist-info → typed_ffmpeg_compatible-3.2.3.dist-info}/RECORD

@@ -1,5 +1,5 @@
 typed_ffmpeg/__init__.py,sha256=n1SZfENc9xhZ0eA3ZzkBNPuIY-Pt3-rOwB8-uUj5olU,1592
-typed_ffmpeg/_version.py,sha256=VfQFwh2Vyb8ry8WT1y6VfXFKIN0E2GC1aed16irkCFQ,511
+typed_ffmpeg/_version.py,sha256=P9n86yqDQj4uxDqvcIKGlJWsA9YZ7G1BSuEXNqVACeI,511
 typed_ffmpeg/base.py,sha256=C5Tqbx2I0c-09D7aXKZoGkspu-lAAeAhuOns5zr3PXQ,6304
 typed_ffmpeg/exceptions.py,sha256=D4SID6WOwkjVV8O8mAjrEDHWn-8BRDnK_jteaDof1SY,2474
 typed_ffmpeg/filters.py,sha256=_lBpGZgPHK3KgGVrw-TCdQEsBRuEXVIgwggYNGd80MU,110076
@@ -13,7 +13,7 @@ typed_ffmpeg/common/cache.py,sha256=j0JvfX7jewLpdJWxgo7Pwze0BkUJdYGHX2uGR8BZ-9M,
 typed_ffmpeg/common/schema.py,sha256=qM8yfMX9UU3EAQSNsTrr-SAmyqKx8eQCXTtu3RJWkEk,19673
 typed_ffmpeg/common/serialize.py,sha256=dLim0DBP5CdJ1JiMV9xEmmh1XMSIhBOWs61EopAL15s,7719
 typed_ffmpeg/compile/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-typed_ffmpeg/compile/compile_cli.py,sha256=nLrTV5nuC1ETff8C7_ZgZDKPtvXJoQfZsAbm_oq1WA8,28397
+typed_ffmpeg/compile/compile_cli.py,sha256=--2j1QPPOB2pEQzqFM4VpINokbJilcegtRqTRF2_Jfg,31588
 typed_ffmpeg/compile/compile_json.py,sha256=YCiTyfAnUVSbFr7BiQpmJYs13K5sa-xo77Iih33mb6I,992
 typed_ffmpeg/compile/compile_python.py,sha256=oo4e8Ldwk0OkrZtHucfuGR5JDFF8xY8omNKPMDyUpQ8,11506
 typed_ffmpeg/compile/context.py,sha256=macQ3HhEJ73j_WbWYtU9GCQCzcB_KQGAPimcuU-WOac,10946
@@ -50,9 +50,9 @@ typed_ffmpeg/utils/view.py,sha256=QCSlQoQkRBI-T0sWjiywGgM9DlKd8Te3CB2ZYX-pEVU,34
 typed_ffmpeg/utils/lazy_eval/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 typed_ffmpeg/utils/lazy_eval/operator.py,sha256=QWybd-UH3VdDa8kgWkqAMi3WV0b0WF1d1JixQr6is2E,4136
 typed_ffmpeg/utils/lazy_eval/schema.py,sha256=WSg-E3MS3itN1AT6Dq4Z9btnRHEReuN3o6zruXou7h4,9623
-typed_ffmpeg_compatible-3.2.2.dist-info/licenses/LICENSE,sha256=8Aaya5i_09Cou2i3QMxTwz6uHGzi_fGA4uhkco07-A4,1066
-typed_ffmpeg_compatible-3.2.2.dist-info/METADATA,sha256=eJv1JAMT41NxhuCYDvTZOBNyU5n2XoiFfyDTVtohI28,8385
-typed_ffmpeg_compatible-3.2.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-typed_ffmpeg_compatible-3.2.2.dist-info/entry_points.txt,sha256=kUQvZ27paV-07qtkIFV-emKsYtjFOTw9kknBRSXPs04,45
-typed_ffmpeg_compatible-3.2.2.dist-info/top_level.txt,sha256=vuASJGVRQiNmhWY1pt0RXESWSNkknWXqWLIRAU7H_L4,13
-typed_ffmpeg_compatible-3.2.2.dist-info/RECORD,,
+typed_ffmpeg_compatible-3.2.3.dist-info/licenses/LICENSE,sha256=8Aaya5i_09Cou2i3QMxTwz6uHGzi_fGA4uhkco07-A4,1066
+typed_ffmpeg_compatible-3.2.3.dist-info/METADATA,sha256=HwRj91ZONWRkUUACimtXw8TNwhZveMe358-cYoBYaUU,8385
+typed_ffmpeg_compatible-3.2.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+typed_ffmpeg_compatible-3.2.3.dist-info/entry_points.txt,sha256=kUQvZ27paV-07qtkIFV-emKsYtjFOTw9kknBRSXPs04,45
+typed_ffmpeg_compatible-3.2.3.dist-info/top_level.txt,sha256=vuASJGVRQiNmhWY1pt0RXESWSNkknWXqWLIRAU7H_L4,13
+typed_ffmpeg_compatible-3.2.3.dist-info/RECORD,,