Metadata-Version: 1.0
Name: snakefight
Version: 0.1
Summary: Assembles WAR files from Python (Jython) WSGI applications
Home-page: http://pypi.python.org/pypi/snakefight
Author: Philip Jenvey
Author-email: pjenvey@underboss.org
License: BSD
Description: .. _usage:
        
        snakefight
        ==========
        
        snakefight generates `WAR files`_ from Python (Jython) WSGI
        applications, suitable for deployment to Java `Servlet containers`_.
        
        Installation
        ============
        
        snakefight requires at least `Jython`_ 2.5b2. To install:
        
        .. code-block :: sh
        
        $ easy_install snakefight
        
        Creating WAR files
        ==================
        
        snakefight provides a new distutils command: :command:`bdist_war`.
        
        To create a `WAR file`, create a :file:`web.xml` deployment descriptor
        (which would typically utilize the `modjy`_ library for the actual
        Servlet) and run:
        
        .. code-block :: sh
        
        $ jython setup.py bdist_war --web_xml web.xml
        
        snakefight can automatically generate a :file:`web.xml` (utilizing
        `modjy`_) for Paste style projects (those that support the
        `paste.app_factory` entry point), by specifying the
        :option:`--paste-config` option. To specify a named app in the config
        file, use the :option:`--paste-app-name` option (which defaults to
        main):
        
        .. code-block :: sh
        
        $ jython setup.py bdist_war --paste-config production.ini --paste-app-name cascade
        
        
        snakefight can also be ran from CPython as long as a
        :envvar:`JYTHON_HOME` is specified:
        
        .. code-block :: sh
        
        $ jython setup.py bdist_war --web_xml web.xml --jython-home=~/jython2.5b2
        
        Other options:
        
        * :option:`--war-prefix`      Prefix of the war file to build
        * :option:`--no-jython`       Don't include the Jython distribution
        
        
        TODO
        ====
        Add options for:
        
        * exclude-requires: exclude certain eggs from inclusion
        * static_files: list of directories to serve public files (through the
        faster :class:`org.jruby.webapp.FileServlet`)
        * specifying modjy options
        
        Support:
        
        * non setuptools apps? (like Django apps) `django-jython`_ already
        handles Django but ideally we'd share code
        
        .. _`django-jython`: http://code.google.com/p/django-jython/
        
        Changelog
        =========
        
        0.1
        ~~~
        
        * Initial release
        
        .. _`Jython`: http://www.jython.org
        .. _`WAR files`: http://en.wikipedia.org/wiki/Sun_WAR_(file_format)
        .. _`Servlet containers`: http://en.wikipedia.org/wiki/Servlet_container
        .. _`modjy`: http://modjy.xhaus.com/
        .. _`paste.app_factory`: http://pythonpaste.org/deploy/#paste-app-factory
        
Keywords: jython war
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI
