Metadata-Version: 1.0
Name: snakefight
Version: 0.2
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::
        
        $ easy_install snakefight
        
        Creating WAR files
        ==================
        
        snakefight provides a new distutils command: ``bdist_war``.
        
        To create a `WAR file`, create a ``web.xml`` deployment descriptor
        (which would typically utilize the `modjy`_ library for the actual
        Servlet) and run::
        
        $ jython setup.py bdist_war --web_xml web.xml
        
        snakefight can automatically generate a ``web.xml`` (utilizing
        `modjy`_) for Paste style projects (those that support the
        `paste.app_factory` entry point), by specifying the ``--paste-config``
        option. To specify a named app in the config file, use the
        ``--paste-app-name`` option (which defaults to main)::
        
        $ jython setup.py bdist_war --paste-config production.ini --paste-app-name cascade
        
        
        snakefight can also be ran from CPython (at least version 2.5) as long
        as a ``JYTHON_HOME`` is specified::
        
        $ jython setup.py bdist_war --web_xml web.xml --jython-home=~/jython2.5b2
        
        Other options:
        
        * ``--war-prefix``      Prefix of the war file to build
        * ``--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 ``org.jruby.webapp.FileServlet``)
        * specifying modjy options
        * include-java-libs: list of jars to also include in WEB-INF/lib
        
        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.2
        ~~~
        
        * easy_install'ing the app is now the first step
        
        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
