Metadata-Version: 2.1
Name: django-howl
Version: 1.0.5
Summary: Django app to observe almost everything you want and pushes notifications to signals.
Home-page: https://github.com/deluge/django-howl
Author: Benjamin Banduhn, Stephan Jaekel
Author-email: deluge@banduhn.com
Project-URL: Bug Reports, https://github.com/deluge/django-howl/issues
Project-URL: Source, https://github.com/deluge/django-howl
Keywords: django howl observer watchdog alert signal
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
License-File: LICENSE.rst
Requires-Dist: Django<2.3,>=1.11

django-howl
===========

.. image:: https://badge.fury.io/py/django-howl.svg
    :target: https://badge.fury.io/py/django-howl

.. image:: https://github.com/deluge/django-howl/workflows/Testing/badge.svg?branch=master
    :target: https://github.com/deluge/django-howl/actions?query=workflow%3ATesting

.. image:: https://codecov.io/gh/deluge/django-howl/branch/master/graph/badge.svg
  :target: https://codecov.io/gh/deluge/django-howl

.. image:: https://readthedocs.org/projects/django-howl/badge/?version=latest
  :target: http://django-howl.readthedocs.org/en/latest/?badge=latest
  :alt: Documentation Status


What is django-howl
-------------------

`django-howl` is a Django app where you can add custom observers and use them to check almost everything you want and pushes alerts to signals. You can connect to the signals and handle it in your way like sending notifications over different APIs.


Requirements
------------

django-howl supports Python 3 only and requires at least Django 1.11.
If you need support for Django 1.8.x or 1.9.x have a look at django-howl < 1.0.0


Installation
============

* Install ``django-howl`` (or `download from PyPI <http://pypi.python.org/pypi/django-howl>`_):

.. code-block:: python

    pip install django-howl

* After Installation add it to ``INSTALLED_APPS`` in ``settings.py``:

.. code-block:: python

    INSTALLED_APPS = [
        # other apps
        'howl',
    ]


Usage
=====

Now you can login to the admin and configure some observers and build some nice apps
with it.


Prepare for development
-----------------------

A Python 3.6 interpreter is required in addition to pipenv.

.. code-block:: shell

    $ pipenv install --python 3.6 --dev


Now you're ready to run the tests:

.. code-block:: shell

    $ pipenv run py.test


Resources
=========

* `Documentation <https://django-howl.readthedocs.org/>`_
* `Bug Tracker <https://github.com/deluge/django-howl/issues>`_
* `Code <https://github.com/deluge/django-howl/>`_
