Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

A combo-loader for Javascript and CSS.

Project Description

Overview

Convoy is a WSGI app for loading multiple CSS and JavaScript files in one request. It’s built to be compatible with the YUI Loader.

Installation

Convoy is a Python package that is installed from pypi via easy_install or pip.

$ pip install convoy

Usage

Convoy is a WSGI application. You should create a .wsgi file that you serve out that sets up convoy for your use. You need to supply it the root path to the JS and CSS files that it’s serving out to your users.

An example .wsgi file is noted below.

from convoy.combo import combo_app

def application(environ, start_response):
    root = '/path/to/file/root'
    app = combo_app(root)
    return app(environ, start_response)

You can run this via WSGI servers such as gunicorn, Apapche mod_wsgi, etc.

Breaking down the combo loader url

There are two basic parts to finding files from your combo loader.

Root adjustments - PATH_INFO

The initial part of the route, passed into Convoy in the WSGI environment PATH_INFO variable, becomes part of the path from your root.

If you have multiple versions of files in the root, you can select which by adding the extra path info to your convoy url.

For instance, if your url is: http://127.0.0.1:8000/ver1?y/yui-min&y/loader-min It will append the ‘ver1’ to the root specified in your .wsgi file to find where the y directory should be on disk.

Combined Files

The query string is used only to find files based off the updated root path. You might want to keep the YUI files in a directory y and your own files under a directory app. In this way, the files to combine would be in the query string as: http://127.0.0.1:8000?y/yui-min&app/app-main.

Release History

Release History

This version
History Node

0.4.4

History Node

0.4.3

History Node

0.4.2

History Node

0.4.1

History Node

0.4.0

History Node

0.3.0

History Node

0.2.4

History Node

0.2.3

History Node

0.2.2

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
convoy-0.4.4.tar.gz (8.7 kB) Copy SHA256 Checksum SHA256 Source Nov 16, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting