User Defined Exceptions

pcapkit.exceptions refined built-in exceptions. Make it possible to show only user error stack infomation *, when exception raised on user’s operation.

exception pcapkit.utilities.exceptions.BaseError(*args, quiet=False, **kwargs)

Bases: Exception

Base error class of all kinds.

Important

• Turn off system-default traceback function by set sys.tracebacklimit to 0.

• But bugs appear in Python 3.6, so we have to set sys.tracebacklimit to None.

  Note

  This note is deprecated since Python fixed the problem above.

• In Python 2.7, trace.print_stack(limit)() dose not support negative limit.

See also

pcapkit.utilities.exceptions.stacklevel()

__init__(*args, quiet=False, **kwargs)

Initialize self. See help(type(self)) for accurate signature.

exception pcapkit.utilities.exceptions.BoolError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, TypeError

The argument(s) must be bool type.

exception pcapkit.utilities.exceptions.BytearrayError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, TypeError

The argument(s) must be bytearray type.

exception pcapkit.utilities.exceptions.BytesError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, TypeError

The argument(s) must be bytes type.

exception pcapkit.utilities.exceptions.CallableError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, TypeError

The argument(s) must be callable.

exception pcapkit.utilities.exceptions.ComparisonError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, TypeError

Rich comparison not supported between instances.

exception pcapkit.utilities.exceptions.ComplexError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, TypeError

The function is not defined for complex instance.

exception pcapkit.utilities.exceptions.DictError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, TypeError

The argument(s) must be dict type.

exception pcapkit.utilities.exceptions.DigitError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, TypeError

The argument(s) must be (a) number(s).

exception pcapkit.utilities.exceptions.EndianError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, ValueError

Invalid endian (byte order).

exception pcapkit.utilities.exceptions.EnumError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, TypeError

The argument(s) must be enumeration protocol type.

exception pcapkit.utilities.exceptions.FileError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, OSError

[Errno 5] Wrong file format.

exception pcapkit.utilities.exceptions.FileExists(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, FileExistsError

[Errno 17] File already exists.

exception pcapkit.utilities.exceptions.FileNotFound(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, FileNotFoundError

[Errno 2] File not found.

exception pcapkit.utilities.exceptions.FormatError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, AttributeError

Unknown format(s).

exception pcapkit.utilities.exceptions.FragmentError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, KeyError

Invalid fragment dict.

exception pcapkit.utilities.exceptions.IOObjError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, TypeError

The argument(s) must be file-like object.

exception pcapkit.utilities.exceptions.IPError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, TypeError

The argument(s) must be IP address.

exception pcapkit.utilities.exceptions.IndexNotFound(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, ValueError

Protocol not in ProtoChain.

exception pcapkit.utilities.exceptions.InfoError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, TypeError

The argument(s) must be Info instance.

exception pcapkit.utilities.exceptions.IntError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, TypeError

The argument(s) must be integral.

exception pcapkit.utilities.exceptions.IterableError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, TypeError

The argument(s) must be iterable.

exception pcapkit.utilities.exceptions.ListError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, TypeError

The argument(s) must be list type.

exception pcapkit.utilities.exceptions.ModuleNotFound(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, ModuleNotFoundError

Module not found.

exception pcapkit.utilities.exceptions.PacketError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, KeyError

Invalid packet dict.

exception pcapkit.utilities.exceptions.ProtocolError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, ValueError

Invalid protocol format.

exception pcapkit.utilities.exceptions.ProtocolNotFound(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, IndexError

Protocol not found in ProtoChain.

exception pcapkit.utilities.exceptions.ProtocolNotImplemented(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, NotImplementedError

Protocol not implemented.

exception pcapkit.utilities.exceptions.ProtocolUnbound(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, TypeError

Protocol slice unbound.

exception pcapkit.utilities.exceptions.RealError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, TypeError

The function is not defined for real number.

exception pcapkit.utilities.exceptions.StringError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, TypeError

The argument(s) must be str type.

exception pcapkit.utilities.exceptions.StructError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, struct.error

Unpack failed.

exception pcapkit.utilities.exceptions.TupleError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, TypeError

The argument(s) must be tuple type.

exception pcapkit.utilities.exceptions.UnsupportedCall(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, AttributeError

Unsupported function or property call.

exception pcapkit.utilities.exceptions.VendorNotImplemented(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, NotImplementedError

Vendor not implemented.

exception pcapkit.utilities.exceptions.VersionError(*args, quiet=False, **kwargs)

Bases: pcapkit.utilities.exceptions.BaseError, ValueError

Unknown IP version.

pcapkit.utilities.exceptions.stacklevel()

Fetch current stack level.

The function will walk through the straceback stack (traceback.extract_stack()), and fetch the stack level where the path contains /pcapkit/. So that it won’t display any disturbing internal traceback information when raising errors.

Returns

Stack level until internal stacks, i.e. contains /pcapkit/.

Return type

int

pcapkit.utilities.exceptions.DEVMODE = False

Development mode (DEVMODE) flag.

---

*

See tbtrim project for a modern Pythonic implementation.