i18n: move to babel

mmaker · mmaker · commit 947439c96295 · 2010-07-22T00:07:45.000+02:00
Configure setup.py to handle environments without babel installed,
Create a README for documenting how to write translations.
diff --git a/i18n/README b/i18n/README
@@ -0,0 +1,42 @@
+Dependencies
+============
+babel (http://babel.edgewall.org/)
+ (pip install babel)
+
+Internationalization
+====================
+bPython delegates to babel most of the job for creating .po and .mo files, so
+you may want to check also its documentation for more informations
+http://babel.edgewall.org/wiki/Documentation/0.9/index.html .
+
+In order to create a new language translation, first of all you need to know
+that translations follow this path template: i18n/locale/<locale>/LC_MESSAGES/bpython.po
+
+To create a new template .po file, you just need to follow 4steps:
+ 1. Set up the correct directory structure:
+
+     $ mkdir i18n/locale/fo_FO/    # assuming fo_FO is your desidered locale
+     $ mkdir i18n/locale/fo_FO/LC_MESSAGES
+
+ 2. Extract messages from the source using babel:
+
+    $ python setup.py extract_messages -o i18n/locale/fo_FO/LC_MESSAGES/bpython.po
+    running extract_messages
+    extracting messages from bpdb/__init__.py
+    extracting messages from bpdb/debugger.py
+    extracting messages from bpython/__init__.py
+    ...
+    writing PO template file to i18n/locale/fo_FO/LC_MESSAGES/bpython.po
+
+ 3. Edit bpython.po
+
+ 4. Compile the bpython.po file jsut created using babel:
+    $ python setup.py compile_catalog -f
+    running compile_catalog
+    compiling catalog 'i18n/locale/fo_FO/LC_MESSAGES/bpython.po' to 'i18n/locale/fo_FO/LC_MESSAGES/bpython.mo'
+
+bPython will take care to install generated locales to /usr/share/locale, so
+just type
+    $ python setup.py install
+to enjoy internationalization!
+
diff --git a/setup.py b/setup.py
@@ -49,6 +49,7 @@ def initialize_options(self):
 else:
     man_dir = 'share/man'
 
+
 data_files = [
         # man pages
         (os.path.join(man_dir, 'man1'), ['doc/bpython.1']),
@@ -62,6 +63,12 @@ def initialize_options(self):
         lang_path = os.path.join('', 'locale', lang, 'LC_MESSAGES', 'bpython.mo')
         data_files.append(('share'+lang_path, ['i18n'+lang_path]))
 
+cmdclass = dict(build_py=build_py,
+                build = build)
+# localization options: see i18n/README for more informations
+if using_translations:
+    cmdclass['compile_catalog'] = compile_catalog
+    cmdclass['extract_messages'] = extract_messages
 
 setup(
     name="bpython",
@@ -87,10 +94,7 @@ def initialize_options(self):
     },
     scripts = ([] if using_setuptools else ['data/bpython',
                                             'data/bpython-gtk']),
-    cmdclass = dict(build_py=build_py,
-                    build = build,
-                    compile_catalog = compile_catalog,
-                    extract_messages = extract_messages)
+    cmdclass = cmdclass
 )
 
 # vim: encoding=utf-8 sw=4 ts=4 sts=4 ai et sta
