Merge branch 'vgtv' of https://github.com/mrkolby/youtube-dl into mrkolby-vgtv
[youtube-dl] / test / helper.py
1 import errno
2 import io
3 import hashlib
4 import json
5 import os.path
6 import re
7 import types
8 import sys
9
10 import youtube_dl.extractor
11 from youtube_dl import YoutubeDL
12 from youtube_dl.utils import (
13     compat_str,
14     preferredencoding,
15 )
16
17
18 def get_params(override=None):
19     PARAMETERS_FILE = os.path.join(os.path.dirname(os.path.abspath(__file__)),
20                                    "parameters.json")
21     with io.open(PARAMETERS_FILE, encoding='utf-8') as pf:
22         parameters = json.load(pf)
23     if override:
24         parameters.update(override)
25     return parameters
26
27
28 def try_rm(filename):
29     """ Remove a file if it exists """
30     try:
31         os.remove(filename)
32     except OSError as ose:
33         if ose.errno != errno.ENOENT:
34             raise
35
36
37 def report_warning(message):
38     '''
39     Print the message to stderr, it will be prefixed with 'WARNING:'
40     If stderr is a tty file the 'WARNING:' will be colored
41     '''
42     if sys.stderr.isatty() and os.name != 'nt':
43         _msg_header = u'\033[0;33mWARNING:\033[0m'
44     else:
45         _msg_header = u'WARNING:'
46     output = u'%s %s\n' % (_msg_header, message)
47     if 'b' in getattr(sys.stderr, 'mode', '') or sys.version_info[0] < 3:
48         output = output.encode(preferredencoding())
49     sys.stderr.write(output)
50
51
52 class FakeYDL(YoutubeDL):
53     def __init__(self, override=None):
54         # Different instances of the downloader can't share the same dictionary
55         # some test set the "sublang" parameter, which would break the md5 checks.
56         params = get_params(override=override)
57         super(FakeYDL, self).__init__(params)
58         self.result = []
59         
60     def to_screen(self, s, skip_eol=None):
61         print(s)
62
63     def trouble(self, s, tb=None):
64         raise Exception(s)
65
66     def download(self, x):
67         self.result.append(x)
68
69     def expect_warning(self, regex):
70         # Silence an expected warning matching a regex
71         old_report_warning = self.report_warning
72         def report_warning(self, message):
73             if re.match(regex, message): return
74             old_report_warning(message)
75         self.report_warning = types.MethodType(report_warning, self)
76
77
78 def gettestcases(include_onlymatching=False):
79     for ie in youtube_dl.extractor.gen_extractors():
80         t = getattr(ie, '_TEST', None)
81         if t:
82             assert not hasattr(ie, '_TESTS'), \
83                 '%s has _TEST and _TESTS' % type(ie).__name__
84             tests = [t]
85         else:
86             tests = getattr(ie, '_TESTS', [])
87         for t in tests:
88             if not include_onlymatching and t.get('only_matching', False):
89                 continue
90             t['name'] = type(ie).__name__[:-len('IE')]
91             yield t
92
93
94 md5 = lambda s: hashlib.md5(s.encode('utf-8')).hexdigest()
95
96
97 def expect_info_dict(self, expected_dict, got_dict):
98     for info_field, expected in expected_dict.items():
99         if isinstance(expected, compat_str) and expected.startswith('re:'):
100             got = got_dict.get(info_field)
101             match_str = expected[len('re:'):]
102             match_rex = re.compile(match_str)
103
104             self.assertTrue(
105                 isinstance(got, compat_str),
106                 u'Expected a %s object, but got %s for field %s' % (
107                     compat_str.__name__, type(got).__name__, info_field))
108             self.assertTrue(
109                 match_rex.match(got),
110                 u'field %s (value: %r) should match %r' % (info_field, got, match_str))
111         elif isinstance(expected, type):
112             got = got_dict.get(info_field)
113             self.assertTrue(isinstance(got, expected),
114                 u'Expected type %r for field %s, but got value %r of type %r' % (expected, info_field, got, type(got)))
115         else:
116             if isinstance(expected, compat_str) and expected.startswith('md5:'):
117                 got = 'md5:' + md5(got_dict.get(info_field))
118             else:
119                 got = got_dict.get(info_field)
120             self.assertEqual(expected, got,
121                 u'invalid value for field %s, expected %r, got %r' % (info_field, expected, got))
122
123     # Check for the presence of mandatory fields
124     if got_dict.get('_type') != 'playlist':
125         for key in ('id', 'url', 'title', 'ext'):
126             self.assertTrue(got_dict.get(key), 'Missing mandatory field %s' % key)
127     # Check for mandatory fields that are automatically set by YoutubeDL
128     for key in ['webpage_url', 'extractor', 'extractor_key']:
129         self.assertTrue(got_dict.get(key), u'Missing field: %s' % key)
130
131     # Are checkable fields missing from the test case definition?
132     test_info_dict = dict((key, value if not isinstance(value, compat_str) or len(value) < 250 else 'md5:' + md5(value))
133         for key, value in got_dict.items()
134         if value and key in ('title', 'description', 'uploader', 'upload_date', 'timestamp', 'uploader_id', 'location'))
135     missing_keys = set(test_info_dict.keys()) - set(expected_dict.keys())
136     if missing_keys:
137         sys.stderr.write(u'\n"info_dict": ' + json.dumps(test_info_dict, ensure_ascii=False, indent=4) + u'\n')
138         self.assertFalse(
139             missing_keys,
140             'Missing keys in test definition: %s' % (
141                 ', '.join(sorted(missing_keys))))
142
143
144 def assertRegexpMatches(self, text, regexp, msg=None):
145     if hasattr(self, 'assertRegexp'):
146         return self.assertRegexp(text, regexp, msg)
147     else:
148         m = re.match(regexp, text)
149         if not m:
150             note = 'Regexp didn\'t match: %r not found in %r' % (regexp, text)
151             if msg is None:
152                 msg = note
153             else:
154                 msg = note + ', ' + msg
155             self.assertTrue(m, msg)
156
157
158 def assertGreaterEqual(self, got, expected, msg=None):
159     if not (got >= expected):
160         if msg is None:
161             msg = '%r not greater than or equal to %r' % (got, expected)
162         self.assertTrue(got >= expected, msg)