Metadata-Version: 1.1
Name: django-status
Version: 1.0.1
Summary: Application that provides an API to check the status of some parts and some utilities like ping.
Home-page: https://github.com/PeRDy/django-status
Author: José Antonio Perdiguero López
Author-email: perdy.hh@gmail.com
License: GPLv3
Download-URL: https://github.com/PeRDy/django-status
Description: =============
        Django Status
        =============
        
        :Version: 1.0.1
        :Status: Production/Stable
        :Author: José Antonio Perdiguero López
        
        Django Status is a application for Django projects that provides an API to check the status of some parts and some
        utilities like ping requests.
        
        Quick start
        ===========
        
        #. Install this package using pip::
        
            pip install django-status
        
        
        #. Add *status* to your **INSTALLED_APPS** settings like this::
        
            INSTALLED_APPS = (
                ...
                'status',
            )
        
        #. Add **Django-status** urls to your project urls::
        
            urlpatterns = [
                ...
                url(r'^status/', include('status.urls')),
            ]
        
        Check Providers
        ===============
        Django Status provides a mechanism to add new custom check functions through **check providers**. Each check provider
        will generate a new API method with an URL that uses the name of the provider. These functions must accept *args and
        **kwargs and will return a JSON-serializable object through json.dumps() method, for example a ping function::
        
            def ping(*args, **kwargs):
                return {'pong': True}
        
        By default **Django status** provides the follow checks:
        
        Ping
            A ping to application.
            URL: /api/ping
        
        Databases
            Check if databases are running.
            URL: /api/databases
        
        Databases stats
            Show stats for all databases.
            URL: /api/databases/stats
        
        Caches
            Check if caches are running.
            URL: /api/caches
        
        Celery
            Check if celery workers defined in settings are running.
            URL: /api/celery
        
        Celery stats
            Show celery worker stats.
            URL: /api/celery/stats
        
        Settings
        ========
        STATUS_CHECK_PROVIDERS
        ----------------------
        List of additional check providers. Each provider consists in a tuple of name, function complete path, args and kwargs.
        Example::
        
            STATUS_CHECK_PROVIDERS = (
                ('test', 'application.module.test_function', [1, 2], {'foo': 'bar'}),
            )
        
        Default::
        
            STATUS_CHECK_PROVIDERS = ()
        
        STATUS_CELERY_WORKERS
        ---------------------
        List of hostname from celery workers to be checked.
        Default::
        
            STATUS_CELERY_WORKERS = ()
        
        
        Changes
        =======
        v1.0.1 - 14/10/2015
         * Update README and meta info.
        
        v1.0.0 - 14/10/2015
         * Database check.
         * Database stats.
         * Cache check.
         * Celery check.
         * Celery stats.
         * First stable version.
        
        v0.1.0 - 8/10/2015
         * Initial release.
        
Keywords: python,django,database,cache,celery,status,check
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
