Python::Err
Perl
module
-
Part of CPAN
distribution
pyperl 1.0.
Python::Err - Python exception objects
# 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");
}
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.
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.
(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.
Python::Object, Python, perlmodule
|
