zmrl010 / bugsplat-py

BugSplat integration for Python

BugSplat

Crash and error reporting built for busy developers.

👋 Introduction

This repo contains the source code for bugsplat-py, a BugSplat integration for reporting Unhandled Exceptions in Python.

🏗 Installation

Install the bugsplat package using pip

pip install bugsplat

⚙️ Configuration

1. Import the BugSplat class

from bugsplat import BugSplat

2. Create a new BugSplat instance passing it the name of your BugSplat database, application and version

bugsplat = BugSplat(database, application, version)

3. Optionally, you set default values for appKey, description, email, user and additionaFilePaths

bugsplat.setDefaultAppKey('key!')
bugsplat.setDefaultDescription('description!')
bugsplat.setDefaultEmail('[e-mail]')
bugsplat.setDefaultUser('Fred')
bugsplat.setDefaultAdditionalFilePaths([
    './path/to/additional-file.txt',
    './path/to/additional-file-2.txt'
])

4. Wrap your application code in a try except block. In the except block call post. You can override any of the default properties that were set in step 3

try:
    crash()
except Exception as e:
    bugsplat.post(
        e, 
        additionalFilePaths=[], 
        appKey='other key!', 
        description='other description!', 
        email='[e-mail]', 
        user='Barney'
    )

5. Once you've posted a crash, navigate to the Crashes page and click the link in the ID column to be see the crash's details

🧑‍💻 Development

To get a development environment started:

1. Clone the repository

git clone https://github.com/BugSplat-Git/bugsplat-py.git

2. Create a virtual environment

pyhon -m venv venv

3. Activate virtual environment

# unix/macos
source venv/bin/activate

# windows
.\env\Scripts\activate

4. Install dependencies

pip install .

Thanks for using BugSplat ❤️