flufl.enum 3.2

A Python enumeration package.

=========================================
flufl.enum - A Python enumeration package
=========================================

This package is called ``flufl.enum``. It is yet another Python enumeration
package, but with a slightly different take on syntax and semantics than
earlier such packages.

The goals of ``flufl.enum`` are to produce simple, specific, concise semantics
in an easy to read and write syntax. ``flufl.enum`` has just enough of the
features needed to make enumerations useful, but without a lot of extra
baggage to weigh them down. This work grew out of the Mailman 3.0 project and
it is the enum package used there. Until version 3.0, this package was called
``munepy``.


Requirements
============

``flufl.enum`` requires Python 2.6 or newer, and is compatible with Python 3
when used with ``2to3``.


Documentation
=============

A `simple guide`_ to using the library is available within this package, in
the form of doctests. The manual is also available online in the Cheeseshop
at:

http://package.python.org/flufl.enum


Project details
===============

The project home page is:

http://launchpad.net/flufl.enum

You should report bugs at:

http://bugs.launchpad.net/flufl.enum

You can download the latest version of the package either from the Cheeseshop:

http://pypi.python.org/pypi/flufl.enum

or from the Launchpad page above. Of course you can also just install it with
``pip`` or ``easy_install`` from the command line::

% sudo pip flufl.enum
% sudo easy_install flufl.enum

You can grab the latest development copy of the code using Bazaar, from the
Launchpad home page above. See http://bazaar-vcs.org for details on the
Bazaar distributed revision control system. If you have Bazaar installed, you
can grab your own branch of the code like this::

bzr branch lp:flufl.enum

You may contact the author via [e-mail].


Copyright
=========

Copyright (C) 2004-2011 Barry A. Warsaw

This file is part of flufl.enum.

flufl.enum is free software: you can redistribute it and/or modify it under
the terms of the GNU Lesser General Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your option) any
later version.

flufl.enum is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
details.

You should have received a copy of the GNU Lesser General Public License along
with flufl.enum. If not, see <http://www.gnu.org/licenses/>.


Table of Contents
=================

.. toctree::

docs/using.txt
NEWS.txt

.. _`simple guide`: docs/using.html

===================
NEWS for flufl.enum
===================

3.2 (2011-08-19)
==================
* make_enum() accepts an optional `iterable` argument to provide the values
for the enums.
* The .enumclass and .enumname attributes are deprecated. Use .enum and
.name instead, respectively.
* Improve the documentation regarding ordered comparisons and equality
tests. (LP: #794853)
* make_enum() now enforces the use of valid Python identifiers. (LP: #803570)


3.1 (2011-03-01)
================
* New convenience function `make_enum()`. (Contributed by Michael Foord)
* Fix `from flufl.enum import *`.
* Enums created with the class syntax can be pickled and unpickled.
(Suggestion and basic implementation idea by Phillip Eby).


3.0.1 (2010-06-07)
==================
* Fixed typo which caused the package to break.


3.0 (2010-04-24)
================
* Package renamed to flufl.enum.


2.0.2 (2010-01-29)
==================
* Fixed some test failures when running under 2to3.


2.0.1 (2010-01-08)
==================
* Fix the manifest and clarify license.


2.0 (2010-01-07)
================
* Use Sphinx to build the documentation.
* Updates to better package Debian/Ubuntu.
* Use distribute_setup instead of ez_setup.
* Rename pep-xxxx.txt; this won't be submitted as a PEP.
* Remove dependencies on nose and setuptools_bzr
* Support Python 3 via 2to3.


Earlier
=======

Try `bzr log` for details.