extypes 2.0.0

链接

• PyPI上的包：http://pypi.python.org/pypi/extypes

• GitHub上的存储库和问题：http://github.com/rbarrois/extypes

• 在https://extypes.readthedocs.io/上的文档（尚未提供）

入门

从PyPI使用pip安装包

$ pip install extypes

或从GitHub

$ git clone git://github.com/rbarrois/extypes
$ cd extypes
$ python setup.py install

要检查是否一切顺利，请启动Python外壳并导入extypes

import extypes

简介

extypes提供了一个新的类型，ConstrainedSet。

这是一个类似于set()的对象，但值只能从一组特定的选项中获取。

ConstrainedSet的声明方式与collections.namedtuple非常相似

import extypes
Foods = extypes.ConstrainedSet(['eggs', 'spam', 'bacon'])

这将声明一个新类，Foods，其实例是仅接受选项为'eggs'、'spam'和'bacon'的ConstrainedSet。

这些对象可以用作简单的set()对象

>>> import extypes
>>> Foods = extypes.ConstrainedSet(['eggs', 'spam', 'bacon'])
>>> meat = Foods(['spam', 'bacon'])
>>> fresh = Foods(['bacon', 'eggs'])
>>> 'eggs' in meat
False
>>> 'eggs' in fresh
True
>>> meat & fresh
Foods(['bacon'])

作为一个set()对象，它们是可变的

>>> import extypes
>>> Foods = extypes.ConstrainedSet(['eggs', 'spam', 'bacon'])
>>> meat = Foods(['spam', 'bacon'])
>>> meat.remove('spam')
>>> meat
Foods(['bacon'])

并且可迭代的

>>> import extypes
>>> Foods = extypes.ConstrainedSet(['eggs', 'spam', 'bacon'])
>>> meat = Foods(['bacon', 'spam'])
>>> list(meat)
['spam', 'bacon']

但只接受有效选项

>>> Foods = extypes.ConstrainedSet(['eggs', 'spam', 'bacon'])
>>> greens = Foods(['spinach']
Traceback (most recent call last):
...
ValueError: Invalid keys ['spinach'], please use a value in ['spam', 'bacon', 'eggs'].

扩展：Django

extypes 还为 Django 提供自定义字段 - 兼容 Django 1.7 及以上版本。

from django.db import models
import extypes
import extypes.django

Foods = extypes.ConstrainedSet(['eggs', 'spam', 'bacon'])

class Fridge(models.Model):
    contents = extypes.django.SetField(choices=Foods)

该字段将简单地表现为一个简单的 ConstrainedSet。

>>> fridge = Fridge(contents=['bacon'])
>>> fridge.contents.add('eggs')
>>> fridge.save()

在表单中，它显示为一个多选字段。在数据库中，它以启用值的 | 分隔列表的形式保存（在上面的例子中，字段存储为 |eggs|bacon|）。