redis-limpyd-extensions 2.1

FKStringField

• sadd，用于将反向关系设置为参数的外键

拥有

class Group(RelatedModel):
    parent = FKStringField(self, related_name='children')

标准

child_group.parent.set(main_group)
other_child_group.parent.set(main_group)

与新的相同

main_group.children.sadd(child_group, other_child_group)

• srem 与 sadd 工作方式相同，但用于删除外键

标准

child_group.parent.delete(main_group)
other_child_group.parent.delete(main_group)

与新的相同

main_group.children.srem(child_group, other_child_group)

FKHashableField

• sadd

• srem

这两个方法与 FKStringField 完全相同，唯一的区别是 sadd 模拟了 hset 而不是 set。

M2MSetField

• sadd

标准

group_2.members.sadd(somebody)
group_3.members.sadd(somebody)

与新的相同

somebody.membership.sadd(group2, group3)

• srem 与 sadd 工作方式相同，但用于移除关系

标准

group_2.members.srem(somebody)
group_3.members.srem(somebody)

与新的相同

somebody.membership.srem(group2, group3)

M2MListField

• lpush 和 rpush，它们对于 M2MListField 的工作方式类似于 M2MSetField 中的 sadd。

在我们的 Person/Group 示例中，如果 members 是一个 M2MListField 而不是一个 M2MSetField，

标准

group_2.members.rpush(somebody)
group_3.members.rpush(somebody)

与新的相同

somebody.membership.rpush(group2, group3)

• lrem 与 rpush 和 lpush 工作方式相同，但用于移除关系

标准

group_2.members.lrem(0, somebody)  # 0 for "all occurences"
group_3.members.lrem(0, somebody)

与新的相同

somebody.membership.lrem(group2, group3)  # the count is forced to 0

M2MSortedSetField

• zadd，它对于 M2MSortedSetField 的工作方式类似于 M2MSetField 中的 sadd，但可以管理分数。参数设置方式与正常的 zadd 命令相同。

在我们的 Person/Group 示例中，如果 members 是一个 M2MSortedSetField 而不是一个 M2MSetField，则可以使用分数来保存成员的加入日期

标准

group_2.members.zadd({somebody: sometime})  # sometime, a float, can be a call to time.time()
group_3.members.zadd({somebody: another_time})

与新的相同

somebody.membership.zadd({group2: sometime, group3: another_time})

• zrem 与 zadd 工作方式相同，但没有分数，但用于移除关系

标准

group_2.members.zrem(somebody)
group_3.members.zrem(somebody)

与新的相同

somebody.membership.zrem(group2, group3)

过滤

要在可索引的动态字段上过滤，也有两种方法

• 使用经典方式，如果您事先知道动态部分

MyModel.collection(foo_bar='three')

• 使用新的 dynamic_filter 方法

MyModel.collection().dynamic_filter('foo', 'bar', 'three')

参数包括：字段名称、动态部分、过滤值，以及在上一个示例中没有显示的索引后缀。

此后缀默认为空。

但如果你想做的

MyModel.collection(foo_bar__eq='three')

您可以使用 dynamic_filter 这样做

MyModel.collection().dynamic_filter('foo', 'bar', 'three', 'eq')  # you can use '__eq' too

与 ModelWithDynamicFieldMixin 一起使用的集合管理器依赖于 ExtendedCollectionManager，因此您可以在结果集合上链式调用过滤和动态过滤。

动态相关字段

动态字段也可以与相关字段一起工作，方式完全相同。只有两个补充

• 如果在 get_for 方法中传递一个模型实例，它将被转换为它的 pk

• “相关集合”的第一个参数是动态部分（也可以是实例）

使用动态相关字段的示例

from limpyd.fields import PKField
from limpyd_extensions.dynamic.model import ModelWithDynamicFieldMixin
from limpyd_extensions.dynamic.related import DynamicM2MSetField

class Tag(MyBaseModel):
    slug = PKField()

class Person(MyBaseModel):
    name = PKField()

class Movie(ModelWithDynamicFieldMixin, MyBaseModel):
    name = PKField()
    tags = DynamicM2MSetField(Tag, related_name='movies')

somebody = Person(name='Somebody')
matrix = Movie(name='Matrix')
cool = Tag(name='cool')

matrix.tags.get_for(somebody).sadd(cool)
# same as: matrix.tags(somebody).sadd(cool)

cool_movies_for_somebody = cool.movies(somebody)  # the related collection
# ['Matrix']

提供类

以下是 limpyd_extensions.dynamic 模块提供的模块和类的列表

• 模型

  • 混合

    • ModelWithDynamicFieldMixin(object) - 用于具有动态字段的模型的混合

• 集合

  • 混合

    • CollectionManagerForModelWithDynamicFieldMixin(object) - 如果您想要将自己的动态过滤方法添加到自己的集合管理器中，请使用此混合

  • 完整类

    • CollectionManagerForModelWithDynamicField(CollectionManagerForModelWithDynamicFieldMixin, ExtendedCollectionManager) - 从我们的混合和 limpyd.contrib.collection 的管理器中继承的简单类

• 字段

  • 混合

    • DynamicFieldMixin(object) - 在所有关于动态字段的工作完成后，用于将动态字段支持添加到您自己的字段中的混合

  • 完整类 所有字段简单地继承自我们的混合和所需的基字段，不再添加其他内容

    • DynamicStringField(DynamicFieldMixin, StringField)

    • DynamicInstanceHashField(DynamicFieldMixin, InstanceHashField)

    • DynamicListField(DynamicFieldMixin, ListField)

    • DynamicSetField(DynamicFieldMixin, SetField)

    • DynamicSortedSetField(DynamicFieldMixin, SortedSetField)

    • DynamicHashField(DynamicFieldMixin, HashField)

• 相关

  • 混合

    • DynamicRelatedFieldMixin(DynamicFieldMixin) - 在所有关于动态相关字段的工作完成后，用于将动态字段支持添加到您自己的相关字段中的混合

  • 完整类

    • DynamicFKStringField(DynamicRelatedFieldMixin, FKStringField)

    • DynamicFKInstanceHashField(DynamicRelatedFieldMixin, FKInstanceHashField)

    • DynamicM2MSetField(DynamicRelatedFieldMixin, M2MSetField)

    • DynamicM2MListField(DynamicRelatedFieldMixin, M2MListField)

    • DynamicM2MSortedSetField(DynamicRelatedFieldMixin, M2MSortedSetField)