librarian/book2anything.py

   1 #!/usr/bin/env python
   2 # -*- coding: utf-8 -*-
   3 #
   4 # This file is part of Librarian, licensed under GNU Affero GPLv3 or later.
   5 # Copyright © Fundacja Nowoczesna Polska. See NOTICE for more information.
   6 #
   7 from collections import namedtuple
   8 import os.path
   9 import optparse
  10
  11 from librarian import DirDocProvider, ParseError
  12 from librarian.parser import WLDocument
  13 from librarian.cover import DefaultEbookCover
  14
  15
  16 class Option(object):
  17     """Option for optparse. Use it like `optparse.OptionParser.add_option`."""
  18     def __init__(self, *names, **options):
  19         self.names = names
  20         self.options = options
  21
  22     def add(self, parser):
  23         parser.add_option(*self.names, **self.options)
  24
  25     def name(self):
  26         return self.options['dest']
  27
  28     def value(self, options):
  29         return getattr(options, self.name())
  30
  31
  32 class Book2Anything(object):
  33     """A class for creating book2... scripts.
  34
  35     Subclass it for any format you want to convert to.
  36     """
  37     format_name = None # Set format name, like "PDF".
  38     ext = None # Set file extension, like "pdf".
  39     uses_cover = False # Can it add a cover?
  40     cover_optional = True # Only relevant if uses_cover
  41     uses_provider = False # Does it need a DocProvider?
  42     transform = None # Transform method. Uses WLDocument.as_{ext} by default.
  43     parser_options = [] # List of Option objects for additional parser args.
  44     transform_options = [] # List of Option objects for additional transform args.
  45     transform_flags = [] # List of Option objects for supported transform flags.
  46
  47
  48     @classmethod
  49     def run(cls):
  50         # Parse commandline arguments
  51         usage = """Usage: %%prog [options] SOURCE [SOURCE...]
  52         Convert SOURCE files to %s format.""" % cls.format_name
  53
  54         parser = optparse.OptionParser(usage=usage)
  55
  56         parser.add_option('-v', '--verbose',
  57                 action='store_true', dest='verbose', default=False,
  58                 help='print status messages to stdout')
  59         parser.add_option('-t', '--html-toc',
  60                 action='store_true', dest='html_toc', default=False,
  61                 help='with inline html toc [book2epub only]')
  62         parser.add_option('-k', '--use-kindlegen',
  63                 action='store_true', dest='use_kindlegen', default=False,
  64                 help='use kindlegen tool [book2mobi only]')
  65         parser.add_option('-d', '--make-dir',
  66                 action='store_true', dest='make_dir', default=False,
  67                 help='create a directory for author and put the output file in it')
  68         parser.add_option('-o', '--output-file',
  69                 dest='output_file', metavar='FILE',
  70                 help='specifies the output file')
  71         parser.add_option('-O', '--output-dir',
  72                 dest='output_dir', metavar='DIR',
  73                 help='specifies the directory for output')
  74         if cls.uses_cover:
  75             if cls.cover_optional:
  76                 parser.add_option('-c', '--with-cover',
  77                         action='store_true', dest='with_cover', default=False,
  78                         help='create default cover')
  79             parser.add_option('-C', '--image-cache',
  80                     dest='image_cache', metavar='URL',
  81                     help='prefix for image download cache' +
  82                         (' (implies --with-cover)' if cls.cover_optional else ''))
  83         for option in cls.parser_options + cls.transform_options + cls.transform_flags:
  84             option.add(parser)
  85
  86         options, input_filenames = parser.parse_args()
  87
  88         if len(input_filenames) < 1:
  89             parser.print_help()
  90             return(1)
  91
  92         # Prepare additional args for parser.
  93         parser_args = {}
  94         for option in cls.parser_options:
  95             parser_args[option.name()] = option.value(options)
  96         # Prepare additional args for transform method.
  97         transform_args = {}
  98         for option in cls.transform_options:
  99             transform_args[option.name()] = option.value(options)
 100         # Add flags to transform_args, if any.
 101         transform_flags = [flag.name() for flag in cls.transform_flags
 102                     if flag.value(options)]
 103         if transform_flags:
 104             transform_args['flags'] = transform_flags
 105         # Add cover support, if any.
 106         if options.html_toc and cls.ext == 'epub':
 107             transform_args['html_toc'] = True
 108         if options.use_kindlegen and cls.ext == 'mobi':
 109             transform_args['use_kindlegen'] = True
 110         if cls.uses_cover:
 111             if options.image_cache:
 112                 def cover_class(*args, **kwargs):
 113                     return DefaultEbookCover(image_cache=options.image_cache, *args, **kwargs)
 114                 transform_args['cover'] = cover_class
 115             elif not cls.cover_optional or options.with_cover:
 116                 transform_args['cover'] = DefaultEbookCover
 117
 118
 119         # Do some real work
 120         try:
 121             for main_input in input_filenames:
 122                 if options.verbose:
 123                     print main_input
 124
 125             # Where to find input?
 126             if cls.uses_provider:
 127                 path, fname = os.path.realpath(main_input).rsplit('/', 1)
 128                 provider = DirDocProvider(path)
 129             else:
 130                 provider = None
 131
 132             # Where to write output?
 133             if not (options.output_file or options.output_dir):
 134                 output_file = os.path.splitext(main_input)[0] + '.' + cls.ext
 135             else:
 136                 output_file = None
 137
 138             # Do the transformation.
 139             doc = WLDocument.from_file(main_input, provider=provider, **parser_args)
 140             transform = cls.transform
 141             if transform is None:
 142                 transform = getattr(WLDocument, 'as_%s' % cls.ext)
 143             output = transform(doc, **transform_args)
 144
 145             doc.save_output_file(output,
 146                 output_file, options.output_dir, options.make_dir, cls.ext)
 147
 148         except ParseError, e:
 149             print '%(file)s:%(name)s:%(message)s' % {
 150                 'file': main_input,
 151                 'name': e.__class__.__name__,
 152                 'message': e
 153             }