feat(list): add List class for rendering items

Author: m-xim

textcompose/container/list.py

@@ -0,0 +1,40 @@
+from typing import Any, Optional, Iterable, Union, Callable
+
+from magic_filter import MagicFilter
+
+from textcompose.container.container import BaseContainer
+from textcompose.content.content import Value, Condition
+
+
+class List(BaseContainer):
+    def __init__(
+        self,
+        *items: Value,
+        getter: Union[MagicFilter, Callable[[dict[str, Any]], Iterable]],
+        sep: Optional[str] = "\n\n",
+        inner_sep: str = "\n",
+        when: Condition | None = None,
+    ) -> None:
+        super().__init__(*items, when=when)
+        self.items = items
+        self.getter = getter
+        self.sep = sep
+        self.inner_sep = inner_sep
+
+    def _render_item(self, item_value: Any, context: dict[str, Any], **kwargs) -> str | None:
+        rendered_parts = [
+            self.resolve_value(item_tpl, {"item": item_value, "context": context}, **kwargs) for item_tpl in self.items
+        ]
+        return self.inner_sep.join(filter(None, rendered_parts)) or None
+
+    def render(self, context: dict[str, Any], **kwargs) -> str | None:
+        if not self._check_when(context, **kwargs):
+            return None
+
+        items_iterable = self.resolve_value(self.getter, context, **kwargs)
+        if not items_iterable:
+            return None
+
+        rendered_items = [self._render_item(item_value, context, **kwargs) for item_value in items_iterable]
+
+        return self.sep.join(filter(None, rendered_items)) or None