django-counter-cache-field 0.1.2

快速入门

1. 安装django计数器字段：

   pip install django-counter-cache-field
   

   在

2. 将“django_counter_field”添加到已安装的应用程序设置中：

   ^{pr2}$ 在

3. 将CounterCacheField添加到模型中：

   from django_counter_field import CounterCacheField
   
   
   class Article(models.Model):
       comment_count = CounterCacheField()
   

   在

4. 将相关外键字段与信号中的计数器字段连接起来：

   connect_counter('comment_count', Comment.article)
   

   在

无论何时创建评论，关联文章上的评论数都将增加。如果评论是 删除后，注释计数将自动递减。在

概述

创建新计数器需要三个简单步骤：

1. 将CounterCacheField字段添加到父模型。在
2. 将CounterMixinmixin添加到子模型中。在
3. 使用connect_counter将子模型与新计数器连接起来。在

大多数计数器都很简单，因为您希望对所有子对象进行计数。但是，有时对象应该 根据一个或几个条件计算的。例如，您可能不希望统计一篇文章中的all评论，但是 仅限已批准的评论。您可以通过提供第三个is_in_counter_func来创建条件计数器 连接计数器的参数：

connect_counter(‘comment_count’, Comment.article, lambda comment: comment.is_approved)

is_in_counter_func函数将使用Comment对象调用，并且必须返回True 应该算在内。它不必关心检查注释是否被删除，django counter字段 默认情况下会这样做。在

回填

通常，您会将CounterCacheField添加到已经有大量关联对象的模型中。当一个计数器 的值初始化为零。此值可能不正确。django counter字段提供了一对 允许您重新生成计数器值的管理命令：

1. 列出所有可用计数器：

   $ python manage.py list_counters

   在

2. 使用list_counters给出的计数器名称之一重建计数器：

   $ python manage.py rebuild_counter <counter_name>

   在

注意：管理命令只更新至少有一个子对象的计数器 对象。例如至少有一条评论的文章。没有评论的文章将不会更新。这个 是一个有意识的限制；这种特性的用例似乎非常有限，如果有的话。在

文件

$ pip install Sphinx $ cd docs $ make html Open build/html/index.html