Metadata-Version: 1.0
Name: van.potomo
Version: 1.0.0
Summary: PO to MO build time compiler
Home-page: http://pypi.python.org/pypi/van.potomo
Author: Vanguardistas LLC
Author-email: zope-dev@zope.org
License: ZPL 2.1
Description: .. contents::
        
        Purpose
        =======
        
        This package integrates pure-python gettext translation compilation (msgfmt)
        into the setup.py "build" and "develop" commands.
        
        These commands are extended so that every "data file" identified by setuptools
        with the .po extension is compiled to a .mo file in the same directory as the
        .po file.
        
        This integrates very well if you use z3c.recipe.i18n (and hopefully others as
        well) to manage .po files.
        
        Usage
        =====
        
        You need to override the "build" and "develop" commands in your setup.py, for example::
        
        from setuptools import setup, find_packages
        from van.potomo import develop, build
        
        setup(
        name = "HelloWorld",
        cmdclass={'build': build,
        'develop': develop},
        setup_requires=["van.potomo"],
        version = "0.1",
        packages = find_packages(),
        )
        
        Why
        ===
        
        This package exists because the author believes that:
        
        * Compiled translations should not be stored under revision control, they are not source
        * Compiled translations should not be distributed in tarballs, they are not source
        * Compiled translations should not be "lazily compiled" unless you take into account that
        filesystems on production machines are often read-only.
        * The process of compiling translations should not require an extra step/options during
        the build/install or build/develop cycle.
        
        The options available at the time offered all of this:
        
        * Babel: Not integrated into the "build" distutils command.
        * cc.gettext: Depends on buildout, not useful for deployments by other means.
        * zope.i18n lazy compilation: Very nice for development, but not on some
        production environments.
        
        
        Caveats
        =======
        
        van.potomo makes your setup.py depend on van.potomo. But outside tools cannot
        tell this because they need to run the setup.py to figure out the dependencies.
        
        Basically this means your developers/users will need to install van.potomo
        manually before anything else. If anyone knows a robust/good way to get around
        this limitation, please let the author know.
        
        
        Changes
        =======
        
        1.0.0 (2009-03-10)
        ------------------
        
        - Initial Release
        
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Zope Public License
Classifier: Framework :: Setuptools Plugin
Classifier: Programming Language :: Python
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Build Tools
