Add a new title template variable

This will be useful when generating the documentation, as we need a
pretty name for the project for the website title for example, but this
could be used in other places where a pretty, human readable, name is
needed.

Signed-off-by: Leandro Lucarella <[email protected]>

Author: llucax

cookiecutter/cookiecutter.json

@@ -8,6 +8,7 @@
 	],
 	"name": null,
 	"description": null,
+	"title": "{{cookiecutter | title}}",
 	"keywords": "(comma separated: 'frequenz', <type> and <name> are included automatically)",
 	"github_org": "frequenz-floss",
 	"license": [
@@ -26,6 +27,7 @@
 		"local_extensions.github_repo_name",
 		"local_extensions.keywords",
 		"local_extensions.pypi_package_name",
-		"local_extensions.python_package"
+		"local_extensions.python_package",
+		"local_extensions.title"
 	]
 }

cookiecutter/local_extensions.py

@@ -82,6 +82,31 @@ def github_repo_name(cookiecutter: dict[str, str]) -> str:
     return f"{pypi}{end}"
 
 
+@_simple_filter  # type: ignore[misc]
+def title(cookiecutter: dict[str, str]) -> str:
+    """Build a default mkdocs site name for the project.
+
+    Args:
+        cookiecutter: The cookiecutter context.
+
+    Returns:
+        The default site name.
+    """
+    match cookiecutter["type"]:
+        case "actor":
+            return f"Frequenz {cookiecutter['name']} actor"
+        case "api":
+            return f"Frequenz {cookiecutter['name']} API"
+        case "lib":
+            return f"Freqenz {cookiecutter['name']} library"
+        case "app":
+            return f"Frequenz {cookiecutter['name']} app"
+        case "model":
+            return f"Frequenz {cookiecutter['name']} AI model"
+        case _ as repo_type:
+            assert False, f"Unhandled repository type {repo_type!r}"
+
+
 @_simple_filter  # type: ignore[misc]
 def keywords(cookiecutter: dict[str, str]) -> str:
     """Extend cookiecutter["keywords"] with predefined ones by repository type.