Metadata-Version: 2.0
Name: qcrash
Version: 0.2.0
Summary: A crash report framework for PyQt/PySide applications
Home-page: https://github.com/ColinDuquesnoy/qcrash
Author: Colin Duquesnoy
Author-email: colin.duquesnoy@gmail.com
License: MIT
Keywords: Github,PyQt4,PyQt5,PySide,Issue,Report,Crash,Tool
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: X11 Applications :: Qt
Classifier: Environment :: Win32 (MS Windows)
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: Software Development :: Bug Tracking
Classifier: Topic :: Software Development :: User Interfaces
Classifier: Topic :: Software Development :: Widget Sets
Requires-Dist: keyring

About
-----

.. image:: https://img.shields.io/pypi/v/qcrash.svg
   :target: https://pypi.python.org/pypi/qcrash/
   :alt: Latest PyPI version

.. image:: https://img.shields.io/pypi/dm/qcrash.svg
   :target: https://pypi.python.org/pypi/qcrash/
   :alt: Number of PyPI downloads

.. image:: https://img.shields.io/pypi/l/qcrash.svg

.. image:: https://coveralls.io/repos/github/ColinDuquesnoy/QCrash/badge.svg?branch=master
  :target: https://coveralls.io/github/ColinDuquesnoy/QCrash?branch=master
  :alt: API Coverage


.. image:: https://travis-ci.org/ColinDuquesnoy/QCrash.svg?branch=master
   :target: https://travis-ci.org/ColinDuquesnoy/QCrash
   :alt: Travis-CI Build Status


A PyQt/PySide framework for reporting application crash (unhandled exception)
and/or let the user report an issue/feature request.


Features
--------

- multiple builtin backends for reporting bugs:

  - github_backend: let you create issues on github
  - email_backend: let you send an email with the crash report.

- highly configurable, you can create your own backend, set your own formatter,...
- a thread safe exception hook mechanism with a way to setup your own function

Screenshots
-----------

*Screenshots taken on KDE Plasma 5*

- Report dialog

.. image:: https://raw.githubusercontent.com/ColinDuquesnoy/QCrash/master/docs/_static/qcrash_report.png

- Review report before submitting

.. image:: https://raw.githubusercontent.com/ColinDuquesnoy/QCrash/master/docs/_static/qcrash_review.png

- Github integration

.. image:: https://github.com/ColinDuquesnoy/QCrash/blob/master/docs/_static/qcrash_github_login.png


LICENSE
-------

QCrash is licensed under the MIT license.

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

``pip install qcrash``

Usage
-----

Basic usage:

.. code-block:: python

    import qcrash.api as qcrash

    # setup our own function to collect system info and application log
    qcrash.get_application_log = my_app.get_application_log
    qcrash.get_system_information = my_app.get_system_info

    # configure backends
    github = qcrash.backends.GithubBackend('ColinDuquesnoy', 'QCrash')
    email = qcrash.backends.EmailBackend('colin.duquesnoy@gmail.com')
    qcrash.install_backend([github, email])

    # install exception hook
    qcrash.install_except_hook()

    # or show the report dialog manually
    qcrash.show_report_dialog()

Some more detailed `examples`_  are available. Also have a look at the
`API documentation`_.

Dependencies
------------

- `keyring`_
- `githubpy`_ (embedded into the package)


.. _keyring: https://pypi.python.org/pypi/keyring
.. _githubpy: https://github.com/michaelliao/githubpy
.. _examples: https://github.com/ColinDuquesnoy/QCrash/tree/master/examples
.. _API documentation: http://qcrash.readthedocs.org/en/latest/index.html


Testing
-------

To run the tests, just run the following command::

    python setup.py test


