Add files via upload

3.1.8

=====

recalculate bits used after all flags created (sometimes needed when a custom

`__new__` is in place.

3.1.7

=====

update flag creation to (possibly) add bitwise operator methods to newly

created flags

update extend_enum() to work with 3.11 flags

3.1.6

=====

Update `dir()` on mixed enums to include mixed data type methods and

attributes.

Rename `enum_property` to `property` to match stdlib.  Recommended usage is

`aenum.property` (prefix with module name).

Remove quadritic creation behavior.

BREAKING CHANGE BUG FIX that won't affect most people

Enums with a custom `__new__` that:

- use the enum machinery to generate the values; AND

- have keyword arguments set to a default (like `None`)

will fail to generate a missing value.  To fix: remove the default value and

instead specify it on the member creation line.

BREAKING CHANGE

In Python 3.11 the `str()` of mixed enums will now match its `format()` which

will be the normal `str()` of the data type -- so for an IntEnum you'll see

`5` instead of `Perm.R|X`.  This affects IntEnum, StrEnum, and IntFlag.

3.1.5

=====

fix support of `auto()` kwds

3.1.3

=====

rename `aenum.property` to `aenum.enum_property`

fix `enum_property` to work with `_init_` attributes

3.1.2

=====

fix `extend_enum()` for unhashable values

3.1.1

=====

fix `extend_enum()` for most cases

3.1.0

=====

AddValue is similar to the old AutoNumber: it will always activate, but

uses _generate_next_value_ to get the next value (so the user has some

control over the return data type instead of always getting an int).

BREAKING CHANGES

AutoValue is gone.  It was superflous and its removal simplified the code.

Simply put the fields needed in an `_init_` and `_generate_next_value_`

will be called to supply the missing values (this is probably already what

is happening).

3.0.0

=====

standard Enum usage is unchanged

BREAKING CHANGES

Enum

- the more esoteric method of creating Enums have been modified or removed

  - AutoNumber setting is gone, inherit from AutoNumberEnum instead

  - creating members without specifying anything is removed (if you don't

    know what this means, you weren't doing it)

Flag

- unique flags are canonical (i.e. flags with powers of two values such as

  1, 2, 4, 8, 16, etc.)

- non-unique flags are aliases (i.e. values such as 3 or 7)

- iteration of Flag and flag members only uses canonical flags

ENHANCEMENTS

Member creation has been redone to match Python 3.10's methods.  This also

allows all supported Pythons (2.7, 3.3+) to use the __set_name__ and

__init_subclass__ protocols (more robustly than in aenum 2.2.5)

CHANGES

enum_property() has been renamed to property() (old name still available, but

deprecated).

bin() replacement shows negative integers in twos-complement

2.2.5

=====

call __init_subclass__ after members have been added, and in Pythons < 3.6

call __set_name__ in Pythons < 3.6

do not convert/disallow private names

add iteration/len support to NamedConstant

2.2.4

=====

add support to Constant to retrieve members by value

    --> class K(Constant):

    ...     one = 1

    ...     two = 2

    --> K.one

    <K.one: 1>

    --> K(1)

    <K.one: 1>

add pickle/deepcopy support to Constant

add support for Constant to use other Constant values

  (resulting members /are not/ the same)

    --> class C(Constant)

    ...     one = K.one

    ...     three = 3

    --> C.one == K.one

    True

    --> C.one is K.one

    False

AutoNumber and auto() now work together

Enum members are now added to the class as enum_property, which supports

unshadowing of parent class attributes when called on an Enum member:

    --> class StrEnum(str, Enum):

    ...     lower = 'lower'

    ...     upper = 'upper'

    ...     mixed = 'mixed'

    --> StrEnum.lower

    <StrEnum.lower: 'lower'>

    --> StrEnum.lower.upper()

    'LOWER'

    --> StrEnum.upper

    <StrEnum.upper: 'upper'>

    --> StrEnum.upper.upper()

    'UPPER'

2.2.3

=====

use members' type's methods __str__, __repr__, __format__, and

__reduce_ex__ if directly assigned in Enum class body; i.e.:

    --> class Color(str, Enum):

    ...     red = 'red'

    ...     green = 'green'

    ...     blue = 'blue'

    ...     __str__ = str.__str__

    --> print(repr(Color.green))

    <Color.green: 'green'>

    --> print(Color.green)

    green

2.2.2

=====

replace _RouteClassAttributeToGetattr with enum_property (it is still

available as an alias)

support constant() and auto() being used together:

    --> class Fruit(Flag):

    ...    _order_ = 'apple banana lemon orange'

    ...    apple = auto()

    ...    banana = auto()

    ...    lemon = auto()

    ...    orange = auto()

    ...    CitrusTypes = constant(lemon | orange)

    --> list(Fruit)

    [Fruit.apple, Fruit.banana, Fruit.lemon, Fruit.orange]

    --> list(Fruit.CitrusTypes)

    [Fruit.orange, Fruit.lemon]

    --> Fruit.orange in Fruit.CitrusTypes

    True

2.2.1

=====

allow Enums to be called without a value

    class Color(Enum):

        black = 0

        red = 1

        green = 2

        blue = 3

        #

        @classmethod

        def _missing_value_(cls, value):

            if value is no_arg:

                return cls.black

    >>> Color()

    <Color.black: 0>

allow Enum name use while constructing Enum (Python 3.4+ only)

    --> class Color(Enum):

    ...     _order_ = 'BLACK WHITE'

    ...     BLACK = Color('black', '#000')

    ...     WHITE = Color('white', '#fff')

    ...     #

    ...     def __init__(self, label, hex):

    ...         self.label = label

    ...         self.hex = hex

2.2.0

=====

BREAKING CHANGE

---------------

In Python 3+ classes defined inside an Enum no longer become members by

default; in Python 2 they still become members, but see below.

For cross-compatibility and full control two decorators are provided:

- @member  --> forces item to become a member

- @nonmember  --> excludes item from becoming a member

So to have an Enum that behaves the same in Python 2 and 3, use the

decorators (and other compatibility shims):

    class Color(Enum):

        _order_ = 'red green blue'

        red = 1

        green = 2

        blue = 3

        @nonmember

        class Shades(Enum):

            _order_ = 'light medium dark'

            light = 1

            medium = 2

            dark = 3

2.1.4

=====

EnumMeta:

- change __member_new__ to __new_member__ (as the stdlib enum does)

- assign member name to enum() instances (an Enum helper for defining members)

- handle empty iterables when using functional API

- make auto() work with previous enum members

- keep searching mixins until base class is found

Enum:

- fix bug in Flag checks (ensure it is a Flag before checking the name)

- add multiple mixin support

- do not allow blank names (functional API)

- raise TypeError if _missing_* returns wrong type

- fix __format__ to honor custom __str__

extend_enum:

- support stdlib Enums

- use _generate_next_value_ if value not provided

general:

- standardize exception formatting

- use getfullargspec() in Python 3 (avoids deprecation warnings)

2.1.2

=====

when order is callable, save it for subclass use

2.1.1

=====

correctly raise TypeError for non-Enum containment checks

support combining names with | for Flag key access

support _order_ being a callable

2.1.0

=====

support Flags being combined with other data types:

- add _create_pseudo_member_values_ 

- add default __new__ and temporary _init_ 

2.0.10

======

ensure _ignore_ is set when _settings_ specified in body which includes

AutoValue

make Flag members iterable

2.0.9

=====

fix missing comma in __all__

fix extend_enum with custom __new__ methods

fix MultiValue with AutoNumber without _init_

2.0.8

=====

extend_enum now handles aliases and multivalues correctly

2.0.7

=====

support mixin types with extend_enum

init and AutoNumber can now work together

add test for new Enum using EnumMeta

add tests for variations of multivalue and init

prevent deletion of NamedConstant.constant

2.0.6

=====

constants cannot be deleted (they already couldn't be changed)

constants can be used to define other constants

2.0.5

=====

_init_ and MultiValue can now work together

2.0.4

=====

_init_ and AutoValue (and _generate_next_value_) can now work together to

supply missing values even when some of the required values per member are

absent

2.0.3

=====

add _missing_value_ and _missing_name_ methods, deprecate _missing_

make enum instances comparable

2.0.2

=====

both EnumMeta.__getattr__ and Enum.__new__ fall back to _missing_

2.0.1

=====

auto() now works with other data types

AutoNumber supports legacy Enums (fixed regression)

2.0.0

=====

Flag and IntFlag added.

1.4.7

=====

fix %-interpolation bug

defined SqlLiteEnum only if sqlite exists

support pyflakes

1.4.6

=====

version numbering error

1.4.5

=====

revert AutoNumberEnum to custom __new__ instead of AutoNumber

use _ignore_ to shield against AutoNumber magic

inherit start and init settings from base Enums

1.4.4

=====

enabled export as a decorator

enabled _order_ to replace __order__

enabled python2 support for settings, init, and start

1.4.3

=====

support _ignore_ for dynamically creating class bodies

1.4.2

=====

MultiValue, NoAlias, Unique, and init now work with Python 2

1.4.1

=====

Py3: added Enum creation flags: Auto, MultiValue, NoAlias, Unique

fixed extend_enum to honor Enum flags

1.4.0

=====

When possible aenum inherits from Python's own enum.

Breaking change: enum members now default to evaluating as True to maintain

compatibility with the stdlib.

Add your own __bool__ (__nonzero__ in Python 2) if need this behavior:

    def __bool__(self):

        return bool(self.value)

    __nonzero__ = __bool__

Copyright (c) 2015, 2016, 2017, 2018 Ethan Furman.

All rights reserved.

Redistribution and use in source and binary forms, with or without

modification, are permitted provided that the following conditions

are met:

    Redistributions of source code must retain the above

    copyright notice, this list of conditions and the

    following disclaimer.

    Redistributions in binary form must reproduce the above

    copyright notice, this list of conditions and the following

    disclaimer in the documentation and/or other materials

    provided with the distribution.

    Neither the name Ethan Furman nor the names of any

    contributors may be used to endorse or promote products

    derived from this software without specific prior written

    permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"

AND ANY EXPRESS 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 THE COPYRIGHT HOLDER OR 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.