-
+ {% for user in users %}
+
- {{ user.username }} + {% endfor %} +
{% debug %}
+
+ .. code-block:: text
+
+ {'context': {'cycler': -
+ {% for key, value in my_dict|items %}
+
- {{ key }} +
- {{ value }} + {% endfor %} +
-
+ ...
+
+ {%- for column in items|slice(3) %}
+
+
+ If you pass it a second argument it's used to fill missing
+ values on the last iteration.
+ """
+ seq = list(value)
+ length = len(seq)
+ items_per_slice = length // slices
+ slices_with_extra = length % slices
+ offset = 0
+
+ for slice_number in range(slices):
+ start = offset + slice_number * items_per_slice
+
+ if slice_number < slices_with_extra:
+ offset += 1
+
+ end = offset + (slice_number + 1) * items_per_slice
+ tmp = seq[start:end]
+
+ if fill_with is not None and slice_number >= slices_with_extra:
+ tmp.append(fill_with)
+
+ yield tmp
+
+
+@async_variant(sync_do_slice) # type: ignore
+async def do_slice(
+ value: "t.Union[t.AsyncIterable[V], t.Iterable[V]]",
+ slices: int,
+ fill_with: t.Optional[t.Any] = None,
+) -> "t.Iterator[t.List[V]]":
+ return sync_do_slice(await auto_to_list(value), slices, fill_with)
+
+
+def do_batch(
+ value: "t.Iterable[V]", linecount: int, fill_with: "t.Optional[V]" = None
+) -> "t.Iterator[t.List[V]]":
+ """
+ A filter that batches items. It works pretty much like `slice`
+ just the other way round. It returns a list of lists with the
+ given number of items. If you provide a second parameter this
+ is used to fill up missing items. See this example:
+
+ .. sourcecode:: html+jinja
+
+ -
+ {%- for item in column %}
+
- {{ item }} + {%- endfor %} +
| {{ column }} | + {%- endfor %} +
- {% for city, items in users|groupby("city") %}
+
- {{ city }}
+
- {% for user in items %}
+
- {{ user.name }} + {% endfor %}
+ {% endfor %}
- {% for group in users|groupby("city") %}
+
- {{ group.grouper }}: {{ group.list|join(", ") }} + {% endfor %}
- {% for city, items in users|groupby("city", default="NY") %}
+
- {{ city }}: {{ items|map(attribute="name")|join(", ") }} + {% endfor %}