Skip to content

Latest commit

 

History

History
81 lines (57 loc) · 2.8 KB

README.rst

File metadata and controls

81 lines (57 loc) · 2.8 KB
     ___           ___           ___           ___           ___           ___
    /\__\         /\  \         /\__\         /\  \         /\__\         /\  \
   /:/  /        /::\  \       /::|  |       /::\  \       /:/  /        /::\  \
  /:/__/        /:/\:\  \     /:|:|  |      /:/\:\  \     /:/__/        /:/\:\  \
 /::\  \ ___   /:/  \:\  \   /:/|:|  |__   /:/  \:\  \   /::\  \ ___   /:/  \:\  \
/:/\:\  /\__\ /:/__/ \:\__\ /:/ |:| /\__\ /:/__/ \:\__\ /:/\:\  /\__\ /:/__/ \:\__\
\/__\:\/:/  / \:\  \ /:/  / \/__|:|/:/  / \:\  \  \/__/ \/__\:\/:/  / \:\  \ /:/  /
     \::/  /   \:\  /:/  /      |:/:/  /   \:\  \            \::/  /   \:\  /:/  /
     /:/  /     \:\/:/  /       |::/  /     \:\  \           /:/  /     \:\/:/  /
    /:/  /       \::/  /        /:/  /       \:\__\         /:/  /       \::/  /
    \/__/         \/__/         \/__/         \/__/         \/__/         \/__/

Build Status

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