WIP: Documentation improvement and format change to Google

src/libbot/i18n/classes/bot_locale.py

@@ -14,6 +14,11 @@ class BotLocale:
         default_locale: str | None = "en",
         locales_root: str | Path = Path("locale"),
     ) -> None:
+        """
+        Args:
+            default_locale (str | None, optional): Default locale. Defaults to "en".
+            locales_root (str | Path, optional): Path to a directory with locale files. Defaults to Path("locale").
+        """
         if isinstance(locales_root, str):
             locales_root = Path(locales_root)
         elif not isinstance(locales_root, Path):
@@ -30,15 +35,15 @@ class BotLocale:
             self.locales[locale] = json_read(Path(f"{locales_root}/{locale}.json"))
 
     def _(self, key: str, *args: str, locale: str | None = None) -> Any:
-        """Get value of locale string
+        """Get value of locale string.
 
-        ### Args:
-            * key (`str`): The last key of the locale's keys path
-            * *args (`str`): Path to key like: `dict[args][key]`
-            * locale (`str | None`, *optional*): Locale to looked up in. Defaults to config's `"locale"` value
+        Args:
+            key (str): The last key of the locale's keys path.
+            *args (str): Path to key like: `dict[args][key]`.
+            locale (str | None, optional): Locale to looked up in. Defaults to config's `"locale"` value.
 
-        ### Returns:
-            * `Any`: Value of provided locale key. Is usually `str`, `Dict[str, Any]` or `List[Any]`
+        Returns:
+            Any: Value of provided locale key. Is usually `str`, `Dict[str, Any]` or `List[Any]`.
         """
         if locale is None:
             locale: str = self.default
@@ -64,14 +69,14 @@ class BotLocale:
             return f'⚠️ Locale in config is invalid: could not get "{key}" in {args} from locale "{locale}"'
 
     def in_all_locales(self, key: str, *args: str) -> List[Any]:
-        """Get value of the provided key and path in all available locales
+        """Get value of the provided key and path in all available locales.
 
-        ### Args:
-            * key (`str`): The last key of the locale's keys path.
-            * *args (`str`): Path to key like: `dict[args][key]`.
+        Args:
+            key (str): The last key of the locale's keys path.
+            *args (str): Path to key like: `dict[args][key]`.
 
-        ### Returns:
-            * `List[Any]`: List of values in all locales
+        Returns:
+            List[Any]: List of values in all locales.
         """
         output: List[Any] = []
 
@@ -94,14 +99,14 @@ class BotLocale:
         return output
 
     def in_every_locale(self, key: str, *args: str) -> Dict[str, Any]:
-        """Get value of the provided key and path in every available locale with locale tag
+        """Get value of the provided key and path in every available locale with locale tag.
 
-        ### Args:
-            * key (`str`): The last key of the locale's keys path.
-            * *args (`str`): Path to key like: `dict[args][key]`.
+        Args:
+            key (str): The last key of the locale's keys path.
+            *args (str): Path to key like: `dict[args][key]`.
 
-        ### Returns:
-            * `Dict[str, Any]`: Locale is a key, and it's value from locale file is a value
+        Returns:
+            Dict[str, Any]: Locale is a key, and it's value from locale file is a value.
         """
         output: Dict[str, Any] = {}