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.4.0.tar.gz (9.6 kB view details)

Uploaded Source

File details

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

File metadata

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

File hashes

Hashes for honcho-0.4.0.tar.gz
Algorithm Hash digest
SHA256 de4eead9e66981de4b1a7830743106f42f0d5806e058d8a063b63ff766048f2c
MD5 8a9ea3aeacc7351d19fe948beb6e9737
BLAKE2b-256 812510121806994834edc6791d414ea2eb516f01f8c343ca7f4273992829cb40

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