B
jnd
! @ sp d dl Z d dlZd dlZdZG dd deZG dd deZG dd deZG d d
d
eZ d d Z
d
d Z dS ) Nz0.3.0c @ s, e Zd ZdZd
ddZdd Zd dd ZdS ) FFmpegzhWrapper for various `FFmpeg `_ related applications (ffmpeg,
ffprobe).
ffmpegNc C s || _ |g| _|pg }t|r@g }x&|D ]}|t|7 }q(W n
t|}| j|7 _| jt|dd7 _| jt|7 _t| j| _d| _ dS )aJ Initialize FFmpeg command line wrapper.
Compiles FFmpeg command line from passed arguments (executable path, options, inputs and
outputs). ``inputs`` and ``outputs`` are dictionares containing inputs/outputs as keys and
their respective options as values. One dictionary value (set of options) must be either a
single space separated string, or a list or strings without spaces (i.e. each part of the
option is a separate item of the list, the result of calling ``split()`` on the options
string). If the value is a list, it cannot be mixed, i.e. cannot contain items with spaces.
An exception are complex FFmpeg command lines that contain quotes: the quoted part must be
one string, even if it contains spaces (see *Examples* for more info).
For more info about FFmpeg command line format see `here
`_.
:param str executable: path to ffmpeg executable; by default the ``ffmpeg`` command will be
searched for in the ``PATH``, but can be overridden with an absolute path to ``ffmpeg``
executable
:param iterable global_options: global options passed to ``ffmpeg`` executable (e.g.
``-y``, ``-v`` etc.); can be specified either as a list/tuple/set of strings, or one
space-separated string; by default no global options are passed
:param dict inputs: a dictionary specifying one or more input arguments as keys with their
corresponding options (either as a list of strings or a single space separated string) as
values
:param dict outputs: a dictionary specifying one or more output arguments as keys with their
corresponding options (either as a list of strings or a single space separated string) as
values
T)add_input_optionN)
executable_cmd _is_sequenceshlexsplit_merge_args_opts
subprocess list2cmdlinecmdprocess)selfr global_optionsinputsoutputsZnormalized_global_optionsopt r )/tmp/pip-unpacked-wheel-wssbpeae/ffmpy.py__init__
s
zFFmpeg.__init__c C s d | jj| jS )Nz
<{0!r} {1!r}>)format __class____name__r
)r r r r __repr__< s zFFmpeg.__repr__c
C s y t j| jt j|||d| _W nB tk
r` } z$|jtjkrNtd | j
n W dd}~X Y nX | jj |d}| jj dkrt
| j| jj |d |d |S )a Execute FFmpeg command line.
``input_data`` can contain input for FFmpeg in case ``pipe`` protocol is used for input.
``stdout`` and ``stderr`` specify where to redirect the ``stdout`` and ``stderr`` of the
process. By default no redirection is done, which means all output goes to running shell
(this mode should normally only be used for debugging purposes). If FFmpeg ``pipe`` protocol
is used for output, ``stdout`` must be redirected to a pipe by passing `subprocess.PIPE` as
``stdout`` argument. You can pass custom environment to ffmpeg process with ``env``.
Returns a 2-tuple containing ``stdout`` and ``stderr`` of the process. If there was no
redirection or if the output was redirected to e.g. `os.devnull`, the value returned will
be a tuple of two `None` values, otherwise it will contain the actual ``stdout`` and
``stderr`` data returned by ffmpeg process.
More info about ``pipe`` protocol `here `_.
:param str input_data: input data for FFmpeg to deal with (audio, video etc.) as bytes (e.g.
the result of reading a file in binary mode)
:param stdout: redirect FFmpeg ``stdout`` there (default is `None` which means no
redirection)
:param stderr: redirect FFmpeg ``stderr`` there (default is `None` which means no
redirection)
:param env: custom environment for ffmpeg process
:return: a 2-tuple containing ``stdout`` and ``stderr`` of the process
:rtype: tuple
:raise: `FFRuntimeError` in case FFmpeg command exits with a non-zero code;
`FFExecutableNotFoundError` in case the executable path passed was not valid
)stdinstdoutstderrenvzExecutable '{0}' not foundN)inputr )r Popenr PIPEr OSErrorerrnoENOENTFFExecutableNotFoundErrorr r communicate
returncodeFFRuntimeErrorr
)r Z
input_datar r r eoutr r r run? s z
FFmpeg.run)r NNN)NNNN)r
__module__ __qualname____doc__r r r, r r r r r s
.r c s" e Zd ZdZd fdd Z ZS )FFprobez=Wrapper for `ffprobe `_.ffprobe Nc s t t| j|||d dS )a Create an instance of FFprobe.
Compiles FFprobe command line from passed arguments (executable path, options, inputs).
FFprobe executable by default is taken from ``PATH`` but can be overridden with an
absolute path. For more info about FFprobe command line format see
`here `_.
:param str executable: absolute path to ffprobe executable
:param iterable global_options: global options passed to ffmpeg executable; can be specified
either as a list/tuple of strings or a space-separated string
:param dict inputs: a dictionary specifying one or more inputs as keys with their
corresponding options as values
)r r r N)superr0 r )r r r r )r r r r r s
zFFprobe.__init__)r1 r2 N)r r- r. r/ r
__classcell__r r )r r r0 o s r0 c @ s e Zd ZdZdS )r& z3Raise when FFmpeg/FFprobe executable was not found.N)r r- r. r/ r r r r r& s r& c s e Zd ZdZ fddZ ZS )r) zRaise when FFmpeg/FFprobe command line execution returns a non-zero exit code.
The resulting exception object will contain the attributes relates to command line execution:
``cmd``, ``exit_code``, ``stdout``, ``stderr``.
c sN || _ || _|| _|| _d| j ||p(d |p2d }tt| | d S )Nz6`{0}` exited with status {1}
STDOUT:
{2}
STDERR:
{3} ) r
exit_coder r r decoder3 r) r )r r
r6 r r message)r r r r s zFFRuntimeError.__init__)r r- r. r/ r r4 r r )r r r) s r) c C s t | dot| t S )zCheck if the object is a sequence (list, tuple etc.).
:param object obj: an object to be checked
:return: True if the object is iterable but is not a string, False otherwise
:rtype: bool
__iter__)hasattr
isinstancestr)objr r r r s r c K sf g }| s |S xT| D ]H\}}t|s4t|p0d}||7 }|sBqd|krT|d || qW |S )a Merge options with their corresponding arguments.
Iterates over the dictionary holding arguments (keys) and options (values). Merges each
options string with its corresponding argument.
:param dict args_opts_dict: a dictionary of arguments and options
:param dict kwargs: *input_option* - if specified prepends ``-i`` to input argument
:return: merged list of strings with arguments and their corresponding options
:rtype: list
r2 r z-i)itemsr r r append)Zargs_opts_dictkwargsmergedargr r r r r
s
r
) r$ r r __version__objectr r0 Exceptionr& r) r r
r r r r s g