1.15小节完成

cookbook/c01/p15_group.py

@@ -4,6 +4,8 @@
 Topic: 分组迭代
 Desc : 
 """
+from operator import itemgetter
+from itertools import groupby
 
 
 def group_iter():
@@ -18,7 +20,19 @@ def group_iter():
         {'address': '1039 W GRANVILLE', 'date': '07/04/2012'},
     ]
 
+    # Sort by the desired field first
+    rows.sort(key=itemgetter('date'))
+    # Iterate in groups
+    for date, items in groupby(rows, key=itemgetter('date')):
+        print(date)
+        for i in items:
+            print(' ', i)
 
+    # defaultdict使用
+    from collections import defaultdict
+    rows_by_date = defaultdict(list)
+    for row in rows:
+        rows_by_date[row['date']].append(row)
 
 if __name__ == '__main__':
     group_iter()

source/c01/p15_group_records_based_on_field.rst

@@ -17,11 +17,82 @@ itertools.groupby()函数对于这样的数据分组操作非常实用。
 
 .. code-block:: python
 
+    rows = [
+        {'address': '5412 N CLARK', 'date': '07/01/2012'},
+        {'address': '5148 N CLARK', 'date': '07/04/2012'},
+        {'address': '5800 E 58TH', 'date': '07/02/2012'},
+        {'address': '2122 N CLARK', 'date': '07/03/2012'},
+        {'address': '5645 N RAVENSWOOD', 'date': '07/02/2012'},
+        {'address': '1060 W ADDISON', 'date': '07/02/2012'},
+        {'address': '4801 N BROADWAY', 'date': '07/01/2012'},
+        {'address': '1039 W GRANVILLE', 'date': '07/04/2012'},
+    ]
 
+现在假设你想在按date分组后的数据块上进行迭代。为了这样做，你首先需要按照指定的字段(这里就是date)排序，
+然后调用itertools.groupby()函数：
+
+.. code-block:: python
+
+    from operator import itemgetter
+    from itertools import groupby
+
+    # Sort by the desired field first
+    rows.sort(key=itemgetter('date'))
+    # Iterate in groups
+    for date, items in groupby(rows, key=itemgetter('date')):
+        print(date)
+        for i in items:
+            print(' ', i)
+
+运行结果：
+
+.. code-block:: python
+
+    07/01/2012
+      {'date': '07/01/2012', 'address': '5412 N CLARK'}
+      {'date': '07/01/2012', 'address': '4801 N BROADWAY'}
+    07/02/2012
+      {'date': '07/02/2012', 'address': '5800 E 58TH'}
+      {'date': '07/02/2012', 'address': '5645 N RAVENSWOOD'}
+      {'date': '07/02/2012', 'address': '1060 W ADDISON'}
+    07/03/2012
+      {'date': '07/03/2012', 'address': '2122 N CLARK'}
+    07/04/2012
+      {'date': '07/04/2012', 'address': '5148 N CLARK'}
+      {'date': '07/04/2012', 'address': '1039 W GRANVILLE'}
 
 |
 
 ----------
 讨论
 ----------
-todo...
+groupby()函数扫描整个序列并且查找连续相同值(或者根据指定key函数返回值相同)的元素序列。
+在每次迭代的时候，它会返回一个值和一个迭代器对象，
+这个迭代器对象可以生成元素值全部等于上面那个值的组中所有对象。
+
+一个非常重要的准备步骤是要根据指定的字段将数据排序。
+因为groupby()仅仅检查连续的元素，如果事先并没有排序完成的话，分组函数将得不到想要的结果。
+
+如果你仅仅只是想根据date字段将数据分组到一个大的数据结构中去，并且允许随机访问，
+那么你最好使用defaultdict()来构建一个多值字典，关于多值字典已经在1.6小节有过详细的介绍。比如：
+
+.. code-block:: python
+
+    from collections import defaultdict
+    rows_by_date = defaultdict(list)
+    for row in rows:
+        rows_by_date[row['date']].append(row)
+
+这样的话你可以很轻松的就能对每个指定日期访问对应的记录：
+
+.. code-block:: python
+
+    >>> for r in rows_by_date['07/01/2012']:
+    ... print(r)
+    ...
+    {'date': '07/01/2012', 'address': '5412 N CLARK'}
+    {'date': '07/01/2012', 'address': '4801 N BROADWAY'}
+    >>>
+
+在上面这个例子中，我们没有必要先把记录排序。因此，如果对内存占用不是很关心，
+这种方式会比先排序然后再通过groupby()函数迭代的方式运行得快一些。