]> git.donarmstrong.com Git - lilypond.git/blobdiff - scripts/auxiliar/translations-status.py
translations-status.py: Remove inline html from texi_status.
[lilypond.git] / scripts / auxiliar / translations-status.py
index c6b2557e41366be858c4b77b6177d22e25bf6178..c4f09ac2ec4bc98f84983f328f9643968f1ddafe 100755 (executable)
@@ -49,10 +49,9 @@ title_re = re.compile ('^@(settitle|chapter|top|(?:sub){0,2}section|'
 include_re = re.compile ('^@include (.*?)$', re.M)
 
 # allow multiple lines
-translators_re = re.compile (r'^@c[ ]+[tT]ranslators?[ ]*:[ ]*(.*?)$', re.M | re.I)
-checkers_re = re.compile (r'^@c[ ]+Translation[ ]*checkers?[ ]*:[ ]*(.*?)$',
-                          re.M | re.I)
-status_re = re.compile (r'^@c[ ]+Translation[ ]*status[ ]*:[ ]*(.*?)$', re.M | re.I)
+translators_re = re.compile (r'^@c[ ]+[Tt]ranslators?[ ]*:[ ]*(.*?)$', re.M)
+checkers_re = re.compile (r'^@c[ ]+[Tt]ranslation[ ]*[Cc]heckers?[ ]*:[ ]*(.*?)$', re.M)
+status_re = re.compile (r'^@c[ ]+[Tt]ranslation[ ]*[Ss]tatus[ ]*:[ ]*(.*?)$', re.M)
 post_gdp_re = re.compile ('post.GDP', re.I)
 untranslated_node_str = '@untranslated'
 skeleton_str = '-- SKELETON FILE --'
@@ -178,6 +177,59 @@ def tely_word_count (tely_doc):
     nodes = node_re.split (tely_doc)
     return [len (space_re.split (n)) for n in nodes]
 
+class HTMLMarkup (object):
+    def entity (self, name, string='', attributes=[]):
+        attr_list = ''.join ([' %s="%s"' % x for x in attributes])
+        return '<%(name)s%(attr_list)s>%(string)s</%(name)s>' % locals ()
+    def paragraph (self, string=''):
+        return self.entity ('p')
+    def table (self, string):
+        return self.entity ('table', string, [('align', 'center'), ('border', '2')])
+    def row (self, string, attributes=[]):
+        return self.entity ('tr', string, attributes)
+    headrow = row
+    def headcell (self, string, attributes=[]):
+        return self.entity ('th', string, attributes)
+    def cell (self, string, attributes=[]):
+        return self.entity ('td', string, attributes)
+    def newline (self, attributes=[]):
+        return self.entity ('br', '', attributes)[:-5]
+    def span (self, string, attributes=[]):
+        return self.entity ('span', string, attributes)
+    def small (self, string, attributes=[]):
+        return self.entity ('small', string, attributes)
+
+class TexiMarkup (HTMLMarkup):
+    def entity (self, name, string='', attributes=[]):
+        return '''
+@%(name)s
+%(string)s
+@end %(name)s
+''' % locals ()
+    def paragraph (self, string=''):
+        return '''
+%(string)s''' % locals ()
+    def table (self, string):
+        return self.entity ('multitable', string)
+    def headrow (self, string, attributes=[]):
+        return '''
+@headitem ''' + string
+    def row (self, string, attributes=[]):
+        return '''
+@item ''' + string
+    def cell (self, string, attributes=[]):
+        return '''
+@tab ''' + string
+    headcell = cell
+    def newline (self):
+        return '''
+@* '''
+    def html (self, string):
+        return self.entity ('ifhtml', self.entity ('html', string))
+    def span (self, string, attributes=[]):
+        return self.html (HTMLMarkup.span (self, string, attributes))
+    def small (self, string, attributes=[]):
+        return self.html (HTMLMarkup.small (self, string, attributes))
 
 class TelyDocument (object):
     def __init__ (self, filename):
@@ -185,7 +237,6 @@ class TelyDocument (object):
         self.contents = 'GIT committish: 0'
         if os.path.exists (filename):
             self.contents = open (filename).read ()
-        self.top = os.path.splitext (filename)[1] in ['.tely', '.texi']
         ## record title and sectionning level of first Texinfo section
         self.sectioning = 'unnumbered'
         self.title = 'Untitled'
@@ -193,13 +244,6 @@ class TelyDocument (object):
         if m:
             self.sectioning = m.group (1)
             self.title = m.group (2)
-        # This is all quite ugly and hairy.  The original code worked
-        # with @top node detection and each manual had its own @top
-        # node.  Not any more.  Declaring .tely / .texi files to be
-        # @top sort of works...
-        if self.top:
-            self.sectioning = 'top'
-        self.level = texi_level [self.sectioning]
 
         if not hasattr (self, 'language'):
             self.language = ''
@@ -216,7 +260,12 @@ class TelyDocument (object):
                           for t in include_re.findall (self.contents)]
         self.included_files = [p for p in included_files if os.path.exists (p)]
 
+    def get_level (self):
+        return texi_level [self.sectioning]
+
     def print_title (self, section_number):
+        if not hasattr (self, 'level'):
+            self.level = self.get_level ()
         return section_number.increase (self.level) + self.title
 
 
@@ -248,12 +297,15 @@ class TranslatedTelyDocument (TelyDocument):
         if m:
             self.translators = [n.strip () for n in
                                 reduce (operator.add, [n.split (',') for n in m])]
+        if self.language != self.filename[:2]:
+            print 'Barf:', self.filename
+            barf
         if (not isinstance (self, UntranslatedTelyDocument)
             and (not self.translators or not self.translators[0])
             and not 'macros.itexi' in self.filename):
-            error ('%s: no translator name found, \nplease \
-specify at least one in the master file as a line containing\n\
-@c Translators: FirstName1 LastName1, FirstName2 LastName2' % self.filename)
+            error (self.filename + ''': error: no translator name found
+please specify one ore more lines in the master file
+@c Translator: FirstName LastName[, FirstName LastName]..''')
         self.checkers = []
         m = checkers_re.findall (self.contents)
         if m:
@@ -311,6 +363,9 @@ setting to %d %%" % (self.filename, self.uptodate_percentage, alternative))
 setting to %d %%" % (self.filename, self.uptodate_percentage, alternative))
                 self.uptodate_percentage = alternative
 
+    def get_level (self):
+        return texi_level ['top']
+
     def completeness (self, formats=['long'], translated=False):
         if translated:
             translation = self.translation
@@ -358,80 +413,88 @@ setting to %d %%" % (self.filename, self.uptodate_percentage, alternative))
         else:
             return self.translation (format_table['pre-GDP'])
 
-    def short_texi_status (self):
-        s = '  <td>'
+    def short_texi_status (self, markup):
+        s = ''
         if self.partially_translated:
-            s += '<br>\n   '.join (self.translators) + '<br>\n'
+            s += markup.newline ().join (self.translators + [''])
             if self.checkers:
-                s += '   <small>' + \
-                    '<br>\n   '.join (self.checkers) + '</small><br>\n'
-
+                s += markup.small (markup.newline ().join (self.checkers + ['']))
         c = self.completeness (['color', 'long'])
-        s += '   <span style="background-color: #%(color)s">\
-%(long)s</span><br>\n' % c
-
+        s += markup.span ('%(long)s' % c, [('style', 'background-color: #%(color)s' % c)])
+        s += markup.newline ()
         if self.partially_translated:
             u = self.uptodateness (['vague', 'color'])
-            s += '   <span style="background-color: #%(color)s">\
-%(vague)s</span><br>\n' % u
-
-        s += '  </td>\n'
-        return s
+            s += markup.span ('%(vague)s' % u, [('style', 'background-color: #%(color)s' % u)])
+        return markup.cell (s, [('title', filename)])
 
     def text_status (self):
         s = self.completeness ('abbr')['abbr'] + ' '
-
         if self.partially_translated:
             s += self.uptodateness ('abbr')['abbr'] + ' '
         return s
 
-    def texi_status (self, numbering=SectionNumber ()):
-        if self.title == 'Untitled':
-            return ''
-
-        if self.top:
-            s = '''<table align="center" border="2">
- <tr align="center">
-  <th>%s</th>''' % self.print_title (numbering)
-            s += ''.join (['  <th>%s</th>\n' % self.translation (h)
-                           for h in detailed_status_heads])
-            s += ' </tr>\n'
-            s += ' <tr align="left">\n  <td>%s<br>(%d)</td>\n' \
-                % (self.translation (section_titles_string),
-                   sum (self.masterdocument.word_count))
-
-        else:
-            s = ' <tr align="left">\n  <td>%s<br>(%d)</td>\n' \
-                % (self.print_title (numbering),
-                   sum (self.masterdocument.word_count))
-
+    def texi_status (self, markup, numbering=SectionNumber ()):
+        return (markup.table (
+                markup.headrow (
+                    (markup.headcell (self.print_title (numbering))
+                     + ''.join ([markup.headcell (self.translation (h))
+                                 for h in detailed_status_heads])),
+                    [('align', 'center')])
+                + markup.row (
+                    (markup.cell (((self.translation (section_titles_string)
+                                    + markup.newline ()
+                                    + '%d' % sum (self.masterdocument.word_count))) % self.__dict__,
+                                  [('title',filename)])
+                     + self.texi_body (markup, numbering)),
+                    [('align','left')])
+                + self.texi_translations (markup, numbering))
+                ) + markup.paragraph ()
+
+    def texi_body (self, markup, numbering):
+        return (self.texi_translators (markup)
+                + self.texi_completeness (markup)
+                + self.texi_uptodateness (markup)
+                + self.texi_gdp (markup))
+
+    def texi_translators (self, markup):
         if self.partially_translated:
-            s += '  <td>' + '<br>\n   '.join (self.translators) + '</td>\n'
-            s += '  <td>' + '<br>\n   '.join (self.checkers) + '</td>\n'
-        else:
-            s += '  <td></td>\n' * 2
+            return ('  <td>' + '<br>\n   '.join (self.translators) + '</td>\n'
+                    + '  <td>' + '<br>\n   '.join (self.checkers) + '</td>\n')
+        return '  <td></td>\n' * 2
 
+    def texi_completeness (self, markup):
         c = self.completeness (['color', 'short'], translated=True)
-        s += '  <td><span style="background-color: #%(color)s">\
+        return '  <td><span style="background-color: #%(color)s">\
 %(short)s</span></td>\n' % {'color': c['color'],
                            'short': c['short']}
 
+    def texi_uptodateness (self, markup):
         if self.partially_translated:
             u = self.uptodateness (['short', 'color'], translated=True)
-            s += '  <td><span style="background-color: #%(color)s">\
+            return '  <td><span style="background-color: #%(color)s">\
 %(short)s</span></td>\n' % {'color': u['color'],
                            'short': u['short']}
-        else:
-            s += '  <td></td>\n'
-
-        s += '  <td>' + self.gdp_status () + '</td>\n </tr>\n'
-        s += ''.join ([i.translations[self.language].texi_status (numbering)
-                       for i in self.masterdocument.includes
-                       if self.language in i.translations])
-
-        if self.top:
-            s += '</table>\n<p></p>\n'
-        return s
+        return '  <td></td>\n'
+
+    def texi_gdp (self, markup):
+        return '  <td>' + self.gdp_status () + '</td>\n </tr>\n'
+
+    def texi_translations (self, markup, numbering):
+        return ''.join ([i.translations[self.language].texi_status (markup, numbering)
+                         for i in self.masterdocument.includes
+                         if self.language in i.translations])
+
+class IncludedTranslatedTelyDocument (TranslatedTelyDocument):
+    get_level = TelyDocument.get_level
+    def texi_status (self, markup, numbering=SectionNumber ()):
+        if self.title != 'Untitled':
+            return ((' <tr align="left">\n  <td title="%%(filename)s">%s<br>(%d)</td>\n'
+                     % (self.print_title (numbering),
+                        sum (self.masterdocument.word_count))) % self.__dict__
+                    + self.texi_body (markup, numbering)
+                    + '</tr>'
+                    + self.texi_translations (markup, numbering))
+        return ''
 
 class UntranslatedTelyDocument (TranslatedTelyDocument):
     def __init__ (self, filename, masterdocument, parent_translation=None):
@@ -439,6 +502,9 @@ class UntranslatedTelyDocument (TranslatedTelyDocument):
             self.language = filename[:2]
         TranslatedTelyDocument.__init__ (self, filename, masterdocument, parent_translation)
 
+class IncludedUntranslatedTelyDocument (UntranslatedTelyDocument, IncludedTranslatedTelyDocument):
+    get_level = TelyDocument.get_level
+
 class MasterTelyDocument (TelyDocument):
     def __init__ (self,
                   filename,
@@ -448,31 +514,25 @@ class MasterTelyDocument (TelyDocument):
         self.size = len (self.contents)
         self.word_count = tely_word_count (self.contents)
         self.translations = {}
-        found = {}
-        translations = dict ([(lang, os.path.join (lang, filename))
-                              for lang in langdefs.LANGDICT])
+        self.includes = []
         if not self.language or self.language == 'en':
             languages = [x for x in parent_translations.keys () if x != 'en']
-            for lang in languages:
-                if os.path.exists (translations[lang]):
-                    found[lang] = True
-                    self.translations[lang] = TranslatedTelyDocument (translations[lang],
-                                                                      self,
-                                                                      parent_translations.get (lang))
-                else:
-                    self.translations[lang] = UntranslatedTelyDocument (translations[lang],
-                                                                        self,
-                                                                        parent_translations.get (lang))
-            if self.top:
-                for lang in [x for x in langdefs.LANGDICT if x and x != 'en']:
-                    if not found.has_key (lang):
-                        del self.translations[lang]
-
-        if self.translations:
-            self.includes = [MasterTelyDocument (f, self.translations)
-                             for f in self.included_files]
-        else:
-            self.includes = []
+            self.translations = dict ([x for x in
+                                       [(lang, self.translated_factory (os.path.join (lang, self.filename),
+                                                                        parent_translations.get (lang)))
+                                        for lang in languages]
+                                       if x[1]])
+            if self.translations:
+                self.includes = [IncludedMasterTelyDocument (f, self.translations)
+                                 for f in self.included_files]
+
+    def get_level (self):
+        return texi_level ['top']
+
+    def translated_factory (self, filename, parent):
+        if os.path.exists (filename):
+            return TranslatedTelyDocument (filename, self, parent)
+        return None
 
     def update_word_counts (self, s):
         s = update_word_count (s, self.filename, sum (self.word_count))
@@ -480,57 +540,68 @@ class MasterTelyDocument (TelyDocument):
             s = i.update_word_counts (s)
         return s
 
-    def texi_status (self, numbering=SectionNumber ()):
-        if self.title == 'Untitled' or not self.translations:
-            return ''
-        if self.top:
-            s = '''<table align="center" border="2">
+    def texi_status (self, markup, numbering=SectionNumber ()):
+        s = '''
  <tr align="center">
   <th>%s</th>''' % self.print_title (numbering)
-            s += ''.join (['  <th>%s</th>\n' % l for l in self.translations])
-            s += ' </tr>\n'
-            s += ' <tr align="left">\n  <td>Section titles<br>(%d)</td>\n' \
-                % sum (self.word_count)
-
-        else:  # if self is an included file
-           s = ' <tr align="left">\n  <td>%s<br>(%d)</td>\n' \
-                % (self.print_title (numbering), sum (self.word_count))
-
-        s += ''.join ([t.short_texi_status ()
-                       for t in self.translations.values ()])
+        s += ''.join (['  <th>%s</th>\n' % l for l in sorted (self.translations.keys ())])
         s += ' </tr>\n'
-        s += ''.join ([i.texi_status (numbering) for i in self.includes])
-
-        if self.top:
-            s += '</table>\n<p></p>\n'
+        s += (' <tr align="left">\n  <td title="%%(filename)s">Section titles<br>(%d)</td>\n'
+              % sum (self.word_count)) % self.__dict__
+        s += self.texi_body (markup, numbering)
+        s += ' </tr>\n'
+        s += self.texi_includes (markup, numbering)
+        return markup.table (s) + markup.paragraph ()
+
+    def texi_includes (self, markup, numbering):
+        return ''.join ([i.texi_status (markup, numbering) for i in self.includes])
+
+    def texi_body (self, markup, numbering):
+        return (''.join ([self.translations[k].short_texi_status (markup)
+                          for k in sorted (self.translations.keys ())])
+                + ' </tr>\n')
+
+    def text_status (self, markup, numbering=SectionNumber (), colspec=[48,12]):
+        s = (self.print_title (numbering) + ' ').ljust (colspec[0])
+        s += ''.join (['%s'.ljust (colspec[1]) % l
+                       for l in sorted (self.translations.keys ())])
+        s += '\n'
+        s += ('Section titles (%d)' % \
+                  sum (self.word_count)).ljust (colspec[0])
+        s += self.text_body (markup, numbering, colspec)
+        s += '\n'
         return s
 
-    def text_status (self, numbering=SectionNumber (), colspec=[48,12]):
-        if self.title == 'Untitled' or not self.translations:
-            return ''
-
-        s = ''
-        if self.top:
-            s += (self.print_title (numbering) + ' ').ljust (colspec[0])
-            s += ''.join (['%s'.ljust (colspec[1]) % l
-                           for l in self.translations])
-            s += '\n'
-            s += ('Section titles (%d)' % \
-                      sum (self.word_count)).ljust (colspec[0])
-
-        else:
-            s = '%s (%d) ' \
-                % (self.print_title (numbering), sum (self.word_count))
-            s = s.ljust (colspec[0])
+    def text_body (self, markup, numbering, colspec):
+        return (''.join ([self.translations[k].text_status ().ljust(colspec[1])
+                          for k in sorted (self.translations.keys ())])
+                + '\n\n'
+                + ''.join ([i.text_status (markup, numbering) for i in self.includes]))
 
-        s += ''.join ([t.text_status ().ljust(colspec[1])
-                       for t in self.translations.values ()])
-        s += '\n\n'
-        s += ''.join ([i.text_status (numbering) for i in self.includes])
+class IncludedMasterTelyDocument (MasterTelyDocument):
+    get_level = TelyDocument.get_level
 
-        if self.top:
-            s += '\n'
-        return s
+    def translated_factory (self, filename, parent):
+        if os.path.exists (filename):
+            return IncludedTranslatedTelyDocument (filename, self, parent)
+        return IncludedUntranslatedTelyDocument (filename, self, parent)
+
+    def texi_status (self, markup, numbering=SectionNumber ()):
+        if self.title != 'Untitled':
+            return ((' <tr align="left">\n  <td title=%%(filename)s>%s<br>(%d)</td>\n'
+                     % (self.print_title (numbering), sum (self.word_count))) % self.__dict__
+                    + self.texi_body (markup, numbering)
+                    + '</tr>'
+                    + self.texi_includes (markup, numbering))
+        return ''
+
+    def text_status (self, markup, numbering=SectionNumber (), colspec=[48,12]):
+        if self.title != 'Untitled':
+            return (('%s (%d) '
+                     % (self.print_title (numbering), sum (self.word_count)))
+                    + self.text_body (markup, numbering, colspec)
+                    ).ljust (colspec[0])
+        return ''
 
 
 update_category_word_counts_re = re.compile (r'(?ms)^-(\d+)-(.*?\n)\d+ *total')
@@ -563,8 +634,10 @@ progress ("Generating status pages...")
 
 date_time = buildlib.read_pipe ('LANG= date -u')[0]
 
+markup = HTMLMarkup ()
+#markup = TexiMarkup ()
 main_status_body = last_updated_string % date_time
-main_status_body += '\n'.join ([doc.texi_status () for doc in master_docs])
+main_status_body += '\n'.join ([doc.texi_status (markup) for doc in master_docs])
 
 texi_header = '''@c -*- coding: utf-8; mode: texinfo; -*-
 @c This file was generated by translation-status.py -- DO NOT EDIT!
@@ -591,7 +664,7 @@ open ('translations.itexi', 'w').write (main_status_page)
 for l in enabled_languages:
     date_time = buildlib.read_pipe ('LANG=%s date -u' % l)[0]
     updated = translation[l] (last_updated_string) % date_time
-    texi_status = '\n'.join ([doc.translations[l].texi_status ()
+    texi_status = '\n'.join ([doc.translations[l].texi_status (markup)
                               for doc in master_docs
                               if l in doc.translations])
     lang_status_page = texi_header + updated + texi_status + texi_footer
@@ -604,7 +677,7 @@ FT = fully translated
 
 ''' % date_time
 
-main_status_txt += '\n'.join ([doc.text_status () for doc in master_docs])
+main_status_txt += '\n'.join ([doc.text_status (markup) for doc in master_docs])
 
 status_txt_file = 'out/translations-status.txt'
 progress ("Writing %s..." % status_txt_file)