Metadata-Version: 2.1
Name: honcho
Version: 2.0.0
Summary: Honcho: a Python clone of Foreman. For managing Procfile-based applications.
Author-email: Nick Stenning <nick@whiteink.com>
Project-URL: Source, https://github.com/nickstenning/honcho
Keywords: sysadmin,process,procfile
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: AUTHORS.rst
Requires-Dist: backports.entry-points-selectable ; python_version < "3.10"
Requires-Dist: colorama ; sys_platform == "win32"
Provides-Extra: docs
Requires-Dist: sphinx ; extra == 'docs'
Provides-Extra: export
Requires-Dist: jinja2 <4,>=3.1.2 ; extra == 'export'

::

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

|PyPI| |Build Status|

Honcho is a Python port of Foreman_, a tool for managing Procfile-based applications.

`Why a port? <//honcho.readthedocs.io/en/latest/#why-did-you-port-foreman>`_

.. _Foreman: https://ddollar.github.io/foreman

.. |Build Status| image:: https://github.com/nickstenning/honcho/actions/workflows/main.yml/badge.svg
   :target: https://github.com/nickstenning/honcho/actions
   :alt: Build Status

.. |PyPI| image:: https://img.shields.io/pypi/v/honcho.svg
   :target: https://pypi.python.org/pypi/honcho/
   :alt: Latest Version on PyPI

Installing Honcho
-----------------

::

    pip install honcho

How to use Honcho
-----------------

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

.. _a Procfile: https://devcenter.heroku.com/articles/procfile
.. _to configure your app: https://www.12factor.net/config

For more detail and an explanation of the circumstances in which Honcho might
be useful, consult the `Honcho documentation`_.

.. _Honcho documentation: https://honcho.readthedocs.io/

License
-------

Honcho is released under the terms of the MIT license, a copy of which can be
found in ``LICENSE``.
