pyratchet is a generic library for reporting exceptions and other messages to Ratchet.io:
import ratchet, sys ratchet.init('YOUR_ACCESS_TOKEN', 'production') # access_token, environment try: main_app_loop() except IOError: ratchet.report_message('Got an IOError in the main loop', 'warning') except: # catch-all ratchet.report_exc_info(sys.exc_info())
pyratchet requires:
- Python 2.6 or 2.7
- requests 0.12+
- a Ratchet.io account
Install using pip:
pip install ratchet
Somewhere in your initialization code, call ratchet.init() with your access_token:
ratchet.init('YOUR_ACCESS_TOKEN_HERE', environment='production')
Other options can be passed as keyword arguments. See the reference below for all options.
Call pyratchet.report_exc_info()
to report an exception, or pyratchet.report_message()
to report an arbitrary string message. See the docstrings for more info.
- access_token
- Access token from your Ratchet.io project
- handler
One of:
- blocking -- runs in main thread
- thread -- spawns a new thread
default:
thread
- environment
- Environment name. Any string up to 255 chars is OK. For best results, use "production" for your production environment.
- root
- Absolute path to the root of your application, not including the final
/
. - branch
Name of the checked-out branch.
default:
master
- endpoint
URL items are posted to.
default:
https://submit.ratchet.io/api/1/item/
Contributions are welcome. The project is hosted on github at http://github.com/ratchetio/pyratchet
If you have any questions, feedback, etc., drop us a line at [email protected]