This exception allows users of this library to catch exceptions without having to import the XML parsing library themselves.

>>> file_basename_no_extension('/home/me/file.txt')
'file'
    

>>> file_basename_no_extension('file')
'file'
    

This will also normalize feed:// and itpc:// to http://.

>>> normalize_feed_url('itpc://example.org/podcast.rss')
'http://example.org/podcast.rss'
    

If no URL scheme is defined (e.g. “curry.com”), we will simply assume the user intends to add a http:// feed.

>>> normalize_feed_url('curry.com')
'http://curry.com/'
    

It will also take care of converting the domain name to all-lowercase (because domains are not case sensitive):

>>> normalize_feed_url('http://Example.COM/')
'http://example.com/'
    

Some other minimalistic changes are also taken care of, e.g. a ? with an empty query is removed:

>>> normalize_feed_url('http://example.org/test?')
'http://example.org/test'
    

Leading and trailing whitespace is removed

>>> normalize_feed_url(' http://example.com/podcast.rss ')
'http://example.com/podcast.rss'
    

Incomplete (too short) URLs are not accepted

>>> normalize_feed_url('http://') is None
True
    

Unknown protocols are not accepted

>>> normalize_feed_url('gopher://gopher.hprc.utoronto.ca/file.txt') is None
True
    

>>> parse_length(None)
-1
    

>>> parse_length('0')
-1
    

>>> parse_length('unknown')
-1
    

>>> parse_length('100')
100
    

>>> parse_pubdate('Fri, 21 Nov 1997 09:55:06 -0600')
880127706
    

>>> parse_pubdate('2003-12-13T00:00:00+02:00')
1071266400
    

>>> parse_pubdate('2003-12-13T18:30:02Z')
1071340202
    

>>> parse_pubdate('Mon, 02 May 1960 09:05:01 +0100')
-305049299
    

>>> parse_pubdate('')
0
    

>>> parse_pubdate('unknown')
0
    

See RFC2326, 3.6 “Normal Play Time” (HH:MM:SS.FRACT)

>>> parse_time('0')
0
>>> parse_time('128')
128
>>> parse_time('00:00')
0
>>> parse_time('00:00:00')
0
>>> parse_time('00:20')
20
>>> parse_time('00:00:20')
20
>>> parse_time('01:00:00')
3600
>>> parse_time(' 03:02:01')
10921
>>> parse_time('61:08')
3668
>>> parse_time('25:03:30 ')
90210
>>> parse_time('25:3:30')
90210
>>> parse_time('61.08')
61
>>> parse_time('01:02:03.500')
3723
>>> parse_time(' ')
0
    

>>> parse_type('text/plain')
'text/plain'
    

>>> parse_type('text')
'application/octet-stream'
    

>>> parse_type('')
'application/octet-stream'
    

>>> parse_type(None)
'application/octet-stream'
    

>>> squash_whitespace(' some           text  with a    lot of   spaces ')
'some text with a lot of spaces'