___           ___           ___           ___           ___           ___     
    /\__\         /\  \         /\__\         /\  \         /\__\         /\  \    
   /:/  /        /::\  \       /::|  |       /::\  \       /:/  /        /::\  \   
  /:/__/        /:/\:\  \     /:|:|  |      /:/\:\  \     /:/__/        /:/\:\  \  
 /::\  \ ___   /:/  \:\  \   /:/|:|  |__   /:/  \:\  \   /::\  \ ___   /:/  \:\  \ 
/:/\:\  /\__\ /:/__/ \:\__\ /:/ |:| /\__\ /:/__/ \:\__\ /:/\:\  /\__\ /:/__/ \:\__\
\/__\:\/:/  / \:\  \ /:/  / \/__|:|/:/  / \:\  \  \/__/ \/__\:\/:/  / \:\  \ /:/  /
     \::/  /   \:\  /:/  /      |:/:/  /   \:\  \            \::/  /   \:\  /:/  / 
     /:/  /     \:\/:/  /       |::/  /     \:\  \           /:/  /     \:\/:/  /  
    /:/  /       \::/  /        /:/  /       \:\__\         /:/  /       \::/  /   
    \/__/         \/__/         \/__/         \/__/         \/__/         \/__/   

---

So, uh, honcho is basically Foreman, but uh, honcho instead.

Seriously? honcho is a Python port of Foreman.

Why a port? Well, only two good reasons, and only one of which you're going to be interested in:

1. I work in Python-only development environments, where installing Ruby just so I can run Procfile apps seems a bit crazy. Python, on the other hand, is part of the LSB, and so even in "Ruby-only" environments, Python will still be around.

2. I wanted to learn about asynchronous I/O in Python.

How to get honcho

pip install honcho

If you're one of those sick people who's into this kind of thing, you can probably also easy_install honcho. But please, don't: get with the program.

How to use honcho

1. Read the Foreman documentation
2. Run honcho -h and see which bits of Foreman I've got round to implementing

Or, the 30-second version:

1. Write a Procfile:

   $ cat >Procfile <<EOM web: python serve.py redis: redis-server EOM

2. Optional: write a .env file to configure your app:

   $ cat >.env <<EOM PORT=6000 REDIS_URI=redis://localhost:6789/0 EOM

3. Run the app with honcho:

   $ honcho start