Dokümanlar'ı Enums'e nasıl yerleştiririm?

Question

Python 3.4 yeni bir enum modülüne ve Enum veri türüne sahiptir. Henüz 3.4'e geçemiyorsanız, Enum has been backported.

Enum üyeleri, tüm python nesnelerini yaptığı gibi, docstrings'i desteklediğinden bunları ayarlamak isterim. Bunu yapmanın kolay bir yolu var mı?

Answer 1

Evet var ve şu ana kadar benim en sevdiğim tarif. Bonus olarak, tam sayı değerini belirtmek zorunda değildir.

class AddressSegment(AutoEnum): 
    misc = "not currently tracked" 
    ordinal = "N S E W NE NW SE SW" 
    secondary = "apt bldg floor etc" 
    street = "st ave blvd etc" 

Sadece "N S E W NE NW SE SW" yok neden sorabiliriz ordinal değeri olması: İşte bir örnek? Çünkü ben onun reprini görmeye başladığımda <AddressSegment.ordinal: 'N S E W NE NW SE SW'> biraz rahatsız edici oluyor, ama bu bilgiyi docstring'de hazır bulundurmak iyi bir uzlaşmadır.

class AutoEnum(enum.Enum): 
    """ 
    Automatically numbers enum members starting from 1. 

    Includes support for a custom docstring per member. 

    """ 
    __last_number__ = 0 

    def __new__(cls, *args): 
     """Ignores arguments (will be handled in __init__.""" 
     value = cls.__last_number__ + 1 
     cls.__last_number__ = value 
     obj = object.__new__(cls) 
     obj._value_ = value 
     return obj 

    def __init__(self, *args): 
     """Can handle 0 or 1 argument; more requires a custom __init__. 

     0 = auto-number w/o docstring 
     1 = auto-number w/ docstring 
     2+ = needs custom __init__ 

     """ 
     if len(args) == 1 and isinstance(args[0], (str, unicode)): 
      self.__doc__ = args[0] 
     elif args: 
      raise TypeError('%s not dealt with -- need custom __init__' % (args,)) 

ben __new__ içinde __init__ yerine bağımsız değişkenleri ele nedeni sınıflara AutoEnum kolay ben daha da genişletmek istesin yapmaktır:

İşte Enum için tarifi.