mprobe 0.0.1__py3-none-any.whl

mprobe-0.0.1.dist-info/METADATA

@@ -0,0 +1,48 @@
+Metadata-Version: 2.4
+Name: mprobe
+Version: 0.0.1
+Summary: Read video and audio metadata using ffprobe or avprobe
+Author-email: pi11 <webii@pm.me>
+Project-URL: Homepage, https://github.com/pi11/mprobe
+Project-URL: Issues, https://github.com/pi11/mprobe/issues
+Keywords: video,audio,metadata,ffprobe,avprobe
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Multimedia :: Sound/Audio
+Classifier: Topic :: Multimedia :: Video
+Requires-Python: >=3.10
+Description-Content-Type: text/x-rst
+License-File: THIRD_PARTY_NOTICES
+Dynamic: license-file
+
+mprobe
+======
+
+Read video and audio metadata with Python 3.10+ and ffprobe (or avprobe).
+Install `FFmpeg <https://ffmpeg.org/download.html>`_ separately and ensure
+``ffprobe`` is on your PATH; pip does not install it.
+
+Install and use
+---------------
+
+.. code-block:: console
+
+   python -m pip install mprobe
+
+.. code-block:: python
+
+   from mprobe import mediainfo
+
+   info = mediainfo("video.mp4", timeout=30)
+   print(info.get("duration"))   # seconds, as a string
+   print(info.get("format_name"))
+
+Accepts strings and pathlib paths. Values are strings; ``TAG`` and
+``DISPOSITION`` contain dictionaries. Repeated fields use the last stream's
+value, then the container's value. Fields vary by file and may be absent.
+Missing probes raise ``FileNotFoundError``; invalid or missing media raise
+``subprocess.CalledProcessError`` (details in ``stderr``). A timeout raises
+``subprocess.TimeoutExpired``.
+
+Inspired by `pydub <https://github.com/jiaaro/pydub>`_.

mprobe-0.0.1.dist-info/RECORD

@@ -0,0 +1,6 @@
+mprobe.py,sha256=EFCE0666vXLl8-fmwgttPBrkEQOOap4Oldotszbh9uY,2234
+mprobe-0.0.1.dist-info/licenses/THIRD_PARTY_NOTICES,sha256=YLQdAgrTDeutLmXY6ww5lr9dU7oz7RmYwhmUvZ3X2Ng,1199
+mprobe-0.0.1.dist-info/METADATA,sha256=1zE0VrGD9Iov6Ip67tJ7LVjlD5b3gjzsVmM4S_L3SRc,1623
+mprobe-0.0.1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+mprobe-0.0.1.dist-info/top_level.txt,sha256=Kz-V0DTTyYSAe_sYYu4C3WF2VKXNA1EmPfx4k8DGu88,7
+mprobe-0.0.1.dist-info/RECORD,,

mprobe-0.0.1.dist-info/WHEEL

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

mprobe-0.0.1.dist-info/licenses/THIRD_PARTY_NOTICES

@@ -0,0 +1,23 @@
+The metadata parsing API was inspired by pydub:
+https://github.com/jiaaro/pydub
+
+pydub is distributed under the MIT license:
+
+Copyright (c) 2011 James Robert, http://jiaaro.com
+
+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.

mprobe-0.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+mprobe

mprobe.py

@@ -0,0 +1,59 @@
+"""Read video/audio metadata using ffprobe or avprobe, inspired by pydub."""
+
+import os
+import shutil
+import subprocess
+
+
+def which(program):
+    """Return the executable's path, or None when it is not on PATH."""
+    return shutil.which(program)
+
+
+def get_prober_name():
+    """Return an available probe executable, preferring ffprobe."""
+    for program in ("ffprobe", "avprobe"):
+        executable = which(program)
+        if executable:
+            return executable
+    raise FileNotFoundError("Install FFmpeg (ffprobe) or Libav (avprobe) and add it to PATH")
+
+
+def mediainfo(filepath, *, timeout=None):
+    """Return a dictionary of media metadata with string values.
+
+    TAG and DISPOSITION fields are nested dictionaries. Repeated fields are
+    overwritten by later streams and then container metadata, as in the
+    original API. filepath may be a string or a path-like object.
+
+    Raise FileNotFoundError when no prober is installed, CalledProcessError
+    when probing fails (with diagnostics in stderr), or TimeoutExpired when
+    the optional timeout in seconds is exceeded.
+    """
+    prober = get_prober_name()
+    args = ["-v", "error", "-show_format", "-show_streams", "-i", os.fsdecode(filepath)]
+    options = dict(stdout=subprocess.PIPE, stderr=subprocess.PIPE,
+                   encoding="utf-8", errors="replace", timeout=timeout)
+
+    if os.path.basename(prober).lower() in ("avprobe", "avprobe.exe"):
+        # Older Libav versions require the legacy key=value writer.
+        result = subprocess.run([prober, "-of", "old"] + args, **options)
+        if result.returncode:
+            result = subprocess.run([prober] + args, check=True, **options)
+    else:
+        result = subprocess.run([prober] + args, check=True, **options)
+
+    info = {}
+    for line in result.stdout.splitlines():
+        key, separator, value = line.partition("=")
+        if not separator:
+            continue
+        namespace, separator, nested_key = key.partition(":")
+        if separator:
+            nested = info.get(namespace)
+            if not isinstance(nested, dict):
+                nested = info[namespace] = {}
+            nested[nested_key] = value
+        else:
+            info[key] = value
+    return info