logo

youtube-dl

[mirror] Download/Watch videos from video hostersgit clone https://hacktivis.me/git/mirror/youtube-dl.git

test_utils.py (100667B)

    

  1. #!/usr/bin/env python
  2. # coding: utf-8
  4. from __future__ import unicode_literals
  6. # Allow direct execution
  7. import os
  8. import sys
  9. import unittest
  10. sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
  13. # Various small unit tests
  14. import io
  15. import itertools
  16. import json
  17. import re
  18. import xml.etree.ElementTree
  20. from youtube_dl.utils import (
  21.     age_restricted,
  22.     args_to_str,
  23.     base_url,
  24.     caesar,
  25.     clean_html,
  26.     clean_podcast_url,
  27.     date_from_str,
  28.     DateRange,
  29.     detect_exe_version,
  30.     determine_ext,
  31.     dict_get,
  32.     encode_base_n,
  33.     encode_compat_str,
  34.     encodeFilename,
  35.     escape_rfc3986,
  36.     escape_url,
  37.     expand_path,
  38.     extract_attributes,
  39.     ExtractorError,
  40.     find_xpath_attr,
  41.     fix_xml_ampersands,
  42.     float_or_none,
  43.     get_element_by_class,
  44.     get_element_by_attribute,
  45.     get_elements_by_class,
  46.     get_elements_by_attribute,
  47.     get_first,
  48.     InAdvancePagedList,
  49.     int_or_none,
  50.     intlist_to_bytes,
  51.     is_html,
  52.     join_nonempty,
  53.     js_to_json,
  54.     LazyList,
  55.     limit_length,
  56.     lowercase_escape,
  57.     merge_dicts,
  58.     mimetype2ext,
  59.     month_by_name,
  60.     multipart_encode,
  61.     ohdave_rsa_encrypt,
  62.     OnDemandPagedList,
  63.     orderedSet,
  64.     parse_age_limit,
  65.     parse_bitrate,
  66.     parse_duration,
  67.     parse_filesize,
  68.     parse_codecs,
  69.     parse_count,
  70.     parse_iso8601,
  71.     parse_resolution,
  72.     parse_qs,
  73.     pkcs1pad,
  74.     prepend_extension,
  75.     read_batch_urls,
  76.     remove_start,
  77.     remove_end,
  78.     remove_quotes,
  79.     replace_extension,
  80.     rot47,
  81.     sanitize_filename,
  82.     sanitize_path,
  83.     sanitize_url,
  84.     sanitized_Request,
  85.     shell_quote,
  86.     smuggle_url,
  87.     str_or_none,
  88.     str_to_int,
  89.     strip_jsonp,
  90.     strip_or_none,
  91.     subtitles_filename,
  92.     T,
  93.     timeconvert,
  94.     traverse_obj,
  95.     try_call,
  96.     unescapeHTML,
  97.     unified_strdate,
  98.     unified_timestamp,
  99.     unsmuggle_url,
  100.     uppercase_escape,
  101.     url_basename,
  102.     url_or_none,
  103.     urljoin,
  104.     urlencode_postdata,
  105.     urshift,
  106.     update_url_query,
  107.     variadic,
  108.     version_tuple,
  109.     xpath_with_ns,
  110.     xpath_element,
  111.     xpath_text,
  112.     xpath_attr,
  113.     render_table,
  114.     match_str,
  115.     parse_dfxp_time_expr,
  116.     dfxp2srt,
  117.     cli_option,
  118.     cli_valueless_option,
  119.     cli_bool_option,
  120.     YoutubeDLHandler,
  121. )
  122. from youtube_dl.compat import (
  123.     compat_chr,
  124.     compat_etree_fromstring,
  125.     compat_getenv,
  126.     compat_os_name,
  127.     compat_setenv,
  128.     compat_str,
  129.     compat_urlparse,
  130. )
  133. class TestUtil(unittest.TestCase):
  135.     # yt-dlp shim
  136.     def assertCountEqual(self, expected, got, msg='count should be the same'):
  137.         return self.assertEqual(len(tuple(expected)), len(tuple(got)), msg=msg)
  139.     def test_timeconvert(self):
  140.         self.assertTrue(timeconvert('') is None)
  141.         self.assertTrue(timeconvert('bougrg') is None)
  143.     def test_sanitize_filename(self):
  144.         self.assertEqual(sanitize_filename('abc'), 'abc')
  145.         self.assertEqual(sanitize_filename('abc_d-e'), 'abc_d-e')
  147.         self.assertEqual(sanitize_filename('123'), '123')
  149.         self.assertEqual('abc_de', sanitize_filename('abc/de'))
  150.         self.assertFalse('/' in sanitize_filename('abc/de///'))
  152.         self.assertEqual('abc_de', sanitize_filename('abc/<>\\*|de'))
  153.         self.assertEqual('xxx', sanitize_filename('xxx/<>\\*|'))
  154.         self.assertEqual('yes no', sanitize_filename('yes? no'))
  155.         self.assertEqual('this - that', sanitize_filename('this: that'))
  157.         self.assertEqual(sanitize_filename('AT&T'), 'AT&T')
  158.         aumlaut = 'ä'
  159.         self.assertEqual(sanitize_filename(aumlaut), aumlaut)
  160.         tests = '\u043a\u0438\u0440\u0438\u043b\u043b\u0438\u0446\u0430'
  161.         self.assertEqual(sanitize_filename(tests), tests)
  163.         self.assertEqual(
  164.             sanitize_filename('New World record at 0:12:34'),
  165.             'New World record at 0_12_34')
  167.         self.assertEqual(sanitize_filename('--gasdgf'), '_-gasdgf')
  168.         self.assertEqual(sanitize_filename('--gasdgf', is_id=True), '--gasdgf')
  169.         self.assertEqual(sanitize_filename('.gasdgf'), 'gasdgf')
  170.         self.assertEqual(sanitize_filename('.gasdgf', is_id=True), '.gasdgf')
  172.         forbidden = '"\0\\/'
  173.         for fc in forbidden:
  174.             for fbc in forbidden:
  175.                 self.assertTrue(fbc not in sanitize_filename(fc))
  177.     def test_sanitize_filename_restricted(self):
  178.         self.assertEqual(sanitize_filename('abc', restricted=True), 'abc')
  179.         self.assertEqual(sanitize_filename('abc_d-e', restricted=True), 'abc_d-e')
  181.         self.assertEqual(sanitize_filename('123', restricted=True), '123')
  183.         self.assertEqual('abc_de', sanitize_filename('abc/de', restricted=True))
  184.         self.assertFalse('/' in sanitize_filename('abc/de///', restricted=True))
  186.         self.assertEqual('abc_de', sanitize_filename('abc/<>\\*|de', restricted=True))
  187.         self.assertEqual('xxx', sanitize_filename('xxx/<>\\*|', restricted=True))
  188.         self.assertEqual('yes_no', sanitize_filename('yes? no', restricted=True))
  189.         self.assertEqual('this_-_that', sanitize_filename('this: that', restricted=True))
  191.         tests = 'aäb\u4e2d\u56fd\u7684c'
  192.         self.assertEqual(sanitize_filename(tests, restricted=True), 'aab_c')
  193.         self.assertTrue(sanitize_filename('\xf6', restricted=True) != '')  # No empty filename
  195.         forbidden = '"\0\\/&!: \'\t\n()[]{}$;`^,#'
  196.         for fc in forbidden:
  197.             for fbc in forbidden:
  198.                 self.assertTrue(fbc not in sanitize_filename(fc, restricted=True))
  200.         # Handle a common case more neatly
  201.         self.assertEqual(sanitize_filename('\u5927\u58f0\u5e26 - Song', restricted=True), 'Song')
  202.         self.assertEqual(sanitize_filename('\u603b\u7edf: Speech', restricted=True), 'Speech')
  203.         # .. but make sure the file name is never empty
  204.         self.assertTrue(sanitize_filename('-', restricted=True) != '')
  205.         self.assertTrue(sanitize_filename(':', restricted=True) != '')
  207.         self.assertEqual(sanitize_filename(
  208.             'ÂÃÄÀÁÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖŐØŒÙÚÛÜŰÝÞßàáâãäåæçèéêëìíîïðñòóôõöőøœùúûüűýþÿ', restricted=True),
  209.             'AAAAAAAECEEEEIIIIDNOOOOOOOOEUUUUUYTHssaaaaaaaeceeeeiiiionooooooooeuuuuuythy')
  211.     def test_sanitize_ids(self):
  212.         self.assertEqual(sanitize_filename('_n_cd26wFpw', is_id=True), '_n_cd26wFpw')
  213.         self.assertEqual(sanitize_filename('_BD_eEpuzXw', is_id=True), '_BD_eEpuzXw')
  214.         self.assertEqual(sanitize_filename('N0Y__7-UOdI', is_id=True), 'N0Y__7-UOdI')
  216.     def test_sanitize_path(self):
  217.         if sys.platform != 'win32':
  218.             return
  220.         self.assertEqual(sanitize_path('abc'), 'abc')
  221.         self.assertEqual(sanitize_path('abc/def'), 'abc\\def')
  222.         self.assertEqual(sanitize_path('abc\\def'), 'abc\\def')
  223.         self.assertEqual(sanitize_path('abc|def'), 'abc#def')
  224.         self.assertEqual(sanitize_path('<>:"|?*'), '#######')
  225.         self.assertEqual(sanitize_path('C:/abc/def'), 'C:\\abc\\def')
  226.         self.assertEqual(sanitize_path('C?:/abc/def'), 'C##\\abc\\def')
  228.         self.assertEqual(sanitize_path('\\\\?\\UNC\\ComputerName\\abc'), '\\\\?\\UNC\\ComputerName\\abc')
  229.         self.assertEqual(sanitize_path('\\\\?\\UNC/ComputerName/abc'), '\\\\?\\UNC\\ComputerName\\abc')
  231.         self.assertEqual(sanitize_path('\\\\?\\C:\\abc'), '\\\\?\\C:\\abc')
  232.         self.assertEqual(sanitize_path('\\\\?\\C:/abc'), '\\\\?\\C:\\abc')
  233.         self.assertEqual(sanitize_path('\\\\?\\C:\\ab?c\\de:f'), '\\\\?\\C:\\ab#c\\de#f')
  234.         self.assertEqual(sanitize_path('\\\\?\\C:\\abc'), '\\\\?\\C:\\abc')
  236.         self.assertEqual(
  237.             sanitize_path('youtube/%(uploader)s/%(autonumber)s-%(title)s-%(upload_date)s.%(ext)s'),
  238.             'youtube\\%(uploader)s\\%(autonumber)s-%(title)s-%(upload_date)s.%(ext)s')
  240.         self.assertEqual(
  241.             sanitize_path('youtube/TheWreckingYard ./00001-Not bad, Especially for Free! (1987 Yamaha 700)-20141116.mp4.part'),
  242.             'youtube\\TheWreckingYard #\\00001-Not bad, Especially for Free! (1987 Yamaha 700)-20141116.mp4.part')
  243.         self.assertEqual(sanitize_path('abc/def...'), 'abc\\def..#')
  244.         self.assertEqual(sanitize_path('abc.../def'), 'abc..#\\def')
  245.         self.assertEqual(sanitize_path('abc.../def...'), 'abc..#\\def..#')
  247.         self.assertEqual(sanitize_path('../abc'), '..\\abc')
  248.         self.assertEqual(sanitize_path('../../abc'), '..\\..\\abc')
  249.         self.assertEqual(sanitize_path('./abc'), 'abc')
  250.         self.assertEqual(sanitize_path('./../abc'), '..\\abc')
  252.     def test_sanitize_url(self):
  253.         self.assertEqual(sanitize_url('//foo.bar'), 'http://foo.bar')
  254.         self.assertEqual(sanitize_url('httpss://foo.bar'), 'https://foo.bar')
  255.         self.assertEqual(sanitize_url('rmtps://foo.bar'), 'rtmps://foo.bar')
  256.         self.assertEqual(sanitize_url('https://foo.bar'), 'https://foo.bar')
  257.         self.assertEqual(sanitize_url('foo bar'), 'foo bar')
  259.     def test_sanitized_Request(self):
  260.         self.assertFalse(sanitized_Request('http://foo.bar').has_header('Authorization'))
  261.         self.assertFalse(sanitized_Request('http://:foo.bar').has_header('Authorization'))
  262.         self.assertEqual(sanitized_Request('http://@foo.bar').get_header('Authorization'),
  263.                          'Basic Og==')
  264.         self.assertEqual(sanitized_Request('http://:pass@foo.bar').get_header('Authorization'),
  265.                          'Basic OnBhc3M=')
  266.         self.assertEqual(sanitized_Request('http://user:@foo.bar').get_header('Authorization'),
  267.                          'Basic dXNlcjo=')
  268.         self.assertEqual(sanitized_Request('http://user:pass@foo.bar').get_header('Authorization'),
  269.                          'Basic dXNlcjpwYXNz')
  271.     def test_expand_path(self):
  272.         def env(var):
  273.             return '%{0}%'.format(var) if sys.platform == 'win32' else '${0}'.format(var)
  275.         compat_setenv('YOUTUBE_DL_EXPATH_PATH', 'expanded')
  276.         self.assertEqual(expand_path(env('YOUTUBE_DL_EXPATH_PATH')), 'expanded')
  277.         self.assertEqual(expand_path(env('HOME')), compat_getenv('HOME'))
  278.         self.assertEqual(expand_path('~'), compat_getenv('HOME'))
  279.         self.assertEqual(
  280.             expand_path('~/%s' % env('YOUTUBE_DL_EXPATH_PATH')),
  281.             '%s/expanded' % compat_getenv('HOME'))
  283.     def test_prepend_extension(self):
  284.         self.assertEqual(prepend_extension('abc.ext', 'temp'), 'abc.temp.ext')
  285.         self.assertEqual(prepend_extension('abc.ext', 'temp', 'ext'), 'abc.temp.ext')
  286.         self.assertEqual(prepend_extension('abc.unexpected_ext', 'temp', 'ext'), 'abc.unexpected_ext.temp')
  287.         self.assertEqual(prepend_extension('abc', 'temp'), 'abc.temp')
  288.         self.assertEqual(prepend_extension('.abc', 'temp'), '.abc.temp')
  289.         self.assertEqual(prepend_extension('.abc.ext', 'temp'), '.abc.temp.ext')
  291.     def test_replace_extension(self):
  292.         self.assertEqual(replace_extension('abc.ext', 'temp'), 'abc.temp')
  293.         self.assertEqual(replace_extension('abc.ext', 'temp', 'ext'), 'abc.temp')
  294.         self.assertEqual(replace_extension('abc.unexpected_ext', 'temp', 'ext'), 'abc.unexpected_ext.temp')
  295.         self.assertEqual(replace_extension('abc', 'temp'), 'abc.temp')
  296.         self.assertEqual(replace_extension('.abc', 'temp'), '.abc.temp')
  297.         self.assertEqual(replace_extension('.abc.ext', 'temp'), '.abc.temp')
  299.     def test_subtitles_filename(self):
  300.         self.assertEqual(subtitles_filename('abc.ext', 'en', 'vtt'), 'abc.en.vtt')
  301.         self.assertEqual(subtitles_filename('abc.ext', 'en', 'vtt', 'ext'), 'abc.en.vtt')
  302.         self.assertEqual(subtitles_filename('abc.unexpected_ext', 'en', 'vtt', 'ext'), 'abc.unexpected_ext.en.vtt')
  304.     def test_remove_start(self):
  305.         self.assertEqual(remove_start(None, 'A - '), None)
  306.         self.assertEqual(remove_start('A - B', 'A - '), 'B')
  307.         self.assertEqual(remove_start('B - A', 'A - '), 'B - A')
  309.     def test_remove_end(self):
  310.         self.assertEqual(remove_end(None, ' - B'), None)
  311.         self.assertEqual(remove_end('A - B', ' - B'), 'A')
  312.         self.assertEqual(remove_end('B - A', ' - B'), 'B - A')
  314.     def test_remove_quotes(self):
  315.         self.assertEqual(remove_quotes(None), None)
  316.         self.assertEqual(remove_quotes('"'), '"')
  317.         self.assertEqual(remove_quotes("'"), "'")
  318.         self.assertEqual(remove_quotes(';'), ';')
  319.         self.assertEqual(remove_quotes('";'), '";')
  320.         self.assertEqual(remove_quotes('""'), '')
  321.         self.assertEqual(remove_quotes('";"'), ';')
  323.     def test_ordered_set(self):
  324.         self.assertEqual(orderedSet([1, 1, 2, 3, 4, 4, 5, 6, 7, 3, 5]), [1, 2, 3, 4, 5, 6, 7])
  325.         self.assertEqual(orderedSet([]), [])
  326.         self.assertEqual(orderedSet([1]), [1])
  327.         # keep the list ordered
  328.         self.assertEqual(orderedSet([135, 1, 1, 1]), [135, 1])
  330.     def test_unescape_html(self):
  331.         self.assertEqual(unescapeHTML('%20;'), '%20;')
  332.         self.assertEqual(unescapeHTML('&#x2F;'), '/')
  333.         self.assertEqual(unescapeHTML('&#47;'), '/')
  334.         self.assertEqual(unescapeHTML('&eacute;'), 'é')
  335.         self.assertEqual(unescapeHTML('&#2013266066;'), '&#2013266066;')
  336.         self.assertEqual(unescapeHTML('&a&quot;'), '&a"')
  337.         # HTML5 entities
  338.         self.assertEqual(unescapeHTML('&period;&apos;'), '.\'')
  340.     def test_date_from_str(self):
  341.         self.assertEqual(date_from_str('yesterday'), date_from_str('now-1day'))
  342.         self.assertEqual(date_from_str('now+7day'), date_from_str('now+1week'))
  343.         self.assertEqual(date_from_str('now+14day'), date_from_str('now+2week'))
  344.         self.assertEqual(date_from_str('now+365day'), date_from_str('now+1year'))
  345.         self.assertEqual(date_from_str('now+30day'), date_from_str('now+1month'))
  347.     def test_daterange(self):
  348.         _20century = DateRange("19000101", "20000101")
  349.         self.assertFalse("17890714" in _20century)
  350.         _ac = DateRange("00010101")
  351.         self.assertTrue("19690721" in _ac)
  352.         _firstmilenium = DateRange(end="10000101")
  353.         self.assertTrue("07110427" in _firstmilenium)
  355.     def test_unified_dates(self):
  356.         self.assertEqual(unified_strdate('December 21, 2010'), '20101221')
  357.         self.assertEqual(unified_strdate('8/7/2009'), '20090708')
  358.         self.assertEqual(unified_strdate('Dec 14, 2012'), '20121214')
  359.         self.assertEqual(unified_strdate('2012/10/11 01:56:38 +0000'), '20121011')
  360.         self.assertEqual(unified_strdate('1968 12 10'), '19681210')
  361.         self.assertEqual(unified_strdate('1968-12-10'), '19681210')
  362.         self.assertEqual(unified_strdate('28/01/2014 21:00:00 +0100'), '20140128')
  363.         self.assertEqual(
  364.             unified_strdate('11/26/2014 11:30:00 AM PST', day_first=False),
  365.             '20141126')
  366.         self.assertEqual(
  367.             unified_strdate('2/2/2015 6:47:40 PM', day_first=False),
  368.             '20150202')
  369.         self.assertEqual(unified_strdate('Feb 14th 2016 5:45PM'), '20160214')
  370.         self.assertEqual(unified_strdate('25-09-2014'), '20140925')
  371.         self.assertEqual(unified_strdate('27.02.2016 17:30'), '20160227')
  372.         self.assertEqual(unified_strdate('UNKNOWN DATE FORMAT'), None)
  373.         self.assertEqual(unified_strdate('Feb 7, 2016 at 6:35 pm'), '20160207')
  374.         self.assertEqual(unified_strdate('July 15th, 2013'), '20130715')
  375.         self.assertEqual(unified_strdate('September 1st, 2013'), '20130901')
  376.         self.assertEqual(unified_strdate('Sep 2nd, 2013'), '20130902')
  377.         self.assertEqual(unified_strdate('November 3rd, 2019'), '20191103')
  378.         self.assertEqual(unified_strdate('October 23rd, 2005'), '20051023')
  380.     def test_unified_timestamps(self):
  381.         self.assertEqual(unified_timestamp('December 21, 2010'), 1292889600)
  382.         self.assertEqual(unified_timestamp('8/7/2009'), 1247011200)
  383.         self.assertEqual(unified_timestamp('Dec 14, 2012'), 1355443200)
  384.         self.assertEqual(unified_timestamp('2012/10/11 01:56:38 +0000'), 1349920598)
  385.         self.assertEqual(unified_timestamp('1968 12 10'), -33436800)
  386.         self.assertEqual(unified_timestamp('1968-12-10'), -33436800)
  387.         self.assertEqual(unified_timestamp('28/01/2014 21:00:00 +0100'), 1390939200)
  388.         self.assertEqual(
  389.             unified_timestamp('11/26/2014 11:30:00 AM PST', day_first=False),
  390.             1417001400)
  391.         self.assertEqual(
  392.             unified_timestamp('2/2/2015 6:47:40 PM', day_first=False),
  393.             1422902860)
  394.         self.assertEqual(unified_timestamp('Feb 14th 2016 5:45PM'), 1455471900)
  395.         self.assertEqual(unified_timestamp('25-09-2014'), 1411603200)
  396.         self.assertEqual(unified_timestamp('27.02.2016 17:30'), 1456594200)
  397.         self.assertEqual(unified_timestamp('UNKNOWN DATE FORMAT'), None)
  398.         self.assertEqual(unified_timestamp('May 16, 2016 11:15 PM'), 1463440500)
  399.         self.assertEqual(unified_timestamp('Feb 7, 2016 at 6:35 pm'), 1454870100)
  400.         self.assertEqual(unified_timestamp('2017-03-30T17:52:41Q'), 1490896361)
  401.         self.assertEqual(unified_timestamp('Sep 11, 2013 | 5:49 AM'), 1378878540)
  402.         self.assertEqual(unified_timestamp('December 15, 2017 at 7:49 am'), 1513324140)
  403.         self.assertEqual(unified_timestamp('2018-03-14T08:32:43.1493874+00:00'), 1521016363)
  404.         self.assertEqual(unified_timestamp('December 31 1969 20:00:01 EDT'), 1)
  405.         self.assertEqual(unified_timestamp('Wednesday 31 December 1969 18:01:26 MDT'), 86)
  406.         self.assertEqual(unified_timestamp('12/31/1969 20:01:18 EDT', False), 78)
  408.     def test_determine_ext(self):
  409.         self.assertEqual(determine_ext('http://example.com/foo/bar.mp4/?download'), 'mp4')
  410.         self.assertEqual(determine_ext('http://example.com/foo/bar/?download', None), None)
  411.         self.assertEqual(determine_ext('http://example.com/foo/bar.nonext/?download', None), None)
  412.         self.assertEqual(determine_ext('http://example.com/foo/bar/mp4?download', None), None)
  413.         self.assertEqual(determine_ext('http://example.com/foo/bar.m3u8//?download'), 'm3u8')
  414.         self.assertEqual(determine_ext('foobar', None), None)
  416.     def test_find_xpath_attr(self):
  417.         testxml = '''<root>
  418.             <node/>
  419.             <node x="a"/>
  420.             <node x="a" y="c" />
  421.             <node x="b" y="d" />
  422.             <node x="" />
  423.         </root>'''
  424.         doc = compat_etree_fromstring(testxml)
  426.         self.assertEqual(find_xpath_attr(doc, './/fourohfour', 'n'), None)
  427.         self.assertEqual(find_xpath_attr(doc, './/fourohfour', 'n', 'v'), None)
  428.         self.assertEqual(find_xpath_attr(doc, './/node', 'n'), None)
  429.         self.assertEqual(find_xpath_attr(doc, './/node', 'n', 'v'), None)
  430.         self.assertEqual(find_xpath_attr(doc, './/node', 'x'), doc[1])
  431.         self.assertEqual(find_xpath_attr(doc, './/node', 'x', 'a'), doc[1])
  432.         self.assertEqual(find_xpath_attr(doc, './/node', 'x', 'b'), doc[3])
  433.         self.assertEqual(find_xpath_attr(doc, './/node', 'y'), doc[2])
  434.         self.assertEqual(find_xpath_attr(doc, './/node', 'y', 'c'), doc[2])
  435.         self.assertEqual(find_xpath_attr(doc, './/node', 'y', 'd'), doc[3])
  436.         self.assertEqual(find_xpath_attr(doc, './/node', 'x', ''), doc[4])
  438.     def test_xpath_with_ns(self):
  439.         testxml = '''<root xmlns:media="http://example.com/">
  440.             <media:song>
  441.                 <media:author>The Author</media:author>
  442.                 <url>http://server.com/download.mp3</url>
  443.             </media:song>
  444.         </root>'''
  445.         doc = compat_etree_fromstring(testxml)
  446.         find = lambda p: doc.find(xpath_with_ns(p, {'media': 'http://example.com/'}))
  447.         self.assertTrue(find('media:song') is not None)
  448.         self.assertEqual(find('media:song/media:author').text, 'The Author')
  449.         self.assertEqual(find('media:song/url').text, 'http://server.com/download.mp3')
  451.     def test_xpath_element(self):
  452.         doc = xml.etree.ElementTree.Element('root')
  453.         div = xml.etree.ElementTree.SubElement(doc, 'div')
  454.         p = xml.etree.ElementTree.SubElement(div, 'p')
  455.         p.text = 'Foo'
  456.         self.assertEqual(xpath_element(doc, 'div/p'), p)
  457.         self.assertEqual(xpath_element(doc, ['div/p']), p)
  458.         self.assertEqual(xpath_element(doc, ['div/bar', 'div/p']), p)
  459.         self.assertEqual(xpath_element(doc, 'div/bar', default='default'), 'default')
  460.         self.assertEqual(xpath_element(doc, ['div/bar'], default='default'), 'default')
  461.         self.assertTrue(xpath_element(doc, 'div/bar') is None)
  462.         self.assertTrue(xpath_element(doc, ['div/bar']) is None)
  463.         self.assertTrue(xpath_element(doc, ['div/bar'], 'div/baz') is None)
  464.         self.assertRaises(ExtractorError, xpath_element, doc, 'div/bar', fatal=True)
  465.         self.assertRaises(ExtractorError, xpath_element, doc, ['div/bar'], fatal=True)
  466.         self.assertRaises(ExtractorError, xpath_element, doc, ['div/bar', 'div/baz'], fatal=True)
  468.     def test_xpath_text(self):
  469.         testxml = '''<root>
  470.             <div>
  471.                 <p>Foo</p>
  472.             </div>
  473.         </root>'''
  474.         doc = compat_etree_fromstring(testxml)
  475.         self.assertEqual(xpath_text(doc, 'div/p'), 'Foo')
  476.         self.assertEqual(xpath_text(doc, 'div/bar', default='default'), 'default')
  477.         self.assertTrue(xpath_text(doc, 'div/bar') is None)
  478.         self.assertRaises(ExtractorError, xpath_text, doc, 'div/bar', fatal=True)
  480.     def test_xpath_attr(self):
  481.         testxml = '''<root>
  482.             <div>
  483.                 <p x="a">Foo</p>
  484.             </div>
  485.         </root>'''
  486.         doc = compat_etree_fromstring(testxml)
  487.         self.assertEqual(xpath_attr(doc, 'div/p', 'x'), 'a')
  488.         self.assertEqual(xpath_attr(doc, 'div/bar', 'x'), None)
  489.         self.assertEqual(xpath_attr(doc, 'div/p', 'y'), None)
  490.         self.assertEqual(xpath_attr(doc, 'div/bar', 'x', default='default'), 'default')
  491.         self.assertEqual(xpath_attr(doc, 'div/p', 'y', default='default'), 'default')
  492.         self.assertRaises(ExtractorError, xpath_attr, doc, 'div/bar', 'x', fatal=True)
  493.         self.assertRaises(ExtractorError, xpath_attr, doc, 'div/p', 'y', fatal=True)
  495.     def test_smuggle_url(self):
  496.         data = {"ö": "ö", "abc": [3]}
  497.         url = 'https://foo.bar/baz?x=y#a'
  498.         smug_url = smuggle_url(url, data)
  499.         unsmug_url, unsmug_data = unsmuggle_url(smug_url)
  500.         self.assertEqual(url, unsmug_url)
  501.         self.assertEqual(data, unsmug_data)
  503.         res_url, res_data = unsmuggle_url(url)
  504.         self.assertEqual(res_url, url)
  505.         self.assertEqual(res_data, None)
  507.         smug_url = smuggle_url(url, {'a': 'b'})
  508.         smug_smug_url = smuggle_url(smug_url, {'c': 'd'})
  509.         res_url, res_data = unsmuggle_url(smug_smug_url)
  510.         self.assertEqual(res_url, url)
  511.         self.assertEqual(res_data, {'a': 'b', 'c': 'd'})
  513.     def test_shell_quote(self):
  514.         args = ['ffmpeg', '-i', encodeFilename('ñ€ß\'.mp4')]
  515.         self.assertEqual(
  516.             shell_quote(args),
  517.             """ffmpeg -i 'ñ€ß'"'"'.mp4'""" if compat_os_name != 'nt' else '''ffmpeg -i "ñ€ß'.mp4"''')
  519.     def test_float_or_none(self):
  520.         self.assertEqual(float_or_none('42.42'), 42.42)
  521.         self.assertEqual(float_or_none('42'), 42.0)
  522.         self.assertEqual(float_or_none(''), None)
  523.         self.assertEqual(float_or_none(None), None)
  524.         self.assertEqual(float_or_none([]), None)
  525.         self.assertEqual(float_or_none(set()), None)
  527.     def test_int_or_none(self):
  528.         self.assertEqual(int_or_none(42), 42)
  529.         self.assertEqual(int_or_none('42'), 42)
  530.         self.assertEqual(int_or_none(''), None)
  531.         self.assertEqual(int_or_none(None), None)
  532.         self.assertEqual(int_or_none([]), None)
  533.         self.assertEqual(int_or_none(set()), None)
  534.         self.assertEqual(int_or_none('42', base=8), 34)
  535.         self.assertRaises(TypeError, int_or_none(42, base=8))
  537.     def test_str_to_int(self):
  538.         self.assertEqual(str_to_int('123,456'), 123456)
  539.         self.assertEqual(str_to_int('123.456'), 123456)
  540.         self.assertEqual(str_to_int(523), 523)
  541.         # Python 3 has no long
  542.         if sys.version_info < (3, 0):
  543.             eval('self.assertEqual(str_to_int(123456L), 123456)')
  544.         self.assertEqual(str_to_int('noninteger'), None)
  545.         self.assertEqual(str_to_int([]), None)
  547.     def test_url_basename(self):
  548.         self.assertEqual(url_basename('http://foo.de/'), '')
  549.         self.assertEqual(url_basename('http://foo.de/bar/baz'), 'baz')
  550.         self.assertEqual(url_basename('http://foo.de/bar/baz?x=y'), 'baz')
  551.         self.assertEqual(url_basename('http://foo.de/bar/baz#x=y'), 'baz')
  552.         self.assertEqual(url_basename('http://foo.de/bar/baz/'), 'baz')
  553.         self.assertEqual(
  554.             url_basename('http://media.w3.org/2010/05/sintel/trailer.mp4'),
  555.             'trailer.mp4')
  557.     def test_base_url(self):
  558.         self.assertEqual(base_url('http://foo.de/'), 'http://foo.de/')
  559.         self.assertEqual(base_url('http://foo.de/bar'), 'http://foo.de/')
  560.         self.assertEqual(base_url('http://foo.de/bar/'), 'http://foo.de/bar/')
  561.         self.assertEqual(base_url('http://foo.de/bar/baz'), 'http://foo.de/bar/')
  562.         self.assertEqual(base_url('http://foo.de/bar/baz?x=z/x/c'), 'http://foo.de/bar/')
  564.     def test_urljoin(self):
  565.         self.assertEqual(urljoin('http://foo.de/', '/a/b/c.txt'), 'http://foo.de/a/b/c.txt')
  566.         self.assertEqual(urljoin(b'http://foo.de/', '/a/b/c.txt'), 'http://foo.de/a/b/c.txt')
  567.         self.assertEqual(urljoin('http://foo.de/', b'/a/b/c.txt'), 'http://foo.de/a/b/c.txt')
  568.         self.assertEqual(urljoin(b'http://foo.de/', b'/a/b/c.txt'), 'http://foo.de/a/b/c.txt')
  569.         self.assertEqual(urljoin('//foo.de/', '/a/b/c.txt'), '//foo.de/a/b/c.txt')
  570.         self.assertEqual(urljoin('http://foo.de/', 'a/b/c.txt'), 'http://foo.de/a/b/c.txt')
  571.         self.assertEqual(urljoin('http://foo.de', '/a/b/c.txt'), 'http://foo.de/a/b/c.txt')
  572.         self.assertEqual(urljoin('http://foo.de', 'a/b/c.txt'), 'http://foo.de/a/b/c.txt')
  573.         self.assertEqual(urljoin('http://foo.de/', 'http://foo.de/a/b/c.txt'), 'http://foo.de/a/b/c.txt')
  574.         self.assertEqual(urljoin('http://foo.de/', '//foo.de/a/b/c.txt'), '//foo.de/a/b/c.txt')
  575.         self.assertEqual(urljoin(None, 'http://foo.de/a/b/c.txt'), 'http://foo.de/a/b/c.txt')
  576.         self.assertEqual(urljoin(None, '//foo.de/a/b/c.txt'), '//foo.de/a/b/c.txt')
  577.         self.assertEqual(urljoin('', 'http://foo.de/a/b/c.txt'), 'http://foo.de/a/b/c.txt')
  578.         self.assertEqual(urljoin(['foobar'], 'http://foo.de/a/b/c.txt'), 'http://foo.de/a/b/c.txt')
  579.         self.assertEqual(urljoin('http://foo.de/', None), None)
  580.         self.assertEqual(urljoin('http://foo.de/', ''), None)
  581.         self.assertEqual(urljoin('http://foo.de/', ['foobar']), None)
  582.         self.assertEqual(urljoin('http://foo.de/a/b/c.txt', '.././../d.txt'), 'http://foo.de/d.txt')
  583.         self.assertEqual(urljoin('http://foo.de/a/b/c.txt', 'rtmp://foo.de'), 'rtmp://foo.de')
  584.         self.assertEqual(urljoin(None, 'rtmp://foo.de'), 'rtmp://foo.de')
  586.     def test_url_or_none(self):
  587.         self.assertEqual(url_or_none(None), None)
  588.         self.assertEqual(url_or_none(''), None)
  589.         self.assertEqual(url_or_none('foo'), None)
  590.         self.assertEqual(url_or_none('http://foo.de'), 'http://foo.de')
  591.         self.assertEqual(url_or_none('https://foo.de'), 'https://foo.de')
  592.         self.assertEqual(url_or_none('http$://foo.de'), None)
  593.         self.assertEqual(url_or_none('http://foo.de'), 'http://foo.de')
  594.         self.assertEqual(url_or_none('//foo.de'), '//foo.de')
  595.         self.assertEqual(url_or_none('s3://foo.de'), None)
  596.         self.assertEqual(url_or_none('rtmpte://foo.de'), 'rtmpte://foo.de')
  597.         self.assertEqual(url_or_none('mms://foo.de'), 'mms://foo.de')
  598.         self.assertEqual(url_or_none('rtspu://foo.de'), 'rtspu://foo.de')
  599.         self.assertEqual(url_or_none('ftps://foo.de'), 'ftps://foo.de')
  601.     def test_parse_age_limit(self):
  602.         self.assertEqual(parse_age_limit(None), None)
  603.         self.assertEqual(parse_age_limit(False), None)
  604.         self.assertEqual(parse_age_limit('invalid'), None)
  605.         self.assertEqual(parse_age_limit(0), 0)
  606.         self.assertEqual(parse_age_limit(18), 18)
  607.         self.assertEqual(parse_age_limit(21), 21)
  608.         self.assertEqual(parse_age_limit(22), None)
  609.         self.assertEqual(parse_age_limit('18'), 18)
  610.         self.assertEqual(parse_age_limit('18+'), 18)
  611.         self.assertEqual(parse_age_limit('PG-13'), 13)
  612.         self.assertEqual(parse_age_limit('TV-14'), 14)
  613.         self.assertEqual(parse_age_limit('TV-MA'), 17)
  614.         self.assertEqual(parse_age_limit('TV14'), 14)
  615.         self.assertEqual(parse_age_limit('TV_G'), 0)
  617.     def test_parse_duration(self):
  618.         self.assertEqual(parse_duration(None), None)
  619.         self.assertEqual(parse_duration(False), None)
  620.         self.assertEqual(parse_duration('invalid'), None)
  621.         self.assertEqual(parse_duration('1'), 1)
  622.         self.assertEqual(parse_duration('1337:12'), 80232)
  623.         self.assertEqual(parse_duration('9:12:43'), 33163)
  624.         self.assertEqual(parse_duration('12:00'), 720)
  625.         self.assertEqual(parse_duration('00:01:01'), 61)
  626.         self.assertEqual(parse_duration('x:y'), None)
  627.         self.assertEqual(parse_duration('3h11m53s'), 11513)
  628.         self.assertEqual(parse_duration('3h 11m 53s'), 11513)
  629.         self.assertEqual(parse_duration('3 hours 11 minutes 53 seconds'), 11513)
  630.         self.assertEqual(parse_duration('3 hours 11 mins 53 secs'), 11513)
  631.         self.assertEqual(parse_duration('62m45s'), 3765)
  632.         self.assertEqual(parse_duration('6m59s'), 419)
  633.         self.assertEqual(parse_duration('49s'), 49)
  634.         self.assertEqual(parse_duration('0h0m0s'), 0)
  635.         self.assertEqual(parse_duration('0m0s'), 0)
  636.         self.assertEqual(parse_duration('0s'), 0)
  637.         self.assertEqual(parse_duration('01:02:03.05'), 3723.05)
  638.         self.assertEqual(parse_duration('T30M38S'), 1838)
  639.         self.assertEqual(parse_duration('5 s'), 5)
  640.         self.assertEqual(parse_duration('3 min'), 180)
  641.         self.assertEqual(parse_duration('2.5 hours'), 9000)
  642.         self.assertEqual(parse_duration('02:03:04'), 7384)
  643.         self.assertEqual(parse_duration('01:02:03:04'), 93784)
  644.         self.assertEqual(parse_duration('1 hour 3 minutes'), 3780)
  645.         self.assertEqual(parse_duration('87 Min.'), 5220)
  646.         self.assertEqual(parse_duration('PT1H0.040S'), 3600.04)
  647.         self.assertEqual(parse_duration('PT00H03M30SZ'), 210)
  648.         self.assertEqual(parse_duration('P0Y0M0DT0H4M20.880S'), 260.88)
  650.     def test_fix_xml_ampersands(self):
  651.         self.assertEqual(
  652.             fix_xml_ampersands('"&x=y&z=a'), '"&amp;x=y&amp;z=a')
  653.         self.assertEqual(
  654.             fix_xml_ampersands('"&amp;x=y&wrong;&z=a'),
  655.             '"&amp;x=y&amp;wrong;&amp;z=a')
  656.         self.assertEqual(
  657.             fix_xml_ampersands('&amp;&apos;&gt;&lt;&quot;'),
  658.             '&amp;&apos;&gt;&lt;&quot;')
  659.         self.assertEqual(
  660.             fix_xml_ampersands('&#1234;&#x1abC;'), '&#1234;&#x1abC;')
  661.         self.assertEqual(fix_xml_ampersands('&#&#'), '&amp;#&amp;#')
  663.     def test_paged_list(self):
  664.         def testPL(size, pagesize, sliceargs, expected):
  665.             def get_page(pagenum):
  666.                 firstid = pagenum * pagesize
  667.                 upto = min(size, pagenum * pagesize + pagesize)
  668.                 for i in range(firstid, upto):
  669.                     yield i
  671.             pl = OnDemandPagedList(get_page, pagesize)
  672.             got = pl.getslice(*sliceargs)
  673.             self.assertEqual(got, expected)
  675.             iapl = InAdvancePagedList(get_page, size // pagesize + 1, pagesize)
  676.             got = iapl.getslice(*sliceargs)
  677.             self.assertEqual(got, expected)
  679.         testPL(5, 2, (), [0, 1, 2, 3, 4])
  680.         testPL(5, 2, (1,), [1, 2, 3, 4])
  681.         testPL(5, 2, (2,), [2, 3, 4])
  682.         testPL(5, 2, (4,), [4])
  683.         testPL(5, 2, (0, 3), [0, 1, 2])
  684.         testPL(5, 2, (1, 4), [1, 2, 3])
  685.         testPL(5, 2, (2, 99), [2, 3, 4])
  686.         testPL(5, 2, (20, 99), [])
  688.     def test_read_batch_urls(self):
  689.         f = io.StringIO('''\xef\xbb\xbf foo
  690.             bar\r
  691.             baz
  692.             # More after this line\r
  693.             ; or after this
  694.             bam''')
  695.         self.assertEqual(read_batch_urls(f), ['foo', 'bar', 'baz', 'bam'])
  697.     def test_urlencode_postdata(self):
  698.         data = urlencode_postdata({'username': 'foo@bar.com', 'password': '1234'})
  699.         self.assertTrue(isinstance(data, bytes))
  701.     def test_update_url_query(self):
  702.         self.assertEqual(parse_qs(update_url_query(
  703.             'http://example.com/path', {'quality': ['HD'], 'format': ['mp4']})),
  704.             parse_qs('http://example.com/path?quality=HD&format=mp4'))
  705.         self.assertEqual(parse_qs(update_url_query(
  706.             'http://example.com/path', {'system': ['LINUX', 'WINDOWS']})),
  707.             parse_qs('http://example.com/path?system=LINUX&system=WINDOWS'))
  708.         self.assertEqual(parse_qs(update_url_query(
  709.             'http://example.com/path', {'fields': 'id,formats,subtitles'})),
  710.             parse_qs('http://example.com/path?fields=id,formats,subtitles'))
  711.         self.assertEqual(parse_qs(update_url_query(
  712.             'http://example.com/path', {'fields': ('id,formats,subtitles', 'thumbnails')})),
  713.             parse_qs('http://example.com/path?fields=id,formats,subtitles&fields=thumbnails'))
  714.         self.assertEqual(parse_qs(update_url_query(
  715.             'http://example.com/path?manifest=f4m', {'manifest': []})),
  716.             parse_qs('http://example.com/path'))
  717.         self.assertEqual(parse_qs(update_url_query(
  718.             'http://example.com/path?system=LINUX&system=WINDOWS', {'system': 'LINUX'})),
  719.             parse_qs('http://example.com/path?system=LINUX'))
  720.         self.assertEqual(parse_qs(update_url_query(
  721.             'http://example.com/path', {'fields': b'id,formats,subtitles'})),
  722.             parse_qs('http://example.com/path?fields=id,formats,subtitles'))
  723.         self.assertEqual(parse_qs(update_url_query(
  724.             'http://example.com/path', {'width': 1080, 'height': 720})),
  725.             parse_qs('http://example.com/path?width=1080&height=720'))
  726.         self.assertEqual(parse_qs(update_url_query(
  727.             'http://example.com/path', {'bitrate': 5020.43})),
  728.             parse_qs('http://example.com/path?bitrate=5020.43'))
  729.         self.assertEqual(parse_qs(update_url_query(
  730.             'http://example.com/path', {'test': '第二行тест'})),
  731.             parse_qs('http://example.com/path?test=%E7%AC%AC%E4%BA%8C%E8%A1%8C%D1%82%D0%B5%D1%81%D1%82'))
  733.     def test_multipart_encode(self):
  734.         self.assertEqual(
  735.             multipart_encode({b'field': b'value'}, boundary='AAAAAA')[0],
  736.             b'--AAAAAA\r\nContent-Disposition: form-data; name="field"\r\n\r\nvalue\r\n--AAAAAA--\r\n')
  737.         self.assertEqual(
  738.             multipart_encode({'欄位'.encode('utf-8'): '值'.encode('utf-8')}, boundary='AAAAAA')[0],
  739.             b'--AAAAAA\r\nContent-Disposition: form-data; name="\xe6\xac\x84\xe4\xbd\x8d"\r\n\r\n\xe5\x80\xbc\r\n--AAAAAA--\r\n')
  740.         self.assertRaises(
  741.             ValueError, multipart_encode, {b'field': b'value'}, boundary='value')
  743.     def test_dict_get(self):
  744.         FALSE_VALUES = {
  745.             'none': None,
  746.             'false': False,
  747.             'zero': 0,
  748.             'empty_string': '',
  749.             'empty_list': [],
  750.         }
  751.         d = FALSE_VALUES.copy()
  752.         d['a'] = 42
  753.         self.assertEqual(dict_get(d, 'a'), 42)
  754.         self.assertEqual(dict_get(d, 'b'), None)
  755.         self.assertEqual(dict_get(d, 'b', 42), 42)
  756.         self.assertEqual(dict_get(d, ('a', )), 42)
  757.         self.assertEqual(dict_get(d, ('b', 'a', )), 42)
  758.         self.assertEqual(dict_get(d, ('b', 'c', 'a', 'd', )), 42)
  759.         self.assertEqual(dict_get(d, ('b', 'c', )), None)
  760.         self.assertEqual(dict_get(d, ('b', 'c', ), 42), 42)
  761.         for key, false_value in FALSE_VALUES.items():
  762.             self.assertEqual(dict_get(d, ('b', 'c', key, )), None)
  763.             self.assertEqual(dict_get(d, ('b', 'c', key, ), skip_false_values=False), false_value)
  765.     def test_merge_dicts(self):
  766.         self.assertEqual(merge_dicts({'a': 1}, {'b': 2}), {'a': 1, 'b': 2})
  767.         self.assertEqual(merge_dicts({'a': 1}, {'a': 2}), {'a': 1})
  768.         self.assertEqual(merge_dicts({'a': 1}, {'a': None}), {'a': 1})
  769.         self.assertEqual(merge_dicts({'a': 1}, {'a': ''}), {'a': 1})
  770.         self.assertEqual(merge_dicts({'a': 1}, {}), {'a': 1})
  771.         self.assertEqual(merge_dicts({'a': None}, {'a': 1}), {'a': 1})
  772.         self.assertEqual(merge_dicts({'a': ''}, {'a': 1}), {'a': ''})
  773.         self.assertEqual(merge_dicts({'a': ''}, {'a': 'abc'}), {'a': 'abc'})
  774.         self.assertEqual(merge_dicts({'a': None}, {'a': ''}, {'a': 'abc'}), {'a': 'abc'})
  776.     def test_encode_compat_str(self):
  777.         self.assertEqual(encode_compat_str(b'\xd1\x82\xd0\xb5\xd1\x81\xd1\x82', 'utf-8'), 'тест')
  778.         self.assertEqual(encode_compat_str('тест', 'utf-8'), 'тест')
  780.     def test_parse_iso8601(self):
  781.         self.assertEqual(parse_iso8601('2014-03-23T23:04:26+0100'), 1395612266)
  782.         self.assertEqual(parse_iso8601('2014-03-23T22:04:26+0000'), 1395612266)
  783.         self.assertEqual(parse_iso8601('2014-03-23T22:04:26Z'), 1395612266)
  784.         self.assertEqual(parse_iso8601('2014-03-23T22:04:26.1234Z'), 1395612266)
  785.         self.assertEqual(parse_iso8601('2015-09-29T08:27:31.727'), 1443515251)
  786.         self.assertEqual(parse_iso8601('2015-09-29T08-27-31.727'), None)
  788.     def test_strip_jsonp(self):
  789.         stripped = strip_jsonp('cb ([ {"id":"532cb",\n\n\n"x":\n3}\n]\n);')
  790.         d = json.loads(stripped)
  791.         self.assertEqual(d, [{"id": "532cb", "x": 3}])
  793.         stripped = strip_jsonp('parseMetadata({"STATUS":"OK"})\n\n\n//epc')
  794.         d = json.loads(stripped)
  795.         self.assertEqual(d, {'STATUS': 'OK'})
  797.         stripped = strip_jsonp('ps.embedHandler({"status": "success"});')
  798.         d = json.loads(stripped)
  799.         self.assertEqual(d, {'status': 'success'})
  801.         stripped = strip_jsonp('window.cb && window.cb({"status": "success"});')
  802.         d = json.loads(stripped)
  803.         self.assertEqual(d, {'status': 'success'})
  805.         stripped = strip_jsonp('window.cb && cb({"status": "success"});')
  806.         d = json.loads(stripped)
  807.         self.assertEqual(d, {'status': 'success'})
  809.         stripped = strip_jsonp('({"status": "success"});')
  810.         d = json.loads(stripped)
  811.         self.assertEqual(d, {'status': 'success'})
  813.     def test_strip_or_none(self):
  814.         self.assertEqual(strip_or_none(' abc'), 'abc')
  815.         self.assertEqual(strip_or_none('abc '), 'abc')
  816.         self.assertEqual(strip_or_none(' abc '), 'abc')
  817.         self.assertEqual(strip_or_none('\tabc\t'), 'abc')
  818.         self.assertEqual(strip_or_none('\n\tabc\n\t'), 'abc')
  819.         self.assertEqual(strip_or_none('abc'), 'abc')
  820.         self.assertEqual(strip_or_none(''), '')
  821.         self.assertEqual(strip_or_none(None), None)
  822.         self.assertEqual(strip_or_none(42), None)
  823.         self.assertEqual(strip_or_none([]), None)
  825.     def test_uppercase_escape(self):
  826.         self.assertEqual(uppercase_escape('aä'), 'aä')
  827.         self.assertEqual(uppercase_escape('\\U0001d550'), '𝕐')
  829.     def test_lowercase_escape(self):
  830.         self.assertEqual(lowercase_escape('aä'), 'aä')
  831.         self.assertEqual(lowercase_escape('\\u0026'), '&')
  833.     def test_limit_length(self):
  834.         self.assertEqual(limit_length(None, 12), None)
  835.         self.assertEqual(limit_length('foo', 12), 'foo')
  836.         self.assertTrue(
  837.             limit_length('foo bar baz asd', 12).startswith('foo bar'))
  838.         self.assertTrue('...' in limit_length('foo bar baz asd', 12))
  840.     def test_mimetype2ext(self):
  841.         self.assertEqual(mimetype2ext(None), None)
  842.         self.assertEqual(mimetype2ext('video/x-flv'), 'flv')
  843.         self.assertEqual(mimetype2ext('application/x-mpegURL'), 'm3u8')
  844.         self.assertEqual(mimetype2ext('text/vtt'), 'vtt')
  845.         self.assertEqual(mimetype2ext('text/vtt;charset=utf-8'), 'vtt')
  846.         self.assertEqual(mimetype2ext('text/html; charset=utf-8'), 'html')
  847.         self.assertEqual(mimetype2ext('audio/x-wav'), 'wav')
  848.         self.assertEqual(mimetype2ext('audio/x-wav;codec=pcm'), 'wav')
  850.     def test_month_by_name(self):
  851.         self.assertEqual(month_by_name(None), None)
  852.         self.assertEqual(month_by_name('December', 'en'), 12)
  853.         self.assertEqual(month_by_name('décembre', 'fr'), 12)
  854.         self.assertEqual(month_by_name('December'), 12)
  855.         self.assertEqual(month_by_name('décembre'), None)
  856.         self.assertEqual(month_by_name('Unknown', 'unknown'), None)
  858.     def test_parse_codecs(self):
  859.         self.assertEqual(parse_codecs(''), {})
  860.         self.assertEqual(parse_codecs('avc1.77.30, mp4a.40.2'), {
  861.             'vcodec': 'avc1.77.30',
  862.             'acodec': 'mp4a.40.2',
  863.         })
  864.         self.assertEqual(parse_codecs('mp4a.40.2'), {
  865.             'vcodec': 'none',
  866.             'acodec': 'mp4a.40.2',
  867.         })
  868.         self.assertEqual(parse_codecs('mp4a.40.5,avc1.42001e'), {
  869.             'vcodec': 'avc1.42001e',
  870.             'acodec': 'mp4a.40.5',
  871.         })
  872.         self.assertEqual(parse_codecs('avc3.640028'), {
  873.             'vcodec': 'avc3.640028',
  874.             'acodec': 'none',
  875.         })
  876.         self.assertEqual(parse_codecs(', h264,,newcodec,aac'), {
  877.             'vcodec': 'h264',
  878.             'acodec': 'aac',
  879.         })
  880.         self.assertEqual(parse_codecs('av01.0.05M.08'), {
  881.             'vcodec': 'av01.0.05M.08',
  882.             'acodec': 'none',
  883.         })
  884.         self.assertEqual(parse_codecs('theora, vorbis'), {
  885.             'vcodec': 'theora',
  886.             'acodec': 'vorbis',
  887.         })
  888.         self.assertEqual(parse_codecs('unknownvcodec, unknownacodec'), {
  889.             'vcodec': 'unknownvcodec',
  890.             'acodec': 'unknownacodec',
  891.         })
  892.         self.assertEqual(parse_codecs('unknown'), {})
  894.     def test_escape_rfc3986(self):
  895.         reserved = "!*'();:@&=+$,/?#[]"
  896.         unreserved = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_.~'
  897.         self.assertEqual(escape_rfc3986(reserved), reserved)
  898.         self.assertEqual(escape_rfc3986(unreserved), unreserved)
  899.         self.assertEqual(escape_rfc3986('тест'), '%D1%82%D0%B5%D1%81%D1%82')
  900.         self.assertEqual(escape_rfc3986('%D1%82%D0%B5%D1%81%D1%82'), '%D1%82%D0%B5%D1%81%D1%82')
  901.         self.assertEqual(escape_rfc3986('foo bar'), 'foo%20bar')
  902.         self.assertEqual(escape_rfc3986('foo%20bar'), 'foo%20bar')
  904.     def test_escape_url(self):
  905.         self.assertEqual(
  906.             escape_url('http://wowza.imust.org/srv/vod/telemb/new/UPLOAD/UPLOAD/20224_IncendieHavré_FD.mp4'),
  907.             'http://wowza.imust.org/srv/vod/telemb/new/UPLOAD/UPLOAD/20224_IncendieHavre%CC%81_FD.mp4'
  908.         )
  909.         self.assertEqual(
  910.             escape_url('http://www.ardmediathek.de/tv/Sturm-der-Liebe/Folge-2036-Zu-Mann-und-Frau-erklärt/Das-Erste/Video?documentId=22673108&bcastId=5290'),
  911.             'http://www.ardmediathek.de/tv/Sturm-der-Liebe/Folge-2036-Zu-Mann-und-Frau-erkl%C3%A4rt/Das-Erste/Video?documentId=22673108&bcastId=5290'
  912.         )
  913.         self.assertEqual(
  914.             escape_url('http://тест.рф/фрагмент'),
  915.             'http://xn--e1aybc.xn--p1ai/%D1%84%D1%80%D0%B0%D0%B3%D0%BC%D0%B5%D0%BD%D1%82'
  916.         )
  917.         self.assertEqual(
  918.             escape_url('http://тест.рф/абв?абв=абв#абв'),
  919.             'http://xn--e1aybc.xn--p1ai/%D0%B0%D0%B1%D0%B2?%D0%B0%D0%B1%D0%B2=%D0%B0%D0%B1%D0%B2#%D0%B0%D0%B1%D0%B2'
  920.         )
  921.         self.assertEqual(escape_url('http://vimeo.com/56015672#at=0'), 'http://vimeo.com/56015672#at=0')
  923.     def test_remove_dot_segments(self):
  925.         def remove_dot_segments(p):
  926.             q = '' if p.startswith('/') else '/'
  927.             p = 'http://example.com' + q + p
  928.             p = compat_urlparse.urlsplit(YoutubeDLHandler._fix_path(p)).path
  929.             return p[1:] if q else p
  931.         self.assertEqual(remove_dot_segments('/a/b/c/./../../g'), '/a/g')
  932.         self.assertEqual(remove_dot_segments('mid/content=5/../6'), 'mid/6')
  933.         self.assertEqual(remove_dot_segments('/ad/../cd'), '/cd')
  934.         self.assertEqual(remove_dot_segments('/ad/../cd/'), '/cd/')
  935.         self.assertEqual(remove_dot_segments('/..'), '/')
  936.         self.assertEqual(remove_dot_segments('/./'), '/')
  937.         self.assertEqual(remove_dot_segments('/./a'), '/a')
  938.         self.assertEqual(remove_dot_segments('/abc/./.././d/././e/.././f/./../../ghi'), '/ghi')
  939.         self.assertEqual(remove_dot_segments('/'), '/')
  940.         self.assertEqual(remove_dot_segments('/t'), '/t')
  941.         self.assertEqual(remove_dot_segments('t'), 't')
  942.         self.assertEqual(remove_dot_segments(''), '')
  943.         self.assertEqual(remove_dot_segments('/../a/b/c'), '/a/b/c')
  944.         self.assertEqual(remove_dot_segments('../a'), 'a')
  945.         self.assertEqual(remove_dot_segments('./a'), 'a')
  946.         self.assertEqual(remove_dot_segments('.'), '')
  947.         self.assertEqual(remove_dot_segments('////'), '////')
  949.     def test_js_to_json_vars_strings(self):
  950.         self.assertDictEqual(
  951.             json.loads(js_to_json(
  952.                 '''{
  953.                     'null': a,
  954.                     'nullStr': b,
  955.                     'true': c,
  956.                     'trueStr': d,
  957.                     'false': e,
  958.                     'falseStr': f,
  959.                     'unresolvedVar': g,
  960.                 }''',
  961.                 {
  962.                     'a': 'null',
  963.                     'b': '"null"',
  964.                     'c': 'true',
  965.                     'd': '"true"',
  966.                     'e': 'false',
  967.                     'f': '"false"',
  968.                     'g': 'var',
  969.                 }
  970.             )),
  971.             {
  972.                 'null': None,
  973.                 'nullStr': 'null',
  974.                 'true': True,
  975.                 'trueStr': 'true',
  976.                 'false': False,
  977.                 'falseStr': 'false',
  978.                 'unresolvedVar': 'var'
  979.             }
  980.         )
  982.         self.assertDictEqual(
  983.             json.loads(js_to_json(
  984.                 '''{
  985.                     'int': a,
  986.                     'intStr': b,
  987.                     'float': c,
  988.                     'floatStr': d,
  989.                 }''',
  990.                 {
  991.                     'a': '123',
  992.                     'b': '"123"',
  993.                     'c': '1.23',
  994.                     'd': '"1.23"',
  995.                 }
  996.             )),
  997.             {
  998.                 'int': 123,
  999.                 'intStr': '123',
  1000.                 'float': 1.23,
  1001.                 'floatStr': '1.23',
  1002.             }
  1003.         )
  1005.         self.assertDictEqual(
  1006.             json.loads(js_to_json(
  1007.                 '''{
  1008.                     'object': a,
  1009.                     'objectStr': b,
  1010.                     'array': c,
  1011.                     'arrayStr': d,
  1012.                 }''',
  1013.                 {
  1014.                     'a': '{}',
  1015.                     'b': '"{}"',
  1016.                     'c': '[]',
  1017.                     'd': '"[]"',
  1018.                 }
  1019.             )),
  1020.             {
  1021.                 'object': {},
  1022.                 'objectStr': '{}',
  1023.                 'array': [],
  1024.                 'arrayStr': '[]',
  1025.             }
  1026.         )
  1028.     def test_js_to_json_realworld(self):
  1029.         inp = '''{
  1030.             'clip':{'provider':'pseudo'}
  1031.         }'''
  1032.         self.assertEqual(js_to_json(inp), '''{
  1033.             "clip":{"provider":"pseudo"}
  1034.         }''')
  1035.         json.loads(js_to_json(inp))
  1037.         inp = '''{
  1038.             'playlist':[{'controls':{'all':null}}]
  1039.         }'''
  1040.         self.assertEqual(js_to_json(inp), '''{
  1041.             "playlist":[{"controls":{"all":null}}]
  1042.         }''')
  1044.         inp = '''"The CW\\'s \\'Crazy Ex-Girlfriend\\'"'''
  1045.         self.assertEqual(js_to_json(inp), '''"The CW's 'Crazy Ex-Girlfriend'"''')
  1047.         inp = '"SAND Number: SAND 2013-7800P\\nPresenter: Tom Russo\\nHabanero Software Training - Xyce Software\\nXyce, Sandia\\u0027s"'
  1048.         json_code = js_to_json(inp)
  1049.         self.assertEqual(json.loads(json_code), json.loads(inp))
  1051.         inp = '''{
  1052.             0:{src:'skipped', type: 'application/dash+xml'},
  1053.             1:{src:'skipped', type: 'application/vnd.apple.mpegURL'},
  1054.         }'''
  1055.         self.assertEqual(js_to_json(inp), '''{
  1056.             "0":{"src":"skipped", "type": "application/dash+xml"},
  1057.             "1":{"src":"skipped", "type": "application/vnd.apple.mpegURL"}
  1058.         }''')
  1060.         inp = '''{"foo":101}'''
  1061.         self.assertEqual(js_to_json(inp), '''{"foo":101}''')
  1063.         inp = '''{"duration": "00:01:07"}'''
  1064.         self.assertEqual(js_to_json(inp), '''{"duration": "00:01:07"}''')
  1066.         inp = '''{segments: [{"offset":-3.885780586188048e-16,"duration":39.75000000000001}]}'''
  1067.         self.assertEqual(js_to_json(inp), '''{"segments": [{"offset":-3.885780586188048e-16,"duration":39.75000000000001}]}''')
  1069.     def test_js_to_json_edgecases(self):
  1070.         on = js_to_json("{abc_def:'1\\'\\\\2\\\\\\'3\"4'}")
  1071.         self.assertEqual(json.loads(on), {"abc_def": "1'\\2\\'3\"4"})
  1073.         on = js_to_json('{"abc": true}')
  1074.         self.assertEqual(json.loads(on), {'abc': True})
  1076.         # Ignore JavaScript code as well
  1077.         on = js_to_json('''{
  1078.             "x": 1,
  1079.             y: "a",
  1080.             z: some.code
  1081.         }''')
  1082.         d = json.loads(on)
  1083.         self.assertEqual(d['x'], 1)
  1084.         self.assertEqual(d['y'], 'a')
  1086.         # Just drop ! prefix for now though this results in a wrong value
  1087.         on = js_to_json('''{
  1088.             a: !0,
  1089.             b: !1,
  1090.             c: !!0,
  1091.             d: !!42.42,
  1092.             e: !!![],
  1093.             f: !"abc",
  1094.             g: !"",
  1095.             !42: 42
  1096.         }''')
  1097.         self.assertEqual(json.loads(on), {
  1098.             'a': True,
  1099.             'b': False,
  1100.             'c': False,
  1101.             'd': True,
  1102.             'e': [],
  1103.             'f': "abc",
  1104.             'g': "",
  1105.             '42': 42
  1106.         })
  1108.         on = js_to_json('["abc", "def",]')
  1109.         self.assertEqual(json.loads(on), ['abc', 'def'])
  1111.         on = js_to_json('[/*comment\n*/"abc"/*comment\n*/,/*comment\n*/"def",/*comment\n*/]')
  1112.         self.assertEqual(json.loads(on), ['abc', 'def'])
  1114.         on = js_to_json('[//comment\n"abc" //comment\n,//comment\n"def",//comment\n]')
  1115.         self.assertEqual(json.loads(on), ['abc', 'def'])
  1117.         on = js_to_json('{"abc": "def",}')
  1118.         self.assertEqual(json.loads(on), {'abc': 'def'})
  1120.         on = js_to_json('{/*comment\n*/"abc"/*comment\n*/:/*comment\n*/"def"/*comment\n*/,/*comment\n*/}')
  1121.         self.assertEqual(json.loads(on), {'abc': 'def'})
  1123.         on = js_to_json('{ 0: /* " \n */ ",]" , }')
  1124.         self.assertEqual(json.loads(on), {'0': ',]'})
  1126.         on = js_to_json('{ /*comment\n*/0/*comment\n*/: /* " \n */ ",]" , }')
  1127.         self.assertEqual(json.loads(on), {'0': ',]'})
  1129.         on = js_to_json('{ 0: // comment\n1 }')
  1130.         self.assertEqual(json.loads(on), {'0': 1})
  1132.         on = js_to_json(r'["<p>x<\/p>"]')
  1133.         self.assertEqual(json.loads(on), ['<p>x</p>'])
  1135.         on = js_to_json(r'["\xaa"]')
  1136.         self.assertEqual(json.loads(on), ['\u00aa'])
  1138.         on = js_to_json("['a\\\nb']")
  1139.         self.assertEqual(json.loads(on), ['ab'])
  1141.         on = js_to_json("/*comment\n*/[/*comment\n*/'a\\\nb'/*comment\n*/]/*comment\n*/")
  1142.         self.assertEqual(json.loads(on), ['ab'])
  1144.         on = js_to_json('{0xff:0xff}')
  1145.         self.assertEqual(json.loads(on), {'255': 255})
  1147.         on = js_to_json('{/*comment\n*/0xff/*comment\n*/:/*comment\n*/0xff/*comment\n*/}')
  1148.         self.assertEqual(json.loads(on), {'255': 255})
  1150.         on = js_to_json('{077:077}')
  1151.         self.assertEqual(json.loads(on), {'63': 63})
  1153.         on = js_to_json('{/*comment\n*/077/*comment\n*/:/*comment\n*/077/*comment\n*/}')
  1154.         self.assertEqual(json.loads(on), {'63': 63})
  1156.         on = js_to_json('{42:42}')
  1157.         self.assertEqual(json.loads(on), {'42': 42})
  1159.         on = js_to_json('{/*comment\n*/42/*comment\n*/:/*comment\n*/42/*comment\n*/}')
  1160.         self.assertEqual(json.loads(on), {'42': 42})
  1162.         on = js_to_json('{42:4.2e1}')
  1163.         self.assertEqual(json.loads(on), {'42': 42.0})
  1165.         on = js_to_json('{ "0x40": "0x40" }')
  1166.         self.assertEqual(json.loads(on), {'0x40': '0x40'})
  1168.         on = js_to_json('{ "040": "040" }')
  1169.         self.assertEqual(json.loads(on), {'040': '040'})
  1171.         on = js_to_json('[1,//{},\n2]')
  1172.         self.assertEqual(json.loads(on), [1, 2])
  1174.         on = js_to_json(r'"\^\$\#"')
  1175.         self.assertEqual(json.loads(on), R'^$#', msg='Unnecessary escapes should be stripped')
  1177.         on = js_to_json('\'"\\""\'')
  1178.         self.assertEqual(json.loads(on), '"""', msg='Unnecessary quote escape should be escaped')
  1180.     def test_js_to_json_malformed(self):
  1181.         self.assertEqual(js_to_json('42a1'), '42"a1"')
  1182.         self.assertEqual(js_to_json('42a-1'), '42"a"-1')
  1184.     def test_js_to_json_template_literal(self):
  1185.         self.assertEqual(js_to_json('`Hello ${name}`', {'name': '"world"'}), '"Hello world"')
  1186.         self.assertEqual(js_to_json('`${name}${name}`', {'name': '"X"'}), '"XX"')
  1187.         self.assertEqual(js_to_json('`${name}${name}`', {'name': '5'}), '"55"')
  1188.         self.assertEqual(js_to_json('`${name}"${name}"`', {'name': '5'}), '"5\\"5\\""')
  1189.         self.assertEqual(js_to_json('`${name}`', {}), '"name"')
  1191.     def test_extract_attributes(self):
  1192.         self.assertEqual(extract_attributes('<e x="y">'), {'x': 'y'})
  1193.         self.assertEqual(extract_attributes("<e x='y'>"), {'x': 'y'})
  1194.         self.assertEqual(extract_attributes('<e x=y>'), {'x': 'y'})
  1195.         self.assertEqual(extract_attributes('<e x="a \'b\' c">'), {'x': "a 'b' c"})
  1196.         self.assertEqual(extract_attributes('<e x=\'a "b" c\'>'), {'x': 'a "b" c'})
  1197.         self.assertEqual(extract_attributes('<e x="&#121;">'), {'x': 'y'})
  1198.         self.assertEqual(extract_attributes('<e x="&#x79;">'), {'x': 'y'})
  1199.         self.assertEqual(extract_attributes('<e x="&amp;">'), {'x': '&'})  # XML
  1200.         self.assertEqual(extract_attributes('<e x="&quot;">'), {'x': '"'})
  1201.         self.assertEqual(extract_attributes('<e x="&pound;">'), {'x': '£'})  # HTML 3.2
  1202.         self.assertEqual(extract_attributes('<e x="&lambda;">'), {'x': 'λ'})  # HTML 4.0
  1203.         self.assertEqual(extract_attributes('<e x="&foo">'), {'x': '&foo'})
  1204.         self.assertEqual(extract_attributes('<e x="\'">'), {'x': "'"})
  1205.         self.assertEqual(extract_attributes('<e x=\'"\'>'), {'x': '"'})
  1206.         self.assertEqual(extract_attributes('<e x >'), {'x': None})
  1207.         self.assertEqual(extract_attributes('<e x=y a>'), {'x': 'y', 'a': None})
  1208.         self.assertEqual(extract_attributes('<e x= y>'), {'x': 'y'})
  1209.         self.assertEqual(extract_attributes('<e x=1 y=2 x=3>'), {'y': '2', 'x': '3'})
  1210.         self.assertEqual(extract_attributes('<e \nx=\ny\n>'), {'x': 'y'})
  1211.         self.assertEqual(extract_attributes('<e \nx=\n"y"\n>'), {'x': 'y'})
  1212.         self.assertEqual(extract_attributes("<e \nx=\n'y'\n>"), {'x': 'y'})
  1213.         self.assertEqual(extract_attributes('<e \nx="\ny\n">'), {'x': '\ny\n'})
  1214.         self.assertEqual(extract_attributes('<e CAPS=x>'), {'caps': 'x'})  # Names lowercased
  1215.         self.assertEqual(extract_attributes('<e x=1 X=2>'), {'x': '2'})
  1216.         self.assertEqual(extract_attributes('<e X=1 x=2>'), {'x': '2'})
  1217.         self.assertEqual(extract_attributes('<e _:funny-name1=1>'), {'_:funny-name1': '1'})
  1218.         self.assertEqual(extract_attributes('<e x="Fáilte 世界 \U0001f600">'), {'x': 'Fáilte 世界 \U0001f600'})
  1219.         self.assertEqual(extract_attributes('<e x="décompose&#769;">'), {'x': 'décompose\u0301'})
  1220.         # "Narrow" Python builds don't support unicode code points outside BMP.
  1221.         try:
  1222.             compat_chr(0x10000)
  1223.             supports_outside_bmp = True
  1224.         except ValueError:
  1225.             supports_outside_bmp = False
  1226.         if supports_outside_bmp:
  1227.             self.assertEqual(extract_attributes('<e x="Smile &#128512;!">'), {'x': 'Smile \U0001f600!'})
  1228.         # Malformed HTML should not break attributes extraction on older Python
  1229.         self.assertEqual(extract_attributes('<mal"formed/>'), {})
  1231.     def test_clean_html(self):
  1232.         self.assertEqual(clean_html('a:\nb'), 'a: b')
  1233.         self.assertEqual(clean_html('a:\n   "b"'), 'a:    "b"')
  1234.         self.assertEqual(clean_html('a<br>\xa0b'), 'a\nb')
  1236.     def test_intlist_to_bytes(self):
  1237.         self.assertEqual(
  1238.             intlist_to_bytes([0, 1, 127, 128, 255]),
  1239.             b'\x00\x01\x7f\x80\xff')
  1241.     def test_args_to_str(self):
  1242.         self.assertEqual(
  1243.             args_to_str(['foo', 'ba/r', '-baz', '2 be', '']),
  1244.             'foo ba/r -baz \'2 be\' \'\'' if compat_os_name != 'nt' else 'foo ba/r -baz "2 be" ""'
  1245.         )
  1247.     def test_parse_filesize(self):
  1248.         self.assertEqual(parse_filesize(None), None)
  1249.         self.assertEqual(parse_filesize(''), None)
  1250.         self.assertEqual(parse_filesize('91 B'), 91)
  1251.         self.assertEqual(parse_filesize('foobar'), None)
  1252.         self.assertEqual(parse_filesize('2 MiB'), 2097152)
  1253.         self.assertEqual(parse_filesize('5 GB'), 5000000000)
  1254.         self.assertEqual(parse_filesize('1.2Tb'), 1200000000000)
  1255.         self.assertEqual(parse_filesize('1.2tb'), 1200000000000)
  1256.         self.assertEqual(parse_filesize('1,24 KB'), 1240)
  1257.         self.assertEqual(parse_filesize('1,24 kb'), 1240)
  1258.         self.assertEqual(parse_filesize('8.5 megabytes'), 8500000)
  1260.     def test_parse_count(self):
  1261.         self.assertEqual(parse_count(None), None)
  1262.         self.assertEqual(parse_count(''), None)
  1263.         self.assertEqual(parse_count('0'), 0)
  1264.         self.assertEqual(parse_count('1000'), 1000)
  1265.         self.assertEqual(parse_count('1.000'), 1000)
  1266.         self.assertEqual(parse_count('1.1k'), 1100)
  1267.         self.assertEqual(parse_count('1.1kk'), 1100000)
  1268.         self.assertEqual(parse_count('1.1kk '), 1100000)
  1269.         self.assertEqual(parse_count('1.1kk views'), 1100000)
  1271.     def test_parse_resolution(self):
  1272.         self.assertEqual(parse_resolution(None), {})
  1273.         self.assertEqual(parse_resolution(''), {})
  1274.         self.assertEqual(parse_resolution('1920x1080'), {'width': 1920, 'height': 1080})
  1275.         self.assertEqual(parse_resolution('1920×1080'), {'width': 1920, 'height': 1080})
  1276.         self.assertEqual(parse_resolution('1920 x 1080'), {'width': 1920, 'height': 1080})
  1277.         self.assertEqual(parse_resolution('720p'), {'height': 720})
  1278.         self.assertEqual(parse_resolution('4k'), {'height': 2160})
  1279.         self.assertEqual(parse_resolution('8K'), {'height': 4320})
  1281.     def test_parse_bitrate(self):
  1282.         self.assertEqual(parse_bitrate(None), None)
  1283.         self.assertEqual(parse_bitrate(''), None)
  1284.         self.assertEqual(parse_bitrate('300kbps'), 300)
  1285.         self.assertEqual(parse_bitrate('1500kbps'), 1500)
  1286.         self.assertEqual(parse_bitrate('300 kbps'), 300)
  1288.     def test_version_tuple(self):
  1289.         self.assertEqual(version_tuple('1'), (1,))
  1290.         self.assertEqual(version_tuple('10.23.344'), (10, 23, 344))
  1291.         self.assertEqual(version_tuple('10.1-6'), (10, 1, 6))  # avconv style
  1293.     def test_detect_exe_version(self):
  1294.         self.assertEqual(detect_exe_version('''ffmpeg version 1.2.1
  1295. built on May 27 2013 08:37:26 with gcc 4.7 (Debian 4.7.3-4)
  1296. configuration: --prefix=/usr --extra-'''), '1.2.1')
  1297.         self.assertEqual(detect_exe_version('''ffmpeg version N-63176-g1fb4685
  1298. built on May 15 2014 22:09:06 with gcc 4.8.2 (GCC)'''), 'N-63176-g1fb4685')
  1299.         self.assertEqual(detect_exe_version('''X server found. dri2 connection failed!
  1300. Trying to open render node...
  1301. Success at /dev/dri/renderD128.
  1302. ffmpeg version 2.4.4 Copyright (c) 2000-2014 the FFmpeg ...'''), '2.4.4')
  1304.     def test_age_restricted(self):
  1305.         self.assertFalse(age_restricted(None, 10))  # unrestricted content
  1306.         self.assertFalse(age_restricted(1, None))  # unrestricted policy
  1307.         self.assertFalse(age_restricted(8, 10))
  1308.         self.assertTrue(age_restricted(18, 14))
  1309.         self.assertFalse(age_restricted(18, 18))
  1311.     def test_is_html(self):
  1312.         self.assertFalse(is_html(b'\x49\x44\x43<html'))
  1313.         self.assertTrue(is_html(b'<!DOCTYPE foo>\xaaa'))
  1314.         self.assertTrue(is_html(  # UTF-8 with BOM
  1315.             b'\xef\xbb\xbf<!DOCTYPE foo>\xaaa'))
  1316.         self.assertTrue(is_html(  # UTF-16-LE
  1317.             b'\xff\xfe<\x00h\x00t\x00m\x00l\x00>\x00\xe4\x00'
  1318.         ))
  1319.         self.assertTrue(is_html(  # UTF-16-BE
  1320.             b'\xfe\xff\x00<\x00h\x00t\x00m\x00l\x00>\x00\xe4'
  1321.         ))
  1322.         self.assertTrue(is_html(  # UTF-32-BE
  1323.             b'\x00\x00\xFE\xFF\x00\x00\x00<\x00\x00\x00h\x00\x00\x00t\x00\x00\x00m\x00\x00\x00l\x00\x00\x00>\x00\x00\x00\xe4'))
  1324.         self.assertTrue(is_html(  # UTF-32-LE
  1325.             b'\xFF\xFE\x00\x00<\x00\x00\x00h\x00\x00\x00t\x00\x00\x00m\x00\x00\x00l\x00\x00\x00>\x00\x00\x00\xe4\x00\x00\x00'))
  1327.     def test_render_table(self):
  1328.         self.assertEqual(
  1329.             render_table(
  1330.                 ['a', 'bcd'],
  1331.                 [[123, 4], [9999, 51]]),
  1332.             'a    bcd\n'
  1333.             '123  4\n'
  1334.             '9999 51')
  1336.     def test_match_str(self):
  1337.         self.assertRaises(ValueError, match_str, 'xy>foobar', {})
  1338.         self.assertFalse(match_str('xy', {'x': 1200}))
  1339.         self.assertTrue(match_str('!xy', {'x': 1200}))
  1340.         self.assertTrue(match_str('x', {'x': 1200}))
  1341.         self.assertFalse(match_str('!x', {'x': 1200}))
  1342.         self.assertTrue(match_str('x', {'x': 0}))
  1343.         self.assertFalse(match_str('x>0', {'x': 0}))
  1344.         self.assertFalse(match_str('x>0', {}))
  1345.         self.assertTrue(match_str('x>?0', {}))
  1346.         self.assertTrue(match_str('x>1K', {'x': 1200}))
  1347.         self.assertFalse(match_str('x>2K', {'x': 1200}))
  1348.         self.assertTrue(match_str('x>=1200 & x < 1300', {'x': 1200}))
  1349.         self.assertFalse(match_str('x>=1100 & x < 1200', {'x': 1200}))
  1350.         self.assertFalse(match_str('y=a212', {'y': 'foobar42'}))
  1351.         self.assertTrue(match_str('y=foobar42', {'y': 'foobar42'}))
  1352.         self.assertFalse(match_str('y!=foobar42', {'y': 'foobar42'}))
  1353.         self.assertTrue(match_str('y!=foobar2', {'y': 'foobar42'}))
  1354.         self.assertFalse(match_str(
  1355.             'like_count > 100 & dislike_count <? 50 & description',
  1356.             {'like_count': 90, 'description': 'foo'}))
  1357.         self.assertTrue(match_str(
  1358.             'like_count > 100 & dislike_count <? 50 & description',
  1359.             {'like_count': 190, 'description': 'foo'}))
  1360.         self.assertFalse(match_str(
  1361.             'like_count > 100 & dislike_count <? 50 & description',
  1362.             {'like_count': 190, 'dislike_count': 60, 'description': 'foo'}))
  1363.         self.assertFalse(match_str(
  1364.             'like_count > 100 & dislike_count <? 50 & description',
  1365.             {'like_count': 190, 'dislike_count': 10}))
  1366.         self.assertTrue(match_str('is_live', {'is_live': True}))
  1367.         self.assertFalse(match_str('is_live', {'is_live': False}))
  1368.         self.assertFalse(match_str('is_live', {'is_live': None}))
  1369.         self.assertFalse(match_str('is_live', {}))
  1370.         self.assertFalse(match_str('!is_live', {'is_live': True}))
  1371.         self.assertTrue(match_str('!is_live', {'is_live': False}))
  1372.         self.assertTrue(match_str('!is_live', {'is_live': None}))
  1373.         self.assertTrue(match_str('!is_live', {}))
  1374.         self.assertTrue(match_str('title', {'title': 'abc'}))
  1375.         self.assertTrue(match_str('title', {'title': ''}))
  1376.         self.assertFalse(match_str('!title', {'title': 'abc'}))
  1377.         self.assertFalse(match_str('!title', {'title': ''}))
  1379.     def test_parse_dfxp_time_expr(self):
  1380.         self.assertEqual(parse_dfxp_time_expr(None), None)
  1381.         self.assertEqual(parse_dfxp_time_expr(''), None)
  1382.         self.assertEqual(parse_dfxp_time_expr('0.1'), 0.1)
  1383.         self.assertEqual(parse_dfxp_time_expr('0.1s'), 0.1)
  1384.         self.assertEqual(parse_dfxp_time_expr('00:00:01'), 1.0)
  1385.         self.assertEqual(parse_dfxp_time_expr('00:00:01.100'), 1.1)
  1386.         self.assertEqual(parse_dfxp_time_expr('00:00:01:100'), 1.1)
  1388.     def test_dfxp2srt(self):
  1389.         dfxp_data = '''<?xml version="1.0" encoding="UTF-8"?>
  1390.             <tt xmlns="http://www.w3.org/ns/ttml" xml:lang="en" xmlns:tts="http://www.w3.org/ns/ttml#parameter">
  1391.             <body>
  1392.                 <div xml:lang="en">
  1393.                     <p begin="0" end="1">The following line contains Chinese characters and special symbols</p>
  1394.                     <p begin="1" end="2">第二行<br/>♪♪</p>
  1395.                     <p begin="2" dur="1"><span>Third<br/>Line</span></p>
  1396.                     <p begin="3" end="-1">Lines with invalid timestamps are ignored</p>
  1397.                     <p begin="-1" end="-1">Ignore, two</p>
  1398.                     <p begin="3" dur="-1">Ignored, three</p>
  1399.                 </div>
  1400.             </body>
  1401.             </tt>'''.encode('utf-8')
  1402.         srt_data = '''1
  1403. 00:00:00,000 --> 00:00:01,000
  1404. The following line contains Chinese characters and special symbols
  1406. 2
  1407. 00:00:01,000 --> 00:00:02,000
  1408. 第二行
  1409. ♪♪
  1411. 3
  1412. 00:00:02,000 --> 00:00:03,000
  1413. Third
  1414. Line
  1416. '''
  1417.         self.assertEqual(dfxp2srt(dfxp_data), srt_data)
  1419.         dfxp_data_no_default_namespace = '''<?xml version="1.0" encoding="UTF-8"?>
  1420.             <tt xml:lang="en" xmlns:tts="http://www.w3.org/ns/ttml#parameter">
  1421.             <body>
  1422.                 <div xml:lang="en">
  1423.                     <p begin="0" end="1">The first line</p>
  1424.                 </div>
  1425.             </body>
  1426.             </tt>'''.encode('utf-8')
  1427.         srt_data = '''1
  1428. 00:00:00,000 --> 00:00:01,000
  1429. The first line
  1431. '''
  1432.         self.assertEqual(dfxp2srt(dfxp_data_no_default_namespace), srt_data)
  1434.         dfxp_data_with_style = '''<?xml version="1.0" encoding="utf-8"?>
  1435. <tt xmlns="http://www.w3.org/2006/10/ttaf1" xmlns:ttp="http://www.w3.org/2006/10/ttaf1#parameter" ttp:timeBase="media" xmlns:tts="http://www.w3.org/2006/10/ttaf1#style" xml:lang="en" xmlns:ttm="http://www.w3.org/2006/10/ttaf1#metadata">
  1436.   <head>
  1437.     <styling>
  1438.       <style id="s2" style="s0" tts:color="cyan" tts:fontWeight="bold" />
  1439.       <style id="s1" style="s0" tts:color="yellow" tts:fontStyle="italic" />
  1440.       <style id="s3" style="s0" tts:color="lime" tts:textDecoration="underline" />
  1441.       <style id="s0" tts:backgroundColor="black" tts:fontStyle="normal" tts:fontSize="16" tts:fontFamily="sansSerif" tts:color="white" />
  1442.     </styling>
  1443.   </head>
  1444.   <body tts:textAlign="center" style="s0">
  1445.     <div>
  1446.       <p begin="00:00:02.08" id="p0" end="00:00:05.84">default style<span tts:color="red">custom style</span></p>
  1447.       <p style="s2" begin="00:00:02.08" id="p0" end="00:00:05.84"><span tts:color="lime">part 1<br /></span><span tts:color="cyan">part 2</span></p>
  1448.       <p style="s3" begin="00:00:05.84" id="p1" end="00:00:09.56">line 3<br />part 3</p>
  1449.       <p style="s1" tts:textDecoration="underline" begin="00:00:09.56" id="p2" end="00:00:12.36"><span style="s2" tts:color="lime">inner<br /> </span>style</p>
  1450.     </div>
  1451.   </body>
  1452. </tt>'''.encode('utf-8')
  1453.         srt_data = '''1
  1454. 00:00:02,080 --> 00:00:05,839
  1455. <font color="white" face="sansSerif" size="16">default style<font color="red">custom style</font></font>
  1457. 2
  1458. 00:00:02,080 --> 00:00:05,839
  1459. <b><font color="cyan" face="sansSerif" size="16"><font color="lime">part 1
  1460. </font>part 2</font></b>
  1462. 3
  1463. 00:00:05,839 --> 00:00:09,560
  1464. <u><font color="lime">line 3
  1465. part 3</font></u>
  1467. 4
  1468. 00:00:09,560 --> 00:00:12,359
  1469. <i><u><font color="yellow"><font color="lime">inner
  1470.  </font>style</font></u></i>
  1472. '''
  1473.         self.assertEqual(dfxp2srt(dfxp_data_with_style), srt_data)
  1475.         dfxp_data_non_utf8 = '''<?xml version="1.0" encoding="UTF-16"?>
  1476.             <tt xmlns="http://www.w3.org/ns/ttml" xml:lang="en" xmlns:tts="http://www.w3.org/ns/ttml#parameter">
  1477.             <body>
  1478.                 <div xml:lang="en">
  1479.                     <p begin="0" end="1">Line 1</p>
  1480.                     <p begin="1" end="2">第二行</p>
  1481.                 </div>
  1482.             </body>
  1483.             </tt>'''.encode('utf-16')
  1484.         srt_data = '''1
  1485. 00:00:00,000 --> 00:00:01,000
  1486. Line 1
  1488. 2
  1489. 00:00:01,000 --> 00:00:02,000
  1490. 第二行
  1492. '''
  1493.         self.assertEqual(dfxp2srt(dfxp_data_non_utf8), srt_data)
  1495.     def test_cli_option(self):
  1496.         self.assertEqual(cli_option({'proxy': '127.0.0.1:3128'}, '--proxy', 'proxy'), ['--proxy', '127.0.0.1:3128'])
  1497.         self.assertEqual(cli_option({'proxy': None}, '--proxy', 'proxy'), [])
  1498.         self.assertEqual(cli_option({}, '--proxy', 'proxy'), [])
  1499.         self.assertEqual(cli_option({'retries': 10}, '--retries', 'retries'), ['--retries', '10'])
  1501.     def test_cli_valueless_option(self):
  1502.         self.assertEqual(cli_valueless_option(
  1503.             {'downloader': 'external'}, '--external-downloader', 'downloader', 'external'), ['--external-downloader'])
  1504.         self.assertEqual(cli_valueless_option(
  1505.             {'downloader': 'internal'}, '--external-downloader', 'downloader', 'external'), [])
  1506.         self.assertEqual(cli_valueless_option(
  1507.             {'nocheckcertificate': True}, '--no-check-certificate', 'nocheckcertificate'), ['--no-check-certificate'])
  1508.         self.assertEqual(cli_valueless_option(
  1509.             {'nocheckcertificate': False}, '--no-check-certificate', 'nocheckcertificate'), [])
  1510.         self.assertEqual(cli_valueless_option(
  1511.             {'checkcertificate': True}, '--no-check-certificate', 'checkcertificate', False), [])
  1512.         self.assertEqual(cli_valueless_option(
  1513.             {'checkcertificate': False}, '--no-check-certificate', 'checkcertificate', False), ['--no-check-certificate'])
  1515.     def test_cli_bool_option(self):
  1516.         self.assertEqual(
  1517.             cli_bool_option(
  1518.                 {'nocheckcertificate': True}, '--no-check-certificate', 'nocheckcertificate'),
  1519.             ['--no-check-certificate', 'true'])
  1520.         self.assertEqual(
  1521.             cli_bool_option(
  1522.                 {'nocheckcertificate': True}, '--no-check-certificate', 'nocheckcertificate', separator='='),
  1523.             ['--no-check-certificate=true'])
  1524.         self.assertEqual(
  1525.             cli_bool_option(
  1526.                 {'nocheckcertificate': True}, '--check-certificate', 'nocheckcertificate', 'false', 'true'),
  1527.             ['--check-certificate', 'false'])
  1528.         self.assertEqual(
  1529.             cli_bool_option(
  1530.                 {'nocheckcertificate': True}, '--check-certificate', 'nocheckcertificate', 'false', 'true', '='),
  1531.             ['--check-certificate=false'])
  1532.         self.assertEqual(
  1533.             cli_bool_option(
  1534.                 {'nocheckcertificate': False}, '--check-certificate', 'nocheckcertificate', 'false', 'true'),
  1535.             ['--check-certificate', 'true'])
  1536.         self.assertEqual(
  1537.             cli_bool_option(
  1538.                 {'nocheckcertificate': False}, '--check-certificate', 'nocheckcertificate', 'false', 'true', '='),
  1539.             ['--check-certificate=true'])
  1540.         self.assertEqual(
  1541.             cli_bool_option(
  1542.                 {}, '--check-certificate', 'nocheckcertificate', 'false', 'true', '='),
  1543.             [])
  1545.     def test_ohdave_rsa_encrypt(self):
  1546.         N = 0xab86b6371b5318aaa1d3c9e612a9f1264f372323c8c0f19875b5fc3b3fd3afcc1e5bec527aa94bfa85bffc157e4245aebda05389a5357b75115ac94f074aefcd
  1547.         e = 65537
  1549.         self.assertEqual(
  1550.             ohdave_rsa_encrypt(b'aa111222', e, N),
  1551.             '726664bd9a23fd0c70f9f1b84aab5e3905ce1e45a584e9cbcf9bcc7510338fc1986d6c599ff990d923aa43c51c0d9013cd572e13bc58f4ae48f2ed8c0b0ba881')
  1553.     def test_pkcs1pad(self):
  1554.         data = [1, 2, 3]
  1555.         padded_data = pkcs1pad(data, 32)
  1556.         self.assertEqual(padded_data[:2], [0, 2])
  1557.         self.assertEqual(padded_data[28:], [0, 1, 2, 3])
  1559.         self.assertRaises(ValueError, pkcs1pad, data, 8)
  1561.     def test_encode_base_n(self):
  1562.         self.assertEqual(encode_base_n(0, 30), '0')
  1563.         self.assertEqual(encode_base_n(80, 30), '2k')
  1565.         custom_table = '9876543210ZYXWVUTSRQPONMLKJIHGFEDCBA'
  1566.         self.assertEqual(encode_base_n(0, 30, custom_table), '9')
  1567.         self.assertEqual(encode_base_n(80, 30, custom_table), '7P')
  1569.         self.assertRaises(ValueError, encode_base_n, 0, 70)
  1570.         self.assertRaises(ValueError, encode_base_n, 0, 60, custom_table)
  1572.     def test_caesar(self):
  1573.         self.assertEqual(caesar('ace', 'abcdef', 2), 'cea')
  1574.         self.assertEqual(caesar('cea', 'abcdef', -2), 'ace')
  1575.         self.assertEqual(caesar('ace', 'abcdef', -2), 'eac')
  1576.         self.assertEqual(caesar('eac', 'abcdef', 2), 'ace')
  1577.         self.assertEqual(caesar('ace', 'abcdef', 0), 'ace')
  1578.         self.assertEqual(caesar('xyz', 'abcdef', 2), 'xyz')
  1579.         self.assertEqual(caesar('abc', 'acegik', 2), 'ebg')
  1580.         self.assertEqual(caesar('ebg', 'acegik', -2), 'abc')
  1582.     def test_rot47(self):
  1583.         self.assertEqual(rot47('youtube-dl'), r'J@FEF36\5=')
  1584.         self.assertEqual(rot47('YOUTUBE-DL'), r'*~&%&qt\s{')
  1586.     def test_urshift(self):
  1587.         self.assertEqual(urshift(3, 1), 1)
  1588.         self.assertEqual(urshift(-3, 1), 2147483646)
  1590.     def test_get_element_by_class(self):
  1591.         html = '''
  1592.             <span class="foo bar">nice</span>
  1593.         '''
  1595.         self.assertEqual(get_element_by_class('foo', html), 'nice')
  1596.         self.assertEqual(get_element_by_class('no-such-class', html), None)
  1598.     def test_get_element_by_attribute(self):
  1599.         html = '''
  1600.             <span class="foo bar">nice</span>
  1601.         '''
  1603.         self.assertEqual(get_element_by_attribute('class', 'foo bar', html), 'nice')
  1604.         self.assertEqual(get_element_by_attribute('class', 'foo', html), None)
  1605.         self.assertEqual(get_element_by_attribute('class', 'no-such-foo', html), None)
  1607.         html = '''
  1608.             <div itemprop="author" itemscope>foo</div>
  1609.         '''
  1611.         self.assertEqual(get_element_by_attribute('itemprop', 'author', html), 'foo')
  1613.     def test_get_elements_by_class(self):
  1614.         html = '''
  1615.             <span class="foo bar">nice</span><span class="foo bar">also nice</span>
  1616.         '''
  1618.         self.assertEqual(get_elements_by_class('foo', html), ['nice', 'also nice'])
  1619.         self.assertEqual(get_elements_by_class('no-such-class', html), [])
  1621.     def test_get_elements_by_attribute(self):
  1622.         html = '''
  1623.             <span class="foo bar">nice</span><span class="foo bar">also nice</span>
  1624.         '''
  1626.         self.assertEqual(get_elements_by_attribute('class', 'foo bar', html), ['nice', 'also nice'])
  1627.         self.assertEqual(get_elements_by_attribute('class', 'foo', html), [])
  1628.         self.assertEqual(get_elements_by_attribute('class', 'no-such-foo', html), [])
  1630.     def test_clean_podcast_url(self):
  1631.         self.assertEqual(clean_podcast_url('https://www.podtrac.com/pts/redirect.mp3/chtbl.com/track/5899E/traffic.megaphone.fm/HSW7835899191.mp3'), 'https://traffic.megaphone.fm/HSW7835899191.mp3')
  1632.         self.assertEqual(clean_podcast_url('https://play.podtrac.com/npr-344098539/edge1.pod.npr.org/anon.npr-podcasts/podcast/npr/waitwait/2020/10/20201003_waitwait_wwdtmpodcast201003-015621a5-f035-4eca-a9a1-7c118d90bc3c.mp3'), 'https://edge1.pod.npr.org/anon.npr-podcasts/podcast/npr/waitwait/2020/10/20201003_waitwait_wwdtmpodcast201003-015621a5-f035-4eca-a9a1-7c118d90bc3c.mp3')
  1634.     def test_LazyList(self):
  1635.         it = list(range(10))
  1637.         self.assertEqual(list(LazyList(it)), it)
  1638.         self.assertEqual(LazyList(it).exhaust(), it)
  1639.         self.assertEqual(LazyList(it)[5], it[5])
  1641.         self.assertEqual(LazyList(it)[5:], it[5:])
  1642.         self.assertEqual(LazyList(it)[:5], it[:5])
  1643.         self.assertEqual(LazyList(it)[::2], it[::2])
  1644.         self.assertEqual(LazyList(it)[1::2], it[1::2])
  1645.         self.assertEqual(LazyList(it)[5::-1], it[5::-1])
  1646.         self.assertEqual(LazyList(it)[6:2:-2], it[6:2:-2])
  1647.         self.assertEqual(LazyList(it)[::-1], it[::-1])
  1649.         self.assertTrue(LazyList(it))
  1650.         self.assertFalse(LazyList(range(0)))
  1651.         self.assertEqual(len(LazyList(it)), len(it))
  1652.         self.assertEqual(repr(LazyList(it)), repr(it))
  1653.         self.assertEqual(compat_str(LazyList(it)), compat_str(it))
  1655.         self.assertEqual(list(LazyList(it, reverse=True)), it[::-1])
  1656.         self.assertEqual(list(reversed(LazyList(it))[::-1]), it)
  1657.         self.assertEqual(list(reversed(LazyList(it))[1:3:7]), it[::-1][1:3:7])
  1659.     def test_LazyList_laziness(self):
  1661.         def test(ll, idx, val, cache):
  1662.             self.assertEqual(ll[idx], val)
  1663.             self.assertEqual(ll._cache, list(cache))
  1665.         ll = LazyList(range(10))
  1666.         test(ll, 0, 0, range(1))
  1667.         test(ll, 5, 5, range(6))
  1668.         test(ll, -3, 7, range(10))
  1670.         ll = LazyList(range(10), reverse=True)
  1671.         test(ll, -1, 0, range(1))
  1672.         test(ll, 3, 6, range(10))
  1674.         ll = LazyList(itertools.count())
  1675.         test(ll, 10, 10, range(11))
  1676.         ll = reversed(ll)
  1677.         test(ll, -15, 14, range(15))
  1679.     def test_try_call(self):
  1680.         def total(*x, **kwargs):
  1681.             return sum(x) + sum(kwargs.values())
  1683.         self.assertEqual(try_call(None), None,
  1684.                          msg='not a fn should give None')
  1685.         self.assertEqual(try_call(lambda: 1), 1,
  1686.                          msg='int fn with no expected_type should give int')
  1687.         self.assertEqual(try_call(lambda: 1, expected_type=int), 1,
  1688.                          msg='int fn with expected_type int should give int')
  1689.         self.assertEqual(try_call(lambda: 1, expected_type=dict), None,
  1690.                          msg='int fn with wrong expected_type should give None')
  1691.         self.assertEqual(try_call(total, args=(0, 1, 0, ), expected_type=int), 1,
  1692.                          msg='fn should accept arglist')
  1693.         self.assertEqual(try_call(total, kwargs={'a': 0, 'b': 1, 'c': 0}, expected_type=int), 1,
  1694.                          msg='fn should accept kwargs')
  1695.         self.assertEqual(try_call(lambda: 1, expected_type=dict), None,
  1696.                          msg='int fn with no expected_type should give None')
  1697.         self.assertEqual(try_call(lambda x: {}, total, args=(42, ), expected_type=int), 42,
  1698.                          msg='expect first int result with expected_type int')
  1700.     def test_variadic(self):
  1701.         self.assertEqual(variadic(None), (None, ))
  1702.         self.assertEqual(variadic('spam'), ('spam', ))
  1703.         self.assertEqual(variadic('spam', allowed_types=dict), 'spam')
  1704.         self.assertEqual(variadic('spam', allowed_types=[dict]), 'spam')
  1706.     def test_traverse_obj(self):
  1707.         str = compat_str
  1708.         _TEST_DATA = {
  1709.             100: 100,
  1710.             1.2: 1.2,
  1711.             'str': 'str',
  1712.             'None': None,
  1713.             '...': Ellipsis,
  1714.             'urls': [
  1715.                 {'index': 0, 'url': 'https://www.example.com/0'},
  1716.                 {'index': 1, 'url': 'https://www.example.com/1'},
  1717.             ],
  1718.             'data': (
  1719.                 {'index': 2},
  1720.                 {'index': 3},
  1721.             ),
  1722.             'dict': {},
  1723.         }
  1725.         # define a pukka Iterable
  1726.         def iter_range(stop):
  1727.             for from_ in range(stop):
  1728.                 yield from_
  1730.         # Test base functionality
  1731.         self.assertEqual(traverse_obj(_TEST_DATA, ('str',)), 'str',
  1732.                          msg='allow tuple path')
  1733.         self.assertEqual(traverse_obj(_TEST_DATA, ['str']), 'str',
  1734.                          msg='allow list path')
  1735.         self.assertEqual(traverse_obj(_TEST_DATA, (value for value in ("str",))), 'str',
  1736.                          msg='allow iterable path')
  1737.         self.assertEqual(traverse_obj(_TEST_DATA, 'str'), 'str',
  1738.                          msg='single items should be treated as a path')
  1739.         self.assertEqual(traverse_obj(_TEST_DATA, None), _TEST_DATA)
  1740.         self.assertEqual(traverse_obj(_TEST_DATA, 100), 100)
  1741.         self.assertEqual(traverse_obj(_TEST_DATA, 1.2), 1.2)
  1743.         # Test Ellipsis behavior
  1744.         self.assertCountEqual(traverse_obj(_TEST_DATA, Ellipsis),
  1745.                               (item for item in _TEST_DATA.values() if item not in (None, {})),
  1746.                               msg='`...` should give all non-discarded values')
  1747.         self.assertCountEqual(traverse_obj(_TEST_DATA, ('urls', 0, Ellipsis)), _TEST_DATA['urls'][0].values(),
  1748.                               msg='`...` selection for dicts should select all values')
  1749.         self.assertEqual(traverse_obj(_TEST_DATA, (Ellipsis, Ellipsis, 'url')),
  1750.                          ['https://www.example.com/0', 'https://www.example.com/1'],
  1751.                          msg='nested `...` queries should work')
  1752.         self.assertCountEqual(traverse_obj(_TEST_DATA, (Ellipsis, Ellipsis, 'index')), iter_range(4),
  1753.                               msg='`...` query result should be flattened')
  1754.         self.assertEqual(traverse_obj(iter(range(4)), Ellipsis), list(range(4)),
  1755.                          msg='`...` should accept iterables')
  1757.         # Test function as key
  1758.         self.assertEqual(traverse_obj(_TEST_DATA, lambda x, y: x == 'urls' and isinstance(y, list)),
  1759.                          [_TEST_DATA['urls']],
  1760.                          msg='function as query key should perform a filter based on (key, value)')
  1761.         self.assertCountEqual(traverse_obj(_TEST_DATA, lambda _, x: isinstance(x[0], str)), set(('str',)),
  1762.                               msg='exceptions in the query function should be caught')
  1763.         self.assertEqual(traverse_obj(iter(range(4)), lambda _, x: x % 2 == 0), [0, 2],
  1764.                          msg='function key should accept iterables')
  1765.         if __debug__:
  1766.             with self.assertRaises(Exception, msg='Wrong function signature should raise in debug'):
  1767.                 traverse_obj(_TEST_DATA, lambda a: Ellipsis)
  1768.             with self.assertRaises(Exception, msg='Wrong function signature should raise in debug'):
  1769.                 traverse_obj(_TEST_DATA, lambda a, b, c: Ellipsis)
  1771.         # Test set as key (transformation/type, like `expected_type`)
  1772.         self.assertEqual(traverse_obj(_TEST_DATA, (Ellipsis, T(str.upper), )), ['STR'],
  1773.                          msg='Function in set should be a transformation')
  1774.         self.assertEqual(traverse_obj(_TEST_DATA, (Ellipsis, T(str))), ['str'],
  1775.                          msg='Type in set should be a type filter')
  1776.         self.assertEqual(traverse_obj(_TEST_DATA, T(dict)), _TEST_DATA,
  1777.                          msg='A single set should be wrapped into a path')
  1778.         self.assertEqual(traverse_obj(_TEST_DATA, (Ellipsis, T(str.upper))), ['STR'],
  1779.                          msg='Transformation function should not raise')
  1780.         self.assertEqual(traverse_obj(_TEST_DATA, (Ellipsis, T(str_or_none))),
  1781.                          [item for item in map(str_or_none, _TEST_DATA.values()) if item is not None],
  1782.                          msg='Function in set should be a transformation')
  1783.         if __debug__:
  1784.             with self.assertRaises(Exception, msg='Sets with length != 1 should raise in debug'):
  1785.                 traverse_obj(_TEST_DATA, set())
  1786.             with self.assertRaises(Exception, msg='Sets with length != 1 should raise in debug'):
  1787.                 traverse_obj(_TEST_DATA, set((str.upper, str)))
  1789.         # Test `slice` as a key
  1790.         _SLICE_DATA = [0, 1, 2, 3, 4]
  1791.         self.assertEqual(traverse_obj(_TEST_DATA, ('dict', slice(1))), None,
  1792.                          msg='slice on a dictionary should not throw')
  1793.         self.assertEqual(traverse_obj(_SLICE_DATA, slice(1)), _SLICE_DATA[:1],
  1794.                          msg='slice key should apply slice to sequence')
  1795.         self.assertEqual(traverse_obj(_SLICE_DATA, slice(1, 2)), _SLICE_DATA[1:2],
  1796.                          msg='slice key should apply slice to sequence')
  1797.         self.assertEqual(traverse_obj(_SLICE_DATA, slice(1, 4, 2)), _SLICE_DATA[1:4:2],
  1798.                          msg='slice key should apply slice to sequence')
  1800.         # Test alternative paths
  1801.         self.assertEqual(traverse_obj(_TEST_DATA, 'fail', 'str'), 'str',
  1802.                          msg='multiple `paths` should be treated as alternative paths')
  1803.         self.assertEqual(traverse_obj(_TEST_DATA, 'str', 100), 'str',
  1804.                          msg='alternatives should exit early')
  1805.         self.assertEqual(traverse_obj(_TEST_DATA, 'fail', 'fail'), None,
  1806.                          msg='alternatives should return `default` if exhausted')
  1807.         self.assertEqual(traverse_obj(_TEST_DATA, (Ellipsis, 'fail'), 100), 100,
  1808.                          msg='alternatives should track their own branching return')
  1809.         self.assertEqual(traverse_obj(_TEST_DATA, ('dict', Ellipsis), ('data', Ellipsis)), list(_TEST_DATA['data']),
  1810.                          msg='alternatives on empty objects should search further')
  1812.         # Test branch and path nesting
  1813.         self.assertEqual(traverse_obj(_TEST_DATA, ('urls', (3, 0), 'url')), ['https://www.example.com/0'],
  1814.                          msg='tuple as key should be treated as branches')
  1815.         self.assertEqual(traverse_obj(_TEST_DATA, ('urls', [3, 0], 'url')), ['https://www.example.com/0'],
  1816.                          msg='list as key should be treated as branches')
  1817.         self.assertEqual(traverse_obj(_TEST_DATA, ('urls', ((1, 'fail'), (0, 'url')))), ['https://www.example.com/0'],
  1818.                          msg='double nesting in path should be treated as paths')
  1819.         self.assertEqual(traverse_obj(['0', [1, 2]], [(0, 1), 0]), [1],
  1820.                          msg='do not fail early on branching')
  1821.         self.assertCountEqual(traverse_obj(_TEST_DATA, ('urls', ((1, ('fail', 'url')), (0, 'url')))),
  1822.                               ['https://www.example.com/0', 'https://www.example.com/1'],
  1823.                               msg='triple nesting in path should be treated as branches')
  1824.         self.assertEqual(traverse_obj(_TEST_DATA, ('urls', ('fail', (Ellipsis, 'url')))),
  1825.                          ['https://www.example.com/0', 'https://www.example.com/1'],
  1826.                          msg='ellipsis as branch path start gets flattened')
  1828.         # Test dictionary as key
  1829.         self.assertEqual(traverse_obj(_TEST_DATA, {0: 100, 1: 1.2}), {0: 100, 1: 1.2},
  1830.                          msg='dict key should result in a dict with the same keys')
  1831.         self.assertEqual(traverse_obj(_TEST_DATA, {0: ('urls', 0, 'url')}),
  1832.                          {0: 'https://www.example.com/0'},
  1833.                          msg='dict key should allow paths')
  1834.         self.assertEqual(traverse_obj(_TEST_DATA, {0: ('urls', (3, 0), 'url')}),
  1835.                          {0: ['https://www.example.com/0']},
  1836.                          msg='tuple in dict path should be treated as branches')
  1837.         self.assertEqual(traverse_obj(_TEST_DATA, {0: ('urls', ((1, 'fail'), (0, 'url')))}),
  1838.                          {0: ['https://www.example.com/0']},
  1839.                          msg='double nesting in dict path should be treated as paths')
  1840.         self.assertEqual(traverse_obj(_TEST_DATA, {0: ('urls', ((1, ('fail', 'url')), (0, 'url')))}),
  1841.                          {0: ['https://www.example.com/1', 'https://www.example.com/0']},
  1842.                          msg='triple nesting in dict path should be treated as branches')
  1843.         self.assertEqual(traverse_obj(_TEST_DATA, {0: 'fail'}), {},
  1844.                          msg='remove `None` values when top level dict key fails')
  1845.         self.assertEqual(traverse_obj(_TEST_DATA, {0: 'fail'}, default=Ellipsis), {0: Ellipsis},
  1846.                          msg='use `default` if key fails and `default`')
  1847.         self.assertEqual(traverse_obj(_TEST_DATA, {0: 'dict'}), {},
  1848.                          msg='remove empty values when dict key')
  1849.         self.assertEqual(traverse_obj(_TEST_DATA, {0: 'dict'}, default=Ellipsis), {0: Ellipsis},
  1850.                          msg='use `default` when dict key and a default')
  1851.         self.assertEqual(traverse_obj(_TEST_DATA, {0: {0: 'fail'}}), {},
  1852.                          msg='remove empty values when nested dict key fails')
  1853.         self.assertEqual(traverse_obj(None, {0: 'fail'}), {},
  1854.                          msg='default to dict if pruned')
  1855.         self.assertEqual(traverse_obj(None, {0: 'fail'}, default=Ellipsis), {0: Ellipsis},
  1856.                          msg='default to dict if pruned and default is given')
  1857.         self.assertEqual(traverse_obj(_TEST_DATA, {0: {0: 'fail'}}, default=Ellipsis), {0: {0: Ellipsis}},
  1858.                          msg='use nested `default` when nested dict key fails and `default`')
  1859.         self.assertEqual(traverse_obj(_TEST_DATA, {0: ('dict', Ellipsis)}), {},
  1860.                          msg='remove key if branch in dict key not successful')
  1862.         # Testing default parameter behavior
  1863.         _DEFAULT_DATA = {'None': None, 'int': 0, 'list': []}
  1864.         self.assertEqual(traverse_obj(_DEFAULT_DATA, 'fail'), None,
  1865.                          msg='default value should be `None`')
  1866.         self.assertEqual(traverse_obj(_DEFAULT_DATA, 'fail', 'fail', default=Ellipsis), Ellipsis,
  1867.                          msg='chained fails should result in default')
  1868.         self.assertEqual(traverse_obj(_DEFAULT_DATA, 'None', 'int'), 0,
  1869.                          msg='should not short cirquit on `None`')
  1870.         self.assertEqual(traverse_obj(_DEFAULT_DATA, 'fail', default=1), 1,
  1871.                          msg='invalid dict key should result in `default`')
  1872.         self.assertEqual(traverse_obj(_DEFAULT_DATA, 'None', default=1), 1,
  1873.                          msg='`None` is a deliberate sentinel and should become `default`')
  1874.         self.assertEqual(traverse_obj(_DEFAULT_DATA, ('list', 10)), None,
  1875.                          msg='`IndexError` should result in `default`')
  1876.         self.assertEqual(traverse_obj(_DEFAULT_DATA, (Ellipsis, 'fail'), default=1), 1,
  1877.                          msg='if branched but not successful return `default` if defined, not `[]`')
  1878.         self.assertEqual(traverse_obj(_DEFAULT_DATA, (Ellipsis, 'fail'), default=None), None,
  1879.                          msg='if branched but not successful return `default` even if `default` is `None`')
  1880.         self.assertEqual(traverse_obj(_DEFAULT_DATA, (Ellipsis, 'fail')), [],
  1881.                          msg='if branched but not successful return `[]`, not `default`')
  1882.         self.assertEqual(traverse_obj(_DEFAULT_DATA, ('list', Ellipsis)), [],
  1883.                          msg='if branched but object is empty return `[]`, not `default`')
  1884.         self.assertEqual(traverse_obj(None, Ellipsis), [],
  1885.                          msg='if branched but object is `None` return `[]`, not `default`')
  1886.         self.assertEqual(traverse_obj({0: None}, (0, Ellipsis)), [],
  1887.                          msg='if branched but state is `None` return `[]`, not `default`')
  1889.         branching_paths = [
  1890.             ('fail', Ellipsis),
  1891.             (Ellipsis, 'fail'),
  1892.             100 * ('fail',) + (Ellipsis,),
  1893.             (Ellipsis,) + 100 * ('fail',),
  1894.         ]
  1895.         for branching_path in branching_paths:
  1896.             self.assertEqual(traverse_obj({}, branching_path), [],
  1897.                              msg='if branched but state is `None`, return `[]` (not `default`)')
  1898.             self.assertEqual(traverse_obj({}, 'fail', branching_path), [],
  1899.                              msg='if branching in last alternative and previous did not match, return `[]` (not `default`)')
  1900.             self.assertEqual(traverse_obj({0: 'x'}, 0, branching_path), 'x',
  1901.                              msg='if branching in last alternative and previous did match, return single value')
  1902.             self.assertEqual(traverse_obj({0: 'x'}, branching_path, 0), 'x',
  1903.                              msg='if branching in first alternative and non-branching path does match, return single value')
  1904.             self.assertEqual(traverse_obj({}, branching_path, 'fail'), None,
  1905.                              msg='if branching in first alternative and non-branching path does not match, return `default`')
  1907.         # Testing expected_type behavior
  1908.         _EXPECTED_TYPE_DATA = {'str': 'str', 'int': 0}
  1909.         self.assertEqual(traverse_obj(_EXPECTED_TYPE_DATA, 'str', expected_type=str),
  1910.                          'str', msg='accept matching `expected_type` type')
  1911.         self.assertEqual(traverse_obj(_EXPECTED_TYPE_DATA, 'str', expected_type=int),
  1912.                          None, msg='reject non-matching `expected_type` type')
  1913.         self.assertEqual(traverse_obj(_EXPECTED_TYPE_DATA, 'int', expected_type=lambda x: str(x)),
  1914.                          '0', msg='transform type using type function')
  1915.         self.assertEqual(traverse_obj(_EXPECTED_TYPE_DATA, 'str', expected_type=lambda _: 1 / 0),
  1916.                          None, msg='wrap expected_type function in try_call')
  1917.         self.assertEqual(traverse_obj(_EXPECTED_TYPE_DATA, Ellipsis, expected_type=str),
  1918.                          ['str'], msg='eliminate items that expected_type fails on')
  1919.         self.assertEqual(traverse_obj(_TEST_DATA, {0: 100, 1: 1.2}, expected_type=int),
  1920.                          {0: 100}, msg='type as expected_type should filter dict values')
  1921.         self.assertEqual(traverse_obj(_TEST_DATA, {0: 100, 1: 1.2, 2: 'None'}, expected_type=str_or_none),
  1922.                          {0: '100', 1: '1.2'}, msg='function as expected_type should transform dict values')
  1923.         self.assertEqual(traverse_obj(_TEST_DATA, ({0: 1.2}, 0, set((int_or_none,))), expected_type=int),
  1924.                          1, msg='expected_type should not filter non-final dict values')
  1925.         self.assertEqual(traverse_obj(_TEST_DATA, {0: {0: 100, 1: 'str'}}, expected_type=int),
  1926.                          {0: {0: 100}}, msg='expected_type should transform deep dict values')
  1927.         self.assertEqual(traverse_obj(_TEST_DATA, [({0: '...'}, {0: '...'})], expected_type=type(Ellipsis)),
  1928.                          [{0: Ellipsis}, {0: Ellipsis}], msg='expected_type should transform branched dict values')
  1929.         self.assertEqual(traverse_obj({1: {3: 4}}, [(1, 2), 3], expected_type=int),
  1930.                          [4], msg='expected_type regression for type matching in tuple branching')
  1931.         self.assertEqual(traverse_obj(_TEST_DATA, ['data', Ellipsis], expected_type=int),
  1932.                          [], msg='expected_type regression for type matching in dict result')
  1934.         # Test get_all behavior
  1935.         _GET_ALL_DATA = {'key': [0, 1, 2]}
  1936.         self.assertEqual(traverse_obj(_GET_ALL_DATA, ('key', Ellipsis), get_all=False), 0,
  1937.                          msg='if not `get_all`, return only first matching value')
  1938.         self.assertEqual(traverse_obj(_GET_ALL_DATA, Ellipsis, get_all=False), [0, 1, 2],
  1939.                          msg='do not overflatten if not `get_all`')
  1941.         # Test casesense behavior
  1942.         _CASESENSE_DATA = {
  1943.             'KeY': 'value0',
  1944.             0: {
  1945.                 'KeY': 'value1',
  1946.                 0: {'KeY': 'value2'},
  1947.             },
  1948.             # FULLWIDTH LATIN CAPITAL LETTER K
  1949.             '\uff2bey': 'value3',
  1950.         }
  1951.         self.assertEqual(traverse_obj(_CASESENSE_DATA, 'key'), None,
  1952.                          msg='dict keys should be case sensitive unless `casesense`')
  1953.         self.assertEqual(traverse_obj(_CASESENSE_DATA, 'keY',
  1954.                                       casesense=False), 'value0',
  1955.                          msg='allow non matching key case if `casesense`')
  1956.         self.assertEqual(traverse_obj(_CASESENSE_DATA, '\uff4bey',  # FULLWIDTH LATIN SMALL LETTER K
  1957.                                       casesense=False), 'value3',
  1958.                          msg='allow non matching Unicode key case if `casesense`')
  1959.         self.assertEqual(traverse_obj(_CASESENSE_DATA, (0, ('keY',)),
  1960.                                       casesense=False), ['value1'],
  1961.                          msg='allow non matching key case in branch if `casesense`')
  1962.         self.assertEqual(traverse_obj(_CASESENSE_DATA, (0, ((0, 'keY'),)),
  1963.                                       casesense=False), ['value2'],
  1964.                          msg='allow non matching key case in branch path if `casesense`')
  1966.         # Test traverse_string behavior
  1967.         _TRAVERSE_STRING_DATA = {'str': 'str', 1.2: 1.2}
  1968.         self.assertEqual(traverse_obj(_TRAVERSE_STRING_DATA, ('str', 0)), None,
  1969.                          msg='do not traverse into string if not `traverse_string`')
  1970.         self.assertEqual(traverse_obj(_TRAVERSE_STRING_DATA, ('str', 0),
  1971.                                       _traverse_string=True), 's',
  1972.                          msg='traverse into string if `traverse_string`')
  1973.         self.assertEqual(traverse_obj(_TRAVERSE_STRING_DATA, (1.2, 1),
  1974.                                       _traverse_string=True), '.',
  1975.                          msg='traverse into converted data if `traverse_string`')
  1976.         self.assertEqual(traverse_obj(_TRAVERSE_STRING_DATA, ('str', Ellipsis),
  1977.                                       _traverse_string=True), 'str',
  1978.                          msg='`...` should result in string (same value) if `traverse_string`')
  1979.         self.assertEqual(traverse_obj(_TRAVERSE_STRING_DATA, ('str', slice(0, None, 2)),
  1980.                                       _traverse_string=True), 'sr',
  1981.                          msg='`slice` should result in string if `traverse_string`')
  1982.         self.assertEqual(traverse_obj(_TRAVERSE_STRING_DATA, ('str', lambda i, v: i or v == 's'),
  1983.                                       _traverse_string=True), 'str',
  1984.                          msg='function should result in string if `traverse_string`')
  1985.         self.assertEqual(traverse_obj(_TRAVERSE_STRING_DATA, ('str', (0, 2)),
  1986.                                       _traverse_string=True), ['s', 'r'],
  1987.                          msg='branching should result in list if `traverse_string`')
  1988.         self.assertEqual(traverse_obj({}, (0, Ellipsis), _traverse_string=True), [],
  1989.                          msg='branching should result in list if `traverse_string`')
  1990.         self.assertEqual(traverse_obj({}, (0, lambda x, y: True), _traverse_string=True), [],
  1991.                          msg='branching should result in list if `traverse_string`')
  1992.         self.assertEqual(traverse_obj({}, (0, slice(1)), _traverse_string=True), [],
  1993.                          msg='branching should result in list if `traverse_string`')
  1995.         # Test is_user_input behavior
  1996.         _IS_USER_INPUT_DATA = {'range8': list(range(8))}
  1997.         self.assertEqual(traverse_obj(_IS_USER_INPUT_DATA, ('range8', '3'),
  1998.                                       _is_user_input=True), 3,
  1999.                          msg='allow for string indexing if `is_user_input`')
  2000.         self.assertCountEqual(traverse_obj(_IS_USER_INPUT_DATA, ('range8', '3:'),
  2001.                                            _is_user_input=True), tuple(range(8))[3:],
  2002.                               msg='allow for string slice if `is_user_input`')
  2003.         self.assertCountEqual(traverse_obj(_IS_USER_INPUT_DATA, ('range8', ':4:2'),
  2004.                                            _is_user_input=True), tuple(range(8))[:4:2],
  2005.                               msg='allow step in string slice if `is_user_input`')
  2006.         self.assertCountEqual(traverse_obj(_IS_USER_INPUT_DATA, ('range8', ':'),
  2007.                                            _is_user_input=True), range(8),
  2008.                               msg='`:` should be treated as `...` if `is_user_input`')
  2009.         with self.assertRaises(TypeError, msg='too many params should result in error'):
  2010.             traverse_obj(_IS_USER_INPUT_DATA, ('range8', ':::'), _is_user_input=True)
  2012.         # Test re.Match as input obj
  2013.         mobj = re.match(r'^0(12)(?P<group>3)(4)?$', '0123')
  2014.         self.assertEqual(traverse_obj(mobj, Ellipsis), [x for x in mobj.groups() if x is not None],
  2015.                          msg='`...` on a `re.Match` should give its `groups()`')
  2016.         self.assertEqual(traverse_obj(mobj, lambda k, _: k in (0, 2)), ['0123', '3'],
  2017.                          msg='function on a `re.Match` should give groupno, value starting at 0')
  2018.         self.assertEqual(traverse_obj(mobj, 'group'), '3',
  2019.                          msg='str key on a `re.Match` should give group with that name')
  2020.         self.assertEqual(traverse_obj(mobj, 2), '3',
  2021.                          msg='int key on a `re.Match` should give group with that name')
  2022.         self.assertEqual(traverse_obj(mobj, 'gRoUp', casesense=False), '3',
  2023.                          msg='str key on a `re.Match` should respect casesense')
  2024.         self.assertEqual(traverse_obj(mobj, 'fail'), None,
  2025.                          msg='failing str key on a `re.Match` should return `default`')
  2026.         self.assertEqual(traverse_obj(mobj, 'gRoUpS', casesense=False), None,
  2027.                          msg='failing str key on a `re.Match` should return `default`')
  2028.         self.assertEqual(traverse_obj(mobj, 8), None,
  2029.                          msg='failing int key on a `re.Match` should return `default`')
  2030.         self.assertEqual(traverse_obj(mobj, lambda k, _: k in (0, 'group')), ['0123', '3'],
  2031.                          msg='function on a `re.Match` should give group name as well')
  2033.     def test_get_first(self):
  2034.         self.assertEqual(get_first([{'a': None}, {'a': 'spam'}], 'a'), 'spam')
  2036.     def test_join_nonempty(self):
  2037.         self.assertEqual(join_nonempty('a', 'b'), 'a-b')
  2038.         self.assertEqual(join_nonempty(
  2039.             'a', 'b', 'c', 'd',
  2040.             from_dict={'a': 'c', 'c': [], 'b': 'd', 'd': None}), 'c-d')
  2043. if __name__ == '__main__':
  2044.     unittest.main()