Add ffprobe support

ffmpeg/__init__.py

@@ -1,9 +1,10 @@
 from __future__ import unicode_literals
 
-from . import _filters, _ffmpeg, _run
+from . import _filters, _ffmpeg, _run, _probe
 from ._filters import *
 from ._ffmpeg import *
 from ._run import *
 from ._view import *
+from ._probe import *
 
-__all__ = _filters.__all__ + _ffmpeg.__all__ + _run.__all__ + _view.__all__
+__all__ = _filters.__all__ + _ffmpeg.__all__ + _run.__all__ + _view.__all__ + _probe.__all__

ffmpeg/_probe.py

@@ -0,0 +1,28 @@
+import json
+import subprocess
+
+
+class ProbeException(Exception):
+    def __init__(self, stderr_output):
+        super(ProbeException, self).__init__('ffprobe error')
+        self.stderr_output = stderr_output
+
+
+def probe(filename):
+    """Run ffprobe on the specified file and return a JSON representation of the output.
+
+    Raises:
+        ProbeException: if ffprobe returns a non-zero exit code, a ``ProbeException`` is returned with a generic error
+            message.  The stderr output can be retrieved by accessing the ``stderr_output`` property of the exception.
+    """
+    args = ['ffprobe', '-show_format', '-show_streams', '-of', 'json', filename]
+    p = subprocess.Popen(args, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+    out, err = p.communicate()
+    if p.returncode != 0:
+        raise ExecException(err)
+    return json.loads(out)
+
+
+__all__ = [
+    'probe',
+]

ffmpeg/tests/test_ffmpeg.py

@@ -353,3 +353,9 @@ def test_pipe():
     out_data = p.stdout.read()
     assert len(out_data) == frame_size * (frame_count - start_frame)
     assert out_data == in_data[start_frame*frame_size:]
+
+
+def test_ffprobe():
+    data = ffmpeg.probe(TEST_INPUT_FILE1)
+    assert set(data.keys()) == {'format', 'streams'}
+    assert data['format']['duration'] == '7.036000'