Spout

Spout is a method of enterprise and beta distribution of iOS and Android apps. It is written in Python and uses the Django web framework.

Installation

First, instantiate a virtualenv (http://pypi.python.org/pypi/virtualenv) on the Spout directory. All dependencies are included in this repo under the requirements.txt file. Run pip install -r requirements.txt to get the dependencies needed. You then can configure the app just like you would any other Django app.

##Using Spout

###Adding apps After you have successfully configured and launched Spout, you can start hosting apps for distribution. First, you need to create a product entry in the admin panel. Go to http://[spout url]/admin to get to the admin panel. Click the plus button on the main admin page next to Products. Just add the name of the product that you're going to upload apps for and save.

###Products

Products are the broadest category for your app. Think of a product as a single listing in the app store. Products don't include the beta versions of your app, different versions of your app with different configurations, or the like. You should categorize your apps that fall under those criteria with tags.

###Tags

Tags are the "sub-versions" of products that you want to make available to users. Examples of tags could be branch names, versions specifically created with a certain server configuration, version A/B, etc. Tags are particularly convenient because when uploading your app using the upload API, tags not found are automatically created. This is useful when, for example, your build system builds each development branch and pushes to Spout using the upload API, tagging each build with the built branch name.

###Pages

Pages are the views that you create to display apps to your users. You can specify a product to make available for download, as well as apps tagged a certain way.

On the "add page" view of the admin console, there are several options to control access to a page you want to create.

• Title
• Sub heading
• HTML To be displayed at the top of your page
• Public (open to unauthenticated users)
• Page expiration date
• How the page should be grouped
• The rows that make up the page

Local Development

If you are going to use Sqlite3 for your local development database, be sure to run pip install pysqlite.
Otherwise you may get a rather cryptic error stating that Django cannot load one of its components (because loading the database engine didn't work), though no helpful error message is shown.