scripts/convert-ly.py

   1 #!@TARGET_PYTHON@
   2
   3 # convert-ly.py -- Update old LilyPond input files (fix name?)
   4 # converting rules are found in python/convertrules.py
   5
   6 # This file is part of LilyPond, the GNU music typesetter.
   7 #
   8 # Copyright (C) 1998--2010  Han-Wen Nienhuys <hanwen@xs4all.nl>
   9 #                 Jan Nieuwenhuizen <janneke@gnu.org>
  10 #
  11 # LilyPond is free software: you can redistribute it and/or modify
  12 # it under the terms of the GNU General Public License as published by
  13 # the Free Software Foundation, either version 3 of the License, or
  14 # (at your option) any later version.
  15 #
  16 # LilyPond is distributed in the hope that it will be useful,
  17 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  18 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  19 # GNU General Public License for more details.
  20 #
  21 # You should have received a copy of the GNU General Public License
  22 # along with LilyPond.  If not, see <http://www.gnu.org/licenses/>.
  23
  24 import os
  25 import sys
  26 import re
  27
  28 """
  29 @relocate-preamble@
  30 """
  31
  32 import lilylib as ly
  33 global _;_=ly._
  34
  35 ly.require_python_version ()
  36
  37 import convertrules
  38
  39 lilypond_version_re_str = '\\\\version *\"([0-9.]+)"'
  40 lilypond_version_re = re.compile (lilypond_version_re_str)
  41
  42
  43 help_summary = (
  44 _ ('''Update LilyPond input to newer version.  By default, update from the
  45 version taken from the \\version command, to the current LilyPond version.''')
  46 + _ ("Examples:")
  47 + '''
  48   $ convert-ly -e old.ly
  49   $ convert-ly --from=2.3.28 --to=2.5.21 foobar.ly > foobar-new.ly
  50 ''')
  51
  52 copyright = ('Jan Nieuwenhuizen <janneke@gnu.org>',
  53              'Han-Wen Nienhuys <hanwen@xs4all.nl>')
  54
  55 program_name = os.path.basename (sys.argv[0])
  56 program_version = '@TOPLEVEL_VERSION@'
  57
  58 authors = ('Jan Nieuwenhuizen <janneke@gnu.org>',
  59            'Han-Wen Nienhuys <hanwen@xs4all.nl>')
  60
  61 error_file_write = ly.stderr_write
  62
  63 def warning (s):
  64     ly.stderr_write (program_name + ": " + _ ("warning: %s") % s + '\n')
  65
  66 def error (s):
  67     ly.stderr_write (program_name + ": " + _ ("error: %s") % s + '\n')
  68
  69 def identify (port=sys.stderr):
  70     ly.encoded_write (port, '%s (GNU LilyPond) %s\n' % (program_name, program_version))
  71
  72 def warranty ():
  73     identify ()
  74     ly.encoded_write (sys.stdout, '''
  75 %s
  76
  77 %s
  78
  79 %s
  80 %s
  81 ''' % ( _ ('Copyright (c) %s by') % '2001--2010',
  82         ' '.join (authors),
  83         _ ('Distributed under terms of the GNU General Public License.'),
  84         _ ('It comes with NO WARRANTY.')))
  85
  86 def get_option_parser ():
  87     p = ly.get_option_parser (usage=_ ("%s [OPTION]... FILE") % 'convert-ly',
  88                   description=help_summary,
  89                   add_help_option=False)
  90
  91     p.version="@TOPLEVEL_VERSION@"
  92     p.add_option("--version",
  93                  action="version",
  94                  help=_ ("show version number and exit"))
  95
  96     p.add_option("-h", "--help",
  97                  action="help",
  98                  help=_ ("show this help and exit"))
  99
 100     p.add_option ('-f', '--from',
 101               action="store",
 102               metavar=_ ("VERSION"),
 103               dest="from_version",
 104               help=_ ("start from VERSION [default: \\version found in file]"),
 105               default='')
 106
 107     p.add_option ('-e', '--edit', help=_ ("edit in place"),
 108               action='store_true')
 109
 110     p.add_option ('-n', '--no-version',
 111               help=_ ("do not add \\version command if missing"),
 112               action='store_true',
 113               dest='skip_version_add',
 114               default=False)
 115
 116     p.add_option ('-c', '--current-version',
 117               help=_ ("force updating \\version number to %s") % program_version,
 118               action='store_true',
 119               dest='force_current_version',
 120               default=False)
 121
 122     p.add_option ("-s", '--show-rules',
 123               help=_ ("show rules [default: -f 0, -t %s]") % program_version,
 124               dest='show_rules',
 125               action='store_true', default=False)
 126
 127     p.add_option ('-t', '--to',
 128               help=_ ("convert to VERSION [default: %s]") % program_version,
 129               metavar=_ ('VERSION'),
 130               action='store',
 131               dest="to_version",
 132               default='')
 133     p.add_option ('-w', '--warranty', help=_ ("show warranty and copyright"),
 134            action='store_true',
 135            ),
 136     p.add_option_group ('',
 137                         description=(
 138             _ ("Report bugs via %s")
 139             % 'http://post.gmane.org/post.php'
 140             '?group=gmane.comp.gnu.lilypond.bugs') + '\n')
 141
 142     return p
 143
 144
 145
 146 def str_to_tuple (s):
 147     return tuple ([int(n) for n in s.split ('.')])
 148
 149 def tup_to_str (t):
 150     return '.'.join (['%s' % x for x in t])
 151
 152 def version_cmp (t1, t2):
 153     for x in [0, 1, 2]:
 154         if t1[x] - t2[x]:
 155             return t1[x] - t2[x]
 156     return 0
 157
 158 def get_conversions (from_version, to_version):
 159     def is_applicable (v, f = from_version, t = to_version):
 160         return version_cmp (v[0], f) > 0 and version_cmp (v[0], t) <= 0
 161     return filter (is_applicable, convertrules.conversions)
 162
 163 def latest_version ():
 164     return convertrules.conversions[-1][0]
 165
 166 def show_rules (file, from_version, to_version):
 167     for x in convertrules.conversions:
 168         if (not from_version or x[0] > from_version) \
 169            and (not to_version or x[0] <= to_version):
 170             ly.encoded_write  (file, '%s: %s\n' % (tup_to_str (x[0]), x[2]))
 171
 172 def do_conversion (str, from_version, to_version):
 173     """Apply conversions from FROM_VERSION to TO_VERSION.  Return
 174 tuple (LAST,STR), with the last succesful conversion and the resulting
 175 string."""
 176     conv_list = get_conversions (from_version, to_version)
 177
 178     error_file_write (_ ("Applying conversion: "))
 179
 180     last_conversion = ()
 181     try:
 182         for x in conv_list:
 183             error_file_write (tup_to_str (x[0]))
 184             if x != conv_list[-1]:
 185                 error_file_write (', ')
 186             str = x[1] (str)
 187             last_conversion = x[0]
 188
 189     except convertrules.FatalConversionError:
 190         error_file_write ('\n'
 191                           + _ ("Error while converting")
 192                           + '\n'
 193                           + _ ("Stopping at last successful rule")
 194                           + '\n')
 195
 196     return (last_conversion, str)
 197
 198
 199
 200 def guess_lilypond_version (input):
 201     m = lilypond_version_re.search (input)
 202     if m:
 203         return m.group (1)
 204     else:
 205         return ''
 206
 207 class FatalConversionError:
 208     pass
 209
 210 class UnknownVersion:
 211     pass
 212
 213 def do_one_file (infile_name):
 214     ly.stderr_write (_ ("Processing `%s\'... ") % infile_name)
 215     sys.stderr.write ('\n')
 216
 217     if infile_name:
 218         infile = open (infile_name, 'r')
 219         input = infile.read ()
 220         infile.close ()
 221     else:
 222         input = sys.stdin.read ()
 223
 224     from_version = None
 225     to_version = None
 226     if global_options.from_version:
 227         from_version = global_options.from_version
 228     else:
 229         guess = guess_lilypond_version (input)
 230         if not guess:
 231             raise UnknownVersion ()
 232         from_version = str_to_tuple (guess)
 233
 234     if global_options.to_version:
 235         to_version = global_options.to_version
 236     else:
 237         to_version = latest_version ()
 238
 239
 240     (last, result) = do_conversion (input, from_version, to_version)
 241
 242     if last:
 243         if global_options.force_current_version and last == to_version:
 244             last = str_to_tuple (program_version)
 245
 246         newversion = r'\version "%s"' % tup_to_str (last)
 247         if lilypond_version_re.search (result):
 248             result = re.sub (lilypond_version_re_str,
 249                      '\\' + newversion, result)
 250         elif not global_options.skip_version_add:
 251             result = newversion + '\n' + result
 252
 253         error_file_write ('\n')
 254
 255         if global_options.edit:
 256             try:
 257                 os.remove(infile_name + '~')
 258             except:
 259                 pass
 260             os.rename (infile_name, infile_name + '~')
 261             outfile = open (infile_name, 'w')
 262         else:
 263             outfile = sys.stdout
 264
 265
 266         outfile.write (result)
 267
 268     sys.stderr.flush ()
 269
 270 def do_options ():
 271     opt_parser = get_option_parser()
 272     (options, args) = opt_parser.parse_args ()
 273
 274     if options.warranty:
 275         warranty ()
 276         sys.exit (0)
 277
 278     if options.from_version:
 279         options.from_version = str_to_tuple (options.from_version)
 280     if options.to_version:
 281         options.to_version = str_to_tuple (options.to_version)
 282
 283     options.outfile_name = ''
 284     global global_options
 285     global_options = options
 286
 287     if not args and not options.show_rules:
 288         opt_parser.print_help ()
 289         sys.exit (2)
 290
 291     return args
 292
 293 def main ():
 294     files = do_options ()
 295
 296     # should parse files[] to read \version?
 297     if global_options.show_rules:
 298         show_rules (sys.stdout, global_options.from_version, global_options.to_version)
 299         sys.exit (0)
 300
 301     identify (sys.stderr)
 302
 303     for f in files:
 304         if f == '-':
 305             f = ''
 306         elif not os.path.isfile (f):
 307             error (_ ("cannot open file: `%s'") % f)
 308             if len (files) == 1:
 309                 sys.exit (1)
 310             continue
 311         try:
 312             do_one_file (f)
 313         except UnknownVersion:
 314             error (_ ("cannot determine version for `%s'.  Skipping") % f)
 315
 316     sys.stderr.write ('\n')
 317
 318 main ()