[filters] Jinja - groupby() 필터 - 속성별로 객체 시퀀스를 그룹화. (= groupby필터 = 그룹바이필터)

1. groupby() 예제 - 속성별로 그룹화
2. groupby() 정의
3. groupby() 구문
4. groupby() 예제 - 그룹별로 List 자료형 문자열로 출력
5. groupby() 예제 - 그룹화 할 속성 없을 시 기본값 추가

groupby() 예제 - 속성별로 그룹화

[예제1] - type별로 그룹화

 

{% set items = [

    { "name": "모모", "type": "green"},

    { "name": "사나", "type": "blue" }, 

    { "name": "다현", "type": "blue" },

    { "name": "쯔위", "type": "green"}

] %}

{% for type, items in items | groupby('type') %}

{{ type }}:

{% for item in items %}{{ item.name }} {% endfor %}

{% endfor %}

 

결과값: blue: 사나 다현 green: 모모 쯔위

---

[예제2] - 도시별로 그룹화해서 멤버 출력

 

{% set users = [

    {'name': '서울1', 'city': '서울'},

    {'name': '대전1', 'city': '대전'},

    {'name': '광주1', 'city': '광주'},

    {'name': '서울2', 'city': '서울'},

    {'name': '광주2', 'city': '광주'}

] %}

<ul>{% for city, items in users|groupby("city") %}

  <li>{{ city }}

    <ul>{% for user in items %}

      <li>{{ user.name }}

    {% endfor %}</ul>

  </li>

{% endfor %}</ul>

 

결과값:

광주

  광주1

  광주2

대전

  대전1

서울

  서울1

  서울2

groupby() 정의

 

Python의 itertools.groupby() 사용해 속성별로 객체 시퀀스를 그룹화하는 필터.

 

---

 

1.

• 속성은 "address.city"와 같이 중첩된 액세스에 점(.) 표기법을 사용 가능. 
• Python의 groupby와 달리, 값이 먼저 정렬되므로 각 고유 값에 대해 하나의 그룹만 반환됨.

 

2.

• sort() 필터와 마찬가지로, 정렬 및 그룹화는 기본적으로 대소문자 구분 X. 
• 각 그룹의 키는 해당 값 그룹의 첫 번째 항목의 대/소문자 갖음. (예) 사용자 목록에 도시 ["CA", "NY", "ca"]가 있는 경우 "CA" 그룹에는 2개 값이 존재. (※ case_sensitive=True 전달해 대소문자 구분으로 변경 가능.)

 

3.

• Jinja2 3.1 - case_sensitive 매개변수 추가. (※ 정렬 및 그룹화는 기본적으로 대소문자를 구분하지 않으며 비교를 수행하는 다른 필터와 일치함. )
• Jinja2 3.0 - default 매개변수 추가. 
• Jinja2 2.6 - 속성은 중첩 액세스에 대한 점 표기법을 지원.

 

groupby() 구문

 

jinja-filters.groupby(value: 't.Iterable[V]', attribute: str | int, default: Any | None = None, case_sensitive: bool = False) → 't.List[_GroupTuple]'

 

groupby() 예제 - 그룹별로 List 자료형 문자열로 출력

• groupby는 위 예처럼 풀어헤쳐진 튜플 대신 사용 가능한 (grouper, list) 튜플을 생성함. (※ grouper는 속성 값이고 list는 해당 값을 가진 아이템임.)

{% set users = [

    {'name': '서울1', 'city': '서울'},

    {'name': '대전1', 'city': '대전'},

    {'name': '광주1', 'city': '광주'},

    {'name': '서울2', 'city': '서울'},

    {'name': '광주2', 'city': '광주'}

] %}

<ul>{% for group in users|groupby("city") %}

  <li>{{ group.grouper }}: {{ group.list|join(", ") }}</li>

{% endfor %}</ul>

 

결과값

광주: {'name': '광주1', 'city': '광주'}, {'name': '광주2', 'city': '광주'}

대전: {'name': '대전1', 'city': '대전'}

서울: {'name': '서울1', 'city': '서울'}, {'name': '서울2', 'city': '서울'}

groupby() 예제 - 그룹화 할 속성 없을 시 기본값 추가

 

{% set users = [

    {'name': '미상1'},

    {'name': '서울1', 'city': '서울'},

    {'name': '대전1', 'city': '대전'},

    {'name': '광주1', 'city': '광주'},

    {'name': '서울2', 'city': '서울'},

    {'name': '광주2', 'city': '광주'},

    {'name': '미상2'}

] %}

<ul>{% for city, items in users|groupby("city", default="지구") %}

  <li>{{ city }} - {{ items|map(attribute="name")|join(", ") }}</li>

{% endfor %}</ul>

 

결과값:

광주 - 광주1, 광주2

대전 - 대전1

서울 - 서울1, 서울2

지구 - 미상1, 미상2