import os
import re
import shutil
+import urllib
-class ParseError(Exception):
+
+class UnicodeException(Exception):
def __str__(self):
""" Dirty workaround for Python Unicode handling problems. """
- return self.message
+ return unicode(self).encode('utf-8')
def __unicode__(self):
""" Dirty workaround for Python Unicode handling problems. """
- return self.message
+ args = self.args[0] if len(self.args) == 1 else self.args
+ try:
+ message = unicode(args)
+ except UnicodeDecodeError:
+ message = unicode(args, encoding='utf-8', errors='ignore')
+ return message
+
+class ParseError(UnicodeException):
+ pass
-class ValidationError(Exception):
+class ValidationError(UnicodeException):
pass
class NoDublinCore(ValidationError):
"""There's no DublinCore section, and it's required."""
pass
-class NoProvider(Exception):
+class NoProvider(UnicodeException):
"""There's no DocProvider specified, and it's needed."""
pass
class WLURI(object):
- """Represents a WL URI. Extracts slug and language from it."""
-
+ """Represents a WL URI. Extracts slug from it."""
slug = None
- language = None
- _re_wl_uri = re.compile('http://wolnelektury.pl/katalog/lektura/'
- '(?P<slug>[-a-z]+)(/(?P<lang>[a-z]{3})/?)?')
+ example = 'http://edukacjamedialna.edu.pl/lekcje/template'
+ _re_wl_uri = re.compile(r'http://(www\.)?edukacjamedialna.edu.pl/lekcje/'
+ '(?P<slug>[-a-z0-9]+)/?$')
def __init__(self, uri):
+ uri = unicode(uri)
self.uri = uri
- match = self._re_wl_uri.match(uri)
- assert match
- self.slug = match.group('slug')
- self.language = match.group('lang')
+ self.slug = uri.rstrip('/').rsplit('/', 1)[-1]
+
+ @classmethod
+ def strict(cls, uri):
+ match = cls._re_wl_uri.match(uri)
+ if not match:
+ raise ValidationError(u'Invalid URI (%s). Should match: %s' % (
+ uri, cls._re_wl_uri.pattern))
+ return cls(uri)
+
+ @classmethod
+ def from_slug(cls, slug):
+ """Contructs an URI from slug.
+
+ >>> WLURI.from_slug('a-slug').uri
+ u'http://edukacjamedialna.edu.pl/lekcje/a-slug/'
+
+ """
+ uri = 'http://edukacjamedialna.edu.pl/lekcje/%s/' % slug
+ return cls(uri)
+
+ def __unicode__(self):
+ return self.uri
+
+ def __str__(self):
+ return self.uri
+
+ def canonical(self):
+ return type(self).from_slug(self.slug)
+
+ def __eq__(self, other):
+ return self.slug == other.slug
class DocProvider(object):
Used for generating joined files, like EPUBs.
"""
- def by_slug_and_lang(self, slug, lang=None):
- """Should return a file-like object with a WL document XML."""
- raise NotImplementedError
-
def by_slug(self, slug):
- """Should return a file-like object with a WL document XML."""
- return self.by_slug_and_lang(slug)
+ """Should return an IOFile object with a WL document XML."""
+ raise NotImplementedError
- def by_uri(self, uri):
- """Should return a file-like object with a WL document XML."""
- wluri = WLURI(uri)
- return self.by_slug_and_lang(wluri.slug, wluri.language)
+ def by_uri(self, uri, wluri=WLURI):
+ """Should return an IOFile object with a WL document XML."""
+ wluri = wluri(uri)
+ return self.by_slug(wluri.slug)
class DirDocProvider(DocProvider):
def __init__(self, dir_):
self.dir = dir_
self.files = {}
- return super(DirDocProvider, self).__init__()
- def by_slug_and_lang(self, slug, lang=None):
- fname = "%s%s.xml" % (slug, ".%s" % lang if lang else "")
- return open(os.path.join(self.dir, fname))
+ def by_slug(self, slug):
+ fname = slug + '.xml'
+ return IOFile.from_filename(os.path.join(self.dir, fname))
import lxml.etree as etree
DEFAULT_BOOKINFO = dcparser.BookInfo(
{ RDFNS('about'): u'http://wiki.wolnepodreczniki.pl/Lektury:Template'},
- { DCNS('creator'): [u'Some, Author'],
+ {
+ DCNS('creator.expert'): [u'Some, Author'],
+ DCNS('creator.scenario'): [u'Some, Author'],
+ DCNS('creator.textbook'): [u'Some, Author'],
DCNS('title'): [u'Some Title'],
DCNS('subject.period'): [u'Unknown'],
DCNS('subject.type'): [u'Unknown'],
Wolne Lektury (http://wolnelektury.pl). Reprodukcja cyfrowa
wykonana przez Bibliotekę Narodową z egzemplarza
pochodzącego ze zbiorów BN."""],
- DCNS('identifier.url'):
- [u"http://wolnelektury.pl/katalog/lektura/template"],
+ DCNS('identifier.url'): [WLURI.example],
DCNS('rights'):
[u"Domena publiczna - zm. [OPIS STANU PRAWNEGO TEKSTU]"] })
return os.path.join(os.path.dirname(__file__), path)
-class OutputFile(object):
- """Represents a file returned by one of the converters."""
-
+class IOFile(object):
+ """ Represents a file fed as input or returned as a result. """
_string = None
_filename = None
+ _filename_tmp = False
+
+ def __init__(self, attachments=None):
+ self.attachments = attachments or {}
def __del__(self):
- if self._filename:
+ if self._filename_tmp:
os.unlink(self._filename)
def __nonzero__(self):
return self._string is not None or self._filename is not None
@classmethod
- def from_string(cls, string):
+ def from_string(cls, string, *args, **kwargs):
"""Converter returns contents of a file as a string."""
- instance = cls()
+ instance = cls(*args, **kwargs)
instance._string = string
return instance
@classmethod
- def from_filename(cls, filename):
+ def from_filename(cls, filename, *args, **kwargs):
"""Converter returns contents of a file as a named file."""
- instance = cls()
+ instance = cls(*args, **kwargs)
instance._filename = filename
return instance
temp.write(self._string)
temp.close()
self._filename = temp.name
+ self._filename_tmp = True
return self._filename
else:
return None
if not os.path.isdir(dirname):
os.makedirs(dirname)
shutil.copy(self.get_filename(), path)
+
+ def dump_to(self, path, directory=None):
+ """ Path should be name for main file. """
+ self.save_as(path)
+ dirname = os.path.dirname(os.path.abspath(path))
+ for filename, attachment in self.attachments.items():
+ attachment.save_as(os.path.join(dirname, filename))
+
+
+class Format(object):
+ """ Generic format class. """
+ def __init__(self, wldoc, **kwargs):
+ self.wldoc = wldoc
+ self.customization = kwargs
+
+ def build(self):
+ raise NotImplementedError
+
+
+class URLOpener(urllib.FancyURLopener):
+ version = 'FNP Librarian (http://github.com/fnp/librarian)'
+urllib._urlopener = URLOpener()