typed-ffmpeg-compatible 2.6.2__py3-none-any.whl → 2.6.4__py3-none-any.whl

typed_ffmpeg/utils/view.py

@@ -1,3 +1,11 @@
+"""
+Visualization utilities for FFmpeg filter graphs.
+
+This module provides functionality to generate visual representations of
+FFmpeg filter graphs using Graphviz. These visualizations can be useful for
+understanding complex filter chains, debugging, and documentation purposes.
+"""
+
 from __future__ import annotations
 
 from typing import Literal
@@ -8,6 +16,22 @@ from ..dag.schema import Node
 
 
 def _get_node_color(node: Node) -> str | None:
+    """
+    Determine the appropriate color for a node in the graph visualization.
+
+    This internal helper function assigns specific colors to different types of nodes
+    to enhance visual differentiation in the rendered graph:
+    - Input nodes: green (#99cc00)
+    - Output nodes: blue (#99ccff)
+    - Filter nodes: yellow (#ffcc00)
+    - Other nodes: no specific color (None)
+
+    Args:
+        node: The node to assign a color to
+
+    Returns:
+        A hex color string or None if no specific color is assigned
+    """
     if isinstance(node, InputNode):
         color = "#99cc00"
     elif isinstance(node, OutputNode):
@@ -21,14 +45,32 @@ def _get_node_color(node: Node) -> str | None:
 
 def view(node: Node, format: Literal["png", "svg", "dot"]) -> str:
     """
-    Visualize the graph via graphviz.
+    Visualize a filter graph node and its dependencies using Graphviz.
+
+    This function creates a graphical representation of the FFmpeg filter graph
+    starting from the given node. It traverses the entire graph and generates
+    a visual diagram showing all nodes and their connections. The visualization
+    uses different colors to distinguish between input, output, and filter nodes.
 
     Args:
-        node: The node to visualize.
-        format: The format to render the graph in.
+        node: The root node to visualize (typically an output node)
+        format: The output format for the visualization (png, svg, or dot)
 
     Returns:
-        The path to the rendered graph.
+        The path to the rendered graph file
+
+    Raises:
+        ImportError: If the graphviz package is not installed
+
+    Example:
+        ```python
+        # Create a filter graph and visualize it
+        output = (
+            ffmpeg.input("input.mp4").filter("scale", 1280, 720).output("output.mp4")
+        )
+        graph_path = ffmpeg.utils.view(output, format="png")
+        print(f"Graph visualization saved to {graph_path}")
+        ```
     """
 
     try:

{typed_ffmpeg_compatible-2.6.2.dist-info → typed_ffmpeg_compatible-2.6.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: typed-ffmpeg-compatible
-Version: 2.6.2
+Version: 2.6.4
 Summary: Modern Python FFmpeg wrappers offer comprehensive support for complex filters, complete with detailed typing and documentation.
 Home-page: https://livingbio.github.io/typed-ffmpeg/
 License: MIT

typed_ffmpeg_compatible-2.6.4.dist-info/RECORD

@@ -0,0 +1,48 @@
+typed_ffmpeg/__init__.py,sha256=NL_jH6nUb5pF8pMt3S51243qBTUvZdN-9sJpeuiznRE,1532
+typed_ffmpeg/base.py,sha256=C5Tqbx2I0c-09D7aXKZoGkspu-lAAeAhuOns5zr3PXQ,6304
+typed_ffmpeg/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+typed_ffmpeg/common/schema.py,sha256=NSr1GnREvAhdshlBigRSUu12NTleOwhspJrbVCpGgNo,19468
+typed_ffmpeg/common/serialize.py,sha256=Be0SgrsfD76kWZYT1IKFKQItuOgGLYWJITjDXGvbzcs,7687
+typed_ffmpeg/dag/__init__.py,sha256=qAApSNqjbZ1DtUaV5bSku9RwG7MpMPa1HJO764cSBt4,849
+typed_ffmpeg/dag/compile.py,sha256=GXMTFE1vqRDI-nuIZPtJwXQhCc61uCIGh5u4OBRp8gg,3129
+typed_ffmpeg/dag/context.py,sha256=pv77lltW6yk-PRYlZ0MC6FICVxYLuyxQAS9Vx5vko0s,11691
+typed_ffmpeg/dag/factory.py,sha256=7iRB2Inth97wxvklI-MoL_47Cl7rZOogNj10qM7wUTs,2600
+typed_ffmpeg/dag/global_runnable/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+typed_ffmpeg/dag/global_runnable/global_args.py,sha256=ehLtx4v-XxqkmODhpE_gik0r79hs4Sa8TJnRsH9Fj1o,8043
+typed_ffmpeg/dag/global_runnable/runnable.py,sha256=wvfvojrLFvu-Vz0N2AIXbla2kptwcu0Dba4TfKYOH3I,11041
+typed_ffmpeg/dag/io/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+typed_ffmpeg/dag/io/_input.py,sha256=KRLTSQPEfmgPcPEAJdeWRHZhNsClaJCB9Ac6czMOrmE,7214
+typed_ffmpeg/dag/io/_output.py,sha256=_no6ffAOABznbLNTki8CYr7pvr4Sa0LweRfn38-cszs,12470
+typed_ffmpeg/dag/io/output_args.py,sha256=SThIhZh9PXs2m6Fz5JsSy8oS-Te7GM_oz7HRuZo0-eI,13901
+typed_ffmpeg/dag/nodes.py,sha256=yJcFjN85aFbk_4SKI7pbe-JkTSUJbfrpSXpqYiGbWGs,29133
+typed_ffmpeg/dag/schema.py,sha256=gKW1eMMiVHvsbFnw4jlh22QhnSDgk_AJCBWvlF73ZZs,6040
+typed_ffmpeg/dag/utils.py,sha256=hydh7_kjpOCw8WEGhXMxIXR4Ek-3DeoOt6esInuK2Xw,1941
+typed_ffmpeg/dag/validate.py,sha256=tWswVibP_BFNOiWX0LgnfMrg3TBm7QIt060Ofd9ychE,9569
+typed_ffmpeg/exceptions.py,sha256=D4SID6WOwkjVV8O8mAjrEDHWn-8BRDnK_jteaDof1SY,2474
+typed_ffmpeg/filters.py,sha256=_lBpGZgPHK3KgGVrw-TCdQEsBRuEXVIgwggYNGd80MU,110076
+typed_ffmpeg/info.py,sha256=0KCzf8hJaI6ObPRT0uftLa96RlYvaQmoEq1sqFJSc24,9521
+typed_ffmpeg/probe.py,sha256=ABfM0ZfDNwBHpPfhu2hpx61_oXb8zdhD9oofwSEcODg,2588
+typed_ffmpeg/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+typed_ffmpeg/schema.py,sha256=KVtmyGeJutjFot70r6Nj8W8WBqwvfg2-rSgjdhPVh-o,1615
+typed_ffmpeg/sources.py,sha256=ASt0l8FMW82X-70qw72167xpyBY7tQQClVuhy8r0HfU,86026
+typed_ffmpeg/streams/__init__.py,sha256=Nt9uWpcVI1sQLl5Qt_kBCBcWOGZA1vczCQ0qvFbSko0,141
+typed_ffmpeg/streams/audio.py,sha256=2oNRhb5UetWtlPG3NW73AjUZoFPl303yMv-6W1sGWt0,259054
+typed_ffmpeg/streams/av.py,sha256=SWcy8Q9hk36ZZJ4WosG08NR-r1f2IzOgZ4tsAZ7nX18,544
+typed_ffmpeg/streams/channel_layout.py,sha256=hGagaoc1tnWS8K1yiITp4f_92qq5e7C_zB15bHOL0DI,1162
+typed_ffmpeg/streams/video.py,sha256=cQwHfew75YO_dbZjmpUYd-nXt1JHN0M7suFKKe5UH5s,453576
+typed_ffmpeg/types.py,sha256=ly3zLtg7KxRa_jsDDrFPAxRZRjTQdWVpiQzOD9NdrFM,4137
+typed_ffmpeg/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+typed_ffmpeg/utils/escaping.py,sha256=m6CTEBwWZTFdtZHTHW-3pQCgkpdZb9f9ynoO-gsD7uM,2937
+typed_ffmpeg/utils/forzendict.py,sha256=9QWdPQA2AbSfiC9-mrq1YeZFl1qN--zw8WlsqQ2ulCk,3114
+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/utils/run.py,sha256=mSoAdcvD-InldqkRgWNc8iXKgJJoEMAOE4PL2gVmtqw,2178
+typed_ffmpeg/utils/snapshot.py,sha256=mKILRm6qiQV2egaD-70MSUEl-DFoLD5w_v9GZIequI4,2181
+typed_ffmpeg/utils/typing.py,sha256=DBQn_gCF8C_DTwsfMHeCgfnNUROwAjlIcHrQ7lNDOoE,1187
+typed_ffmpeg/utils/view.py,sha256=4DJmyGIkUeE6-V0azudDCWm608mRdeRhTZHMgnew9Kw,3409
+typed_ffmpeg_compatible-2.6.4.dist-info/LICENSE,sha256=8Aaya5i_09Cou2i3QMxTwz6uHGzi_fGA4uhkco07-A4,1066
+typed_ffmpeg_compatible-2.6.4.dist-info/METADATA,sha256=AB_nBB0d5PwrLzSZ29cy_Xc01YKTAM8tWj9X8BEnIJs,7249
+typed_ffmpeg_compatible-2.6.4.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+typed_ffmpeg_compatible-2.6.4.dist-info/entry_points.txt,sha256=KfZmNsM16GT_lF1otASIN6E3i6xXHXoB1gMeEdlptjA,44
+typed_ffmpeg_compatible-2.6.4.dist-info/RECORD,,

typed_ffmpeg_compatible-2.6.2.dist-info/RECORD

@@ -1,46 +0,0 @@
-typed_ffmpeg/__init__.py,sha256=122K8EWO5F-1re6YjI_VrTo8tlGGkNbT9Dqlppt5bUI,711
-typed_ffmpeg/base.py,sha256=77X6z6GPMYyYkJqzYUHJKqPeToQ0ZsA8TQMVXCm7dDA,3248
-typed_ffmpeg/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-typed_ffmpeg/common/schema.py,sha256=tGgb13tfiHOEXpOEmjlh92Gg8o4G4b9bzFgiTpupGO8,9724
-typed_ffmpeg/common/serialize.py,sha256=J-NuMzPoy_qDl9UStVeMnjYVLK-QOUjz5cz4xStPIc4,3471
-typed_ffmpeg/dag/__init__.py,sha256=RXOgd2Gx0w0bzvnqX9TpFpi5SbTtgh0DQAmCZnYMx_o,315
-typed_ffmpeg/dag/compile.py,sha256=891eELZB_LeD6RSwRYFjBrcQmd7uvfFiOaQyp5LCUwU,1565
-typed_ffmpeg/dag/context.py,sha256=a0UWq1yMBznCTapO_FHlelHVdzBGf2juUKoSRKN0jUI,5863
-typed_ffmpeg/dag/factory.py,sha256=KT50pifjKUXymDM8DvAE1OJYRBahoAmRQ-VGD0L7irA,1561
-typed_ffmpeg/dag/global_runnable/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-typed_ffmpeg/dag/global_runnable/global_args.py,sha256=YvYEp7gYquzRhhbBHptq7hq3r210VZtyTZNECIWd0Vc,7571
-typed_ffmpeg/dag/global_runnable/runnable.py,sha256=PW36CSlwSqKuIPOVD4XfRb9hhwsAdv4wFMNxq8Da83U,5371
-typed_ffmpeg/dag/io/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-typed_ffmpeg/dag/io/_input.py,sha256=O4YJ253W75Ez9lHb1oNCyqt5HmHcAsCIqdN8jZKijmc,7176
-typed_ffmpeg/dag/io/_output.py,sha256=xayZijYpQzt26xkbCeuC7Z0EICDaArZIW69U1E4Hu8I,12432
-typed_ffmpeg/dag/io/output_args.py,sha256=SThIhZh9PXs2m6Fz5JsSy8oS-Te7GM_oz7HRuZo0-eI,13901
-typed_ffmpeg/dag/nodes.py,sha256=ua0wZDcu60nscs5V0CDTCoZbw9uyrYC7vkZrewNVqsU,14778
-typed_ffmpeg/dag/schema.py,sha256=rkzf9OavVj_pP8dVqVI8wAMaCUe0Q1s5B1MLN35a5Dk,5913
-typed_ffmpeg/dag/utils.py,sha256=ooGrCOnsvRjjUMhC4JSCc3T2FRL1JLz0CeVSiE9f1hI,1141
-typed_ffmpeg/dag/validate.py,sha256=hsKzWIKngZWAZCEzU-G0drSfAJyOQd9WXx0c7m0vLLg,5973
-typed_ffmpeg/exceptions.py,sha256=rNF4bGWDds9P9gzzATEmPMHprXx1Rm4QVtFyIq3pqNc,944
-typed_ffmpeg/filters.py,sha256=_lBpGZgPHK3KgGVrw-TCdQEsBRuEXVIgwggYNGd80MU,110076
-typed_ffmpeg/info.py,sha256=-5ME5u16foXWDSdO-1hNw_4twH_5gtkENdiswg4fMAk,4790
-typed_ffmpeg/probe.py,sha256=iIMKIdlvudCnnJLVKwzQxCOhGlgSqtnCeSgY8mEiHoE,1449
-typed_ffmpeg/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-typed_ffmpeg/schema.py,sha256=Bb1It8tVVmPcGl2QkhIqSMdsL4ZnwkdBy-5UjS5SEvQ,533
-typed_ffmpeg/streams/__init__.py,sha256=Nt9uWpcVI1sQLl5Qt_kBCBcWOGZA1vczCQ0qvFbSko0,141
-typed_ffmpeg/streams/audio.py,sha256=2oNRhb5UetWtlPG3NW73AjUZoFPl303yMv-6W1sGWt0,259054
-typed_ffmpeg/streams/av.py,sha256=SWcy8Q9hk36ZZJ4WosG08NR-r1f2IzOgZ4tsAZ7nX18,544
-typed_ffmpeg/streams/channel_layout.py,sha256=ocRb1HM9QgAH4xL0liVs-lXq0WaZyRu1agWz4CaLssU,662
-typed_ffmpeg/streams/video.py,sha256=cQwHfew75YO_dbZjmpUYd-nXt1JHN0M7suFKKe5UH5s,453576
-typed_ffmpeg/types.py,sha256=ly3zLtg7KxRa_jsDDrFPAxRZRjTQdWVpiQzOD9NdrFM,4137
-typed_ffmpeg/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-typed_ffmpeg/utils/escaping.py,sha256=OfX0K2InUuAye7t8DcS6ebCNvRatxy1F4ieBLRfOea4,1203
-typed_ffmpeg/utils/lazy_eval/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-typed_ffmpeg/utils/lazy_eval/operator.py,sha256=AFUUdse1M5QvyO6i78xO3e3hxG2lwITSmgywsQbDWNs,2787
-typed_ffmpeg/utils/lazy_eval/schema.py,sha256=JCiwxNElHzeSm5ehfgpwgV1fNbZ7cuQzs2u605zEw5Q,4840
-typed_ffmpeg/utils/run.py,sha256=9fKUFOS6mD4hDm751zVADS31N4yY6dTeoKPy1LImauI,710
-typed_ffmpeg/utils/snapshot.py,sha256=TLhjMPVzOpWSqoToNy_heWCv3-Hnbk6hK_BuRKAhf0U,773
-typed_ffmpeg/utils/typing.py,sha256=sx4IN38NGQxgMs5GOtPouM02TcHINxvTreXPUbAbGRc,316
-typed_ffmpeg/utils/view.py,sha256=RhKqKgRQ3mRaXtnV77yUk40HKgiGZikB4T8IL92I3v4,1780
-typed_ffmpeg_compatible-2.6.2.dist-info/LICENSE,sha256=8Aaya5i_09Cou2i3QMxTwz6uHGzi_fGA4uhkco07-A4,1066
-typed_ffmpeg_compatible-2.6.2.dist-info/METADATA,sha256=VUmB65xLFEjnUI0aANrHLS66BrktLsSZQhsb0GJEVno,7249
-typed_ffmpeg_compatible-2.6.2.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
-typed_ffmpeg_compatible-2.6.2.dist-info/entry_points.txt,sha256=KfZmNsM16GT_lF1otASIN6E3i6xXHXoB1gMeEdlptjA,44
-typed_ffmpeg_compatible-2.6.2.dist-info/RECORD,,