1 from __future__ import unicode_literals
11 class PostProcessor(object):
12 """Post Processor class.
14 PostProcessor objects can be added to downloaders with their
15 add_post_processor() method. When the downloader has finished a
16 successful download, it will take its internal chain of PostProcessors
17 and start calling the run() method on each one of them, first with
18 an initial argument and then with the returned value of the previous
21 The chain will be stopped if one of them ever returns None or the end
22 of the chain is reached.
24 PostProcessor objects follow a "mutual registration" process similar
25 to InfoExtractor objects. And it can receive parameters from CLI trough
31 def __init__(self, downloader=None):
32 self._extra_cmd_args = downloader.params.get('postprocessor_args')
33 self._downloader = downloader
35 def set_downloader(self, downloader):
36 """Sets the downloader for this PP."""
37 self._downloader = downloader
39 def run(self, information):
40 """Run the PostProcessor.
42 The "information" argument is a dictionary like the ones
43 composed by InfoExtractors. The only difference is that this
44 one has an extra field called "filepath" that points to the
47 This method returns a tuple, the first element is a list of the files
48 that can be deleted, and the second of which is the updated
51 In addition, this method may raise a PostProcessingError
52 exception if post processing fails.
54 return [], information # by default, keep file and do nothing
56 def try_utime(self, path, atime, mtime, errnote='Cannot update utime of file'):
58 os.utime(encodeFilename(path), (atime, mtime))
60 self._downloader.report_warning(errnote)
63 class AudioConversionError(PostProcessingError):