feat(i18n): Employ babel, add proper internationalization to dates

ancv/visualization/templates.py

@@ -1,11 +1,14 @@
 import json
 from abc import ABC, abstractmethod
 from contextlib import redirect_stdout
-from functools import singledispatchmethod
+from datetime import date
+from functools import lru_cache, singledispatchmethod
 from pathlib import Path
 from tempfile import SpooledTemporaryFile
 from typing import MutableSequence, NamedTuple, Optional
 
+from babel.core import Locale
+from babel.dates import format_date
 from rich.align import Align
 from rich.console import Console, ConsoleOptions, Group, NewLine, RenderableType, group
 from rich.padding import Padding
@@ -48,11 +51,13 @@ def __init__(
         model: ResumeSchema,
         theme: Theme,
         translation: Translation,
+        locale: Locale,
         ascii_only: bool,
     ) -> None:
         self.model = model
         self.theme = theme
         self.translation = translation
+        self.locale = locale
         self.ascii_only = ascii_only
 
     # This is behavior:
@@ -86,6 +91,32 @@ def render(self) -> str:
                 console.print(self)
         return capture.get().strip()
 
+    @lru_cache(maxsize=1_000)
+    def format_date(self, date: date) -> str:
+        return format_date(date, format=self.theme.datefmt, locale=self.locale)
+
+    @lru_cache(maxsize=1_000)
+    def date_range(
+        self,
+        start: Optional[date],
+        end: Optional[date],
+        sep: str = "-",
+        collapse: bool = True,
+    ) -> str:
+        if start is None:
+            if end is None:
+                return ""
+            return f"{sep} {self.format_date(end)}"
+
+        if end is None:
+            return f"{self.format_date(start)} {sep} {self.translation.present}"
+
+        collapsible = start.month == end.month and start.year == end.year
+        if collapsible and collapse:
+            return self.format_date(end)
+
+        return f"{self.format_date(start)} {sep} {self.format_date(end)}"
+
     @classmethod
     # A property would be nicer but it's not supported from Python 3.11 on:
     # https://docs.python.org/3.11/library/functions.html#classmethod
@@ -104,12 +135,12 @@ def from_model_config(cls, model: ResumeSchema) -> "Template":
         except KeyError as e:
             raise ResumeConfigError(f"Unknown theme: {theme_name}") from e
 
-        if (translation_name := config.language) is None:
-            translation_name = "en"
+        if (language := config.language) is None:
+            language = "en"
         try:
-            translation = TRANSLATIONS[translation_name]
+            translation = TRANSLATIONS[language]
         except KeyError as e:
-            raise ResumeConfigError(f"Unknown translation: {translation_name}") from e
+            raise ResumeConfigError(f"Unknown language: {language}") from e
 
         if (template_name := config.template) is None:
             template_name = Sequential.__name__
@@ -125,6 +156,7 @@ def from_model_config(cls, model: ResumeSchema) -> "Template":
             model=model,
             theme=theme,
             translation=translation,
+            locale=Locale(language),
             ascii_only=ascii_only,
         )
 
@@ -263,7 +295,7 @@ def _(self, item: WorkItem, theme: Theme) -> RenderableGenerator:
         )
 
         yield from horizontal_fill(
-            tagline, theme.date_range(item.startDate, item.endDate, theme.datefmt)
+            tagline, self.date_range(item.startDate, item.endDate)
         )
 
         if position := item.position:
@@ -307,7 +339,7 @@ def _(self, item: Skill, theme: Theme) -> RenderableGenerator:
     def _(self, item: VolunteerItem, theme: Theme) -> RenderableGenerator:
         yield from horizontal_fill(
             Text(item.organization or "", style=theme.emphasis[0]),
-            theme.date_range(item.startDate, item.endDate, theme.datefmt),
+            self.date_range(item.startDate, item.endDate),
         )
 
         if position := item.position:
@@ -336,7 +368,7 @@ def _(self, item: EducationItem, theme: Theme) -> RenderableGenerator:
                 (item.area or "", theme.emphasis[1]),
                 f" ({item.studyType})" if item.studyType else "",
             ),
-            theme.date_range(item.startDate, item.endDate, theme.datefmt),
+            self.date_range(item.startDate, item.endDate),
         )
 
         if score := item.score:
@@ -359,7 +391,7 @@ def _(self, item: Award, theme: Theme) -> RenderableGenerator:
                 (item.title or "", theme.emphasis[0]),
                 (f" ({item.awarder})" if item.awarder else "", theme.emphasis[1]),
             ),
-            item.date.strftime(theme.datefmt) if item.date else "",
+            self.format_date(item.date) if item.date else "",
         )
 
         if summary := item.summary:
@@ -373,7 +405,7 @@ def _(self, item: Certificate, theme: Theme) -> RenderableGenerator:
                 (item.name or "", theme.emphasis[0]),
                 (f" ({item.issuer})" if item.issuer else "", theme.emphasis[1]),
             ),
-            item.date.strftime(theme.datefmt) if item.date else "",
+            self.format_date(item.date) if item.date else "",
         )
 
         if url := item.url:
@@ -387,7 +419,7 @@ def _(self, item: Publication, theme: Theme) -> RenderableGenerator:
                 (item.name or "", theme.emphasis[0]),
                 (f" ({item.publisher})" if item.publisher else "", theme.emphasis[1]),
             ),
-            item.releaseDate.strftime(theme.datefmt) if item.releaseDate else "",
+            self.format_date(item.releaseDate) if item.releaseDate else "",
         )
 
         if summary := item.summary:
@@ -433,7 +465,7 @@ def _(self, item: Project, theme: Theme) -> RenderableGenerator:
                 (item.name or "", theme.emphasis[0]),
                 (f" - {item.type}" if item.type else "", theme.emphasis[1]),
             ),
-            theme.date_range(item.startDate, item.endDate, theme.datefmt),
+            self.date_range(item.startDate, item.endDate),
         )
 
         if description := item.description:

ancv/visualization/themes.py

@@ -1,6 +1,3 @@
-from datetime import date
-from typing import Optional
-
 from pydantic import BaseModel
 from rich.style import Style
 
@@ -15,37 +12,14 @@ class Theme(BaseModel):
     class Config:
         arbitrary_types_allowed = True  # No validator for `Style` available
 
-    @staticmethod
-    def date_range(
-        start: Optional[date],
-        end: Optional[date],
-        fmt: str,
-        sep: str = "-",
-        ongoing: str = "present",
-        collapse: bool = True,
-    ) -> str:
-        if start is None:
-            if end is None:
-                return ""
-            return f"{sep} {end.strftime(fmt)}"
-
-        if end is None:
-            return f"{start.strftime(fmt)} {sep} {ongoing}"
-
-        collapsible = start.month == end.month and start.year == end.year
-        if collapsible and collapse:
-            return f"{end.strftime(fmt)}"
-
-        return f"{start.strftime(fmt)} {sep} {end.strftime(fmt)}"
-
 
 THEMES = {
     "plain": Theme(
         emphasis=[Style(), Style(), Style(), Style()],
         headlines=[Style(), Style(), Style(), Style()],
         bullet="*",
         rulechar="─",
-        datefmt="%Y-%m",
+        datefmt="yyyy-MM",
     ),
     "basic": Theme(
         emphasis=[
@@ -62,6 +36,6 @@ def date_range(
         ],
         bullet="*",
         rulechar="─",
-        datefmt="%B %Y",
+        datefmt="MMMM yyyy",
     ),
 }

ancv/visualization/translations.py

@@ -17,6 +17,7 @@ class Translation(BaseModel):
     references: str
     interests: str
     projects: str
+    present: str
 
 
 TRANSLATIONS = {
@@ -36,6 +37,7 @@ class Translation(BaseModel):
         references="References",
         interests="Interests",
         projects="Projects",
+        present="present",
     ),
     "de": Translation(
         score="Note",
@@ -53,5 +55,6 @@ class Translation(BaseModel):
         references="Referenzen",
         interests="Interessen",
         projects="Projekte",
+        present="heute",
     ),
 }