NAME

Python::Err - Python exception objects

SYNOPSIS

   # catching
   eval {
     ....
   }
   if ($@ && UNIVERSAL::iso("Python::Err")) {
       # deal with the exception
   }

   # raising
   if (... arg is not as expected ...) {
      Python:Err->Raise(Python::Err::TypeError, "a foo object expected");
   }

DESCRIPTION

Python exceptions are wrapped up in Python::Err objects. If perl calls some python function and this function raise an exception then $@ will end up as a reference to a Python::Err object.

The following methods are available:

$err->type

What kind of exception this is. It should usually be a reference to one of exception type objects described below.

$err->value

An assosiated value, usually just a human readable string explaining the reason for the failure.

$err->traceback

The traceback object contain stack trace information from the location where the exceptions where raised and down.

$err->as_string

Overloaded stringify. Allow python exceptions to be matched using regular expressions on $@ and to be printed. Exceptions are stringified as:

   "$type: $value"

$err->as_bool

Overloaded for boolean tests and will always return TRUE, so it is not actually very useful :-)

If perl code is known to be invoked from python code, then it might want to raise native python exceptions.

Python::raise($type, $value)

The raise() function will raise a python exception of the given type and pass with it the given value.

Standard exception type objects

References to all the standard python exception type objects can be obtained using the following names.

Python::Err::Exception

The root class for all exceptions.

Python::Err::StandardError

The base class for all built-in exceptions.

Python::Err::ArithmeticError

The base class for all arithmentic exceptions.

Python::Err::LookupError

The base class for indexing and key exceptions.

Python::Err::AssertionError

Failed assert statement.

Python::Err::AttributeError

Failed attribute reference or asssignment

Python::Err::EOFError

End of file.

Python::Err::FloatingPointError

Python::Err::EnvironmentError

Base class for errors that occur outside Python.

Python::Err::IOError

Failed I/O operation.

Python::Err::OSError

Python::Err::ImportError

Python::Err::IndexError

Python::Err::KeyError

Python::Err::KeyboardInterrupt

Python::Err::MemoryError

Python::Err::NameError

Python::Err::OverflowError

Python::Err::RuntimeError

Python::Err::NotImplementedError

Python::Err::SyntaxError

Python::Err::SystemError

Python::Err::SystemExit

Python::Err::TypeError

Python::Err::UnboundLocalError

Python::Err::UnicodeError

Python::Err::ValueError

Python::Err::ZeroDivisionError

If these functions are called with a single argument then they test if the object passed in is of the given type. The argument can be either a Python exception object or a Python::Err object. The test test does not yet consider inheritance of exceptions.

COPYRIGHT

(C) 2000-2001 ActiveState

This code is distributed under the same terms as Perl; you can redistribute it and/or modify it under the terms of either the GNU General Public License or the Artistic License.

THIS SOFTWARE IS PROVIDED BY ACTIVESTATE `AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ACTIVESTATE OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

SEE ALSO

Python::Object, Python, perlmodule