[ANN] "Mongoose" catches runaway Pythons (Initial release v0.1)

Follower follower at iname.com
Thu May 6 22:47:33 EDT 2004


New "Mongoose" package now available:

+ Provides a graceful exit and report when an uncaught Python
  exception occurs in deployed production or beta software.

+ Catches and reports otherwise unhandled Python exceptions in a helpful
  and extensible manner.

+ Automatically generates an unique Mongoose Incident Identifier(TM)
  to help you track the same bug across multiple computers. 

License: LGPL 

Read more about Mongoose below or download and try Mongoose today:

URL: <http://themongoose.sourceforge.net/>

Email: <opensource at notanothercorporation.com>


Basic usage example
-------------------

  import mongoose
  from mongoose.reporters import FileLogReporter

  mongoose.start()
  mongoose.registerReporter(FileLogReporter('mongoose.log'))
  mongoose.setSessionInfo('your_app_version', '1.0')
  # < ... your code here ... >
  mongoose.stop()


Mongoose Reporters
------------------
Mongoose replaces the default system exception handler so one or more
"reporters" can act in response to an uncaught exception.

Supplied sample reporters can:

* Log the event to a file
* Email the developer or support staff
* Display output on a console
* Display a wxWindows dialog to the user


Mongoose Incident Identifiers
-----------------------------
Mongoose Incident Identifier technology provides developers with a
convenient way to track the same exceptional incident (i.e. "bug")
across multiple computers. A Mongoose Incident Identifier is an
automatically generated unique identifier that will be the same on any
computer which encounters the problem. (Similar to Full Circle
Software's TalkBack ID and Bugtoaster's Crash Signature.)
    

Sample reporter output
----------------------
    
ConsoleReporter:

    This program has encountered a problem that means it can not continue.
    
    Please contact your technical support provider, system
    administrator or the vendor of this software and ask them for
    assistance.
    
    Mongoose Incident Identifier: 89662
    
    
FileLogReporter (Long format):

    ---------------------------------------------------------------------------
    Mon Mar  3 15:50:23 2003	89662	exceptions.Exception	Dummy Exception
    
    Traceback (most recent call last):
      File "mongoose/reporters.py", line 491, in ?
        raise Exception("Dummy Exception")
    Exception: Dummy Exception
    
    info one: Stuff
    info two: A value
    ---------------------------------------------------------------------------
    
EmailReporter:

    From: mongoose at example.com
    To: developer at example.com
    Subject: Mongoose Incident Report
    X-Mongoose-Id: 89662
    Date: Mon,  3 Mar 2003 15:50:23 -0800 (PST)
    
    (This is an optional message prologue.)
    ---------------------------------------------------------------------------
    Mon Mar  3 15:50:23 2003	89662	exceptions.Exception	Dummy Exception
    
    Traceback (most recent call last):
      File "mongoose/reporters.py", line 491, in ?
        raise Exception("Dummy Exception")
    Exception: Dummy Exception
    
    info one: Stuff
    info two: A value
    ---------------------------------------------------------------------------
    
    
More about "Mongoose Incident Identifiers"
------------------------------------------
        
The following is an example MII:

89662

Exciting, huh? 


Why is a Mongoose Incident Identifier good for users?
-----------------------------------------------------

+ A MII gives the user a single, small and easy to remember piece of
  information to identify their problem. They can then search the
  vendor's support database or talk to support personnel about it.


Why is a Mongoose Incident Identifier good for support staff?
-------------------------------------------------------------

+ The MII for any particular incident is the same for all 
  computers the software is installed on. A MII helps support staff
  determine whether a bug has been seen before, and find out if there
  are known solutions or work-arounds for it.


Why is a Mongoose Incident Identifier good for developers?
----------------------------------------------------------

+ Helps to determine how bugs should be prioritized by noting the
  relative frequency of each MII.

+ Provides a convenient method of conveying information from the user
  to the developer about particular bugs. Once a bug has an MII
  associated with it the developer can also link the logged traceback
  (including custom session information) and other information to it.
 
   
Download and try Mongoose today:

URL: <http://themongoose.sourceforge.net/>

Email: <opensource at notanothercorporation.com>

    
<P><A
HREF="http://themongoose.sourceforge.net/">
Mongoose 0.1</A> - Catch and report otherwise unhandled Python
exceptions in production or beta software in a helpful and extensible
manner, also provides bug specific Mongoose Incident Identifiers.
(07-May-04)




More information about the Python-list mailing list