semvec/pypi-packages huggingface dataset:
bugzscout 0.0.1
Python interface for the FogBugz BugzScout API.
License: BSD
Keywords: BugzScout,FogBugz

bugzscout-py
============
Python interface for the FogBugz BugzScout API.

.. image:: https://travis-ci.org/thomasvandoren/bugzscout-py.png?branch=master
    :target: https://travis-ci.org/thomasvandoren/bugzscout-py

`Full Documentation <https://bugzscout.readthedocs.org/>`_ is available on
ReadTheDocs.

Installation
------------

.. code-block:: bash

    pip install bugzscout

Supported python versions
~~~~~~~~~~~~~~~~~~~~~~~~~

* 2.6, 2.7
* 3.1, 3.2, 3.3
* pypy

Getting Started
---------------

.. code-block:: pycon

    >>> import bugzscout
    >>> b = bugzscout.BugzScout('http://fogbugz/scoutSubmit.asp',
                                'fb-user',
                                'the-project',
                                'the-area')
    >>> b.submit_error('An error occurred of type blah', extra='Extra info')

Command Line Interface
~~~~~~~~~~~~~~~~~~~~~~

There is a command line interface for submitting errors. To simplify submitting
multiple errors, the FogBugz configuration can be set in the environment.

.. code-block:: bash

    # (Optional) Setup the environment.
    export BUGZSCOUT_URL=http://fogbugz/scoutSubmit.asp
    export BUGZSCOUT_USER=errors
    export BUGZSCOUT_PROJECT='My Project'
    export BUGZSCOUT_AREA=Errors

    # Submit a new error.
    bugzscout --extra 'Extra data for the case...' 'The description of the error.'

See the `BugzScout Command Line Interface
<https://bugzscout.readthedocs.org/en/latest/cli.html>`_ docs for more detail.

Celery
~~~~~~

The `Celery <http://celeryproject.org/>`_ extension can be used to
asynchronously publish errors. This is the recommended pattern for using
bugzscout in production environments.

.. code-block:: python

    # Import celery extension.
    import bugzscout.ext.celery_app

    # Submit errors asynchronously.
    bugzscout.ext.celery_app.submit_error.delay(
      'The description here...',
      extra='The extra information here...')

The `Celery worker
<http://docs.celeryproject.org/en/latest/userguide/workers.html>`_ can use the
same celery app for consuming messages.

.. code-block:: bash

    celery worker --app=bugzscout.ext.celery_app

A ``celeryconfig.py`` file on the PYTHONPATH can be used to configure the
celery instance. For example:

.. code-block:: bash

    export CELERY_CONFIG_MODULE=celeryconfig
    celery worker --app=bugzscout.ext.celery_app

See the `Celery example
<https://bugzscout.readthedocs.org/en/latest/example/celery_wsgi.html>`_ in the
docs for more detail.

License
-------
BSD

Authors
-------
Thomas Van Doren