A set of parsers and exporters for handling with subtitle files in various
subtitles. All data is imported into unicode, it uses chardet and some
guessing table (language to encoding) to identify proper encoding of the
file. The Subtitle object also supports save and from_file. It uses it's
own SIF (Subtitle Intermediate Format) which is just a plain YAML predefined
structure with some additional constructors.

Currently only SubRip parser and exporter is implemented, other parts are
yet to come.

A quick example of parsing:
import pysubtools
# Let's detect parser from data
parser = pysubtools.parser.Parser.from_data(open('sub.srt', 'rb'),
                                            encoding = 'windows-1250')
sub = parser.parse()

# Fifth unit
sub[5]

sub[1].start
sub[1].end
# And the lines itself (list of unicode)
sub[1].text

# And direct using SubRip parser
parser = pysubtools.parser.Parser.from_format('SubRip')
sub = parser.parse(open('sub.srt', 'rb'))

# We can also use GzipFile (if using python 2.x, can use patched GzipFile)
from pysubtools.utils import PatchedGzipFile as GzipFile
parser = pysubtools.parser.Parser.from_format('SubRip')
fileobj = open('sub.srt', 'rb')
# Can use guess table for specific language
sub = parser.parse(GzipFile(fileobj = fileobj), language = 'sl')

And an example of export (let's say we have the 'sub' from previous example):

exporter = pysubtools.exporters.Exporter.from_format('SubRip')

# Let us export it into io.BytesIO
import io
buf = io.BytesIO()
exporter.export(buf, sub)
# And we have utf-8 encoded string in buf

# Let us now export it into a file with different encoding
new_exporter = pysubtools.exporters.Exporter.from_format('SubRip',
                                                         encoding = 'cp1250')
new_exporter.export('test.srt', sub)

# And we have a cp-1250 encoded subtitle :). You may also use GzipFile to
# produce compressed subtitles.