Package horizons :: Package ext :: Module enum
[hide private]
[frames] | no frames]

Module enum

source code

Robust enumerated type support in Python.

This package provides a module for robust enumerations in Python.

An enumeration object is created with a sequence of string arguments to the Enum() constructor:

   >>> from enum import Enum
   >>> Colors = Enum('red', 'blue', 'green')
   >>> Weekdays = Enum('mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun')

The return value is an immutable sequence object with a value for each of the string arguments. Each value is also available as an attribute named from the corresponding string argument:

   >>> pizza_night = Weekdays[4]
   >>> shirt_color =

The values are constants that can be compared only with values from the same enumeration; comparison with other values will invoke Python's fallback comparisons:

   >>> pizza_night == Weekdays.fri
   >>> shirt_color >
   >>> shirt_color == "green"

Each value from an enumeration exports its sequence index as an integer, and can be coerced to a simple string matching the original arguments used to create the enumeration:

   >>> str(pizza_night)
   >>> shirt_color.index

Version: 0.4.4

Date: 2009-08-26

Author: Ben Finney <>

Copyright: Copyright \xc2\xa9 2007\xe2\x80\x932009 Ben Finney

License: Choice of GPL or Python license

Classes [hide private]
Base class for all exceptions in this module.
Raised when attempting to create an empty enumeration.
Raised when creating an Enum with non-string keys.
Raised when attempting to modify an Enum.
A specific value of an enumerated type.
Enumerated type.
Functions [hide private]
Decorator for EnumValue rich comparison methods.
source code
Variables [hide private]
  __author_name__ = 'Ben Finney'
  __author_email__ = ''
  _copyright_year_begin = '2007'
  _copyright_year_latest = '2009'
  _copyright_year_range = '2007\xe2\x80\x932009'
  __url__ = ''
  __package__ = None