Skip to main content

Honcho: a python clone of Foreman. For managing Procfile-based applications.

Project description

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

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

Project details


Download files

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

Source Distribution

honcho-0.3.1.tar.gz (9.3 kB view details)

Uploaded Source

File details

Details for the file honcho-0.3.1.tar.gz.

File metadata

  • Download URL: honcho-0.3.1.tar.gz
  • Upload date:
  • Size: 9.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for honcho-0.3.1.tar.gz
Algorithm Hash digest
SHA256 01dfa9129fb66c72274de4a46b2fc9d0aafb8501a79182aec5554aa94d61066c
MD5 16c55160a4ce8c1e194392caf1b053fa
BLAKE2b-256 7884d9419ff1800d9ac0ec98afa0a5b28b22c8ce8ec4054527b56c52d1cb7c60

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page