Support 'oxford comma' format and non-string types in listing

src/human_readable/lists.py

@@ -1,11 +1,17 @@
 """Tests for lists humanization."""
 from __future__ import annotations
+from typing import TYPE_CHECKING
+
+
+if TYPE_CHECKING:
+    from collections.abc import Sequence
+    from typing import Any
 
 
 __all__ = ["listing"]
 
 
-def listing(items: list[str], separator: str, conjunction: str = "") -> str:
+def listing(items: Sequence[Any], separator: Any, conjunction: Any = None, oxford: bool = False) -> str:
     """Return human readable list separated by separator.
 
     Optional argument is conjuntion that substitutes the last separator.
@@ -14,6 +20,7 @@ def listing(items: list[str], separator: str, conjunction: str = "") -> str:
         items: list of items.
         separator: separator of items.
         conjunction: word/string as last separator. Defaults to None.
+        oxford: apply separators in the same manner as an oxford comma
 
     Returns:
         str: list in natural language.
@@ -22,11 +29,13 @@ def listing(items: list[str], separator: str, conjunction: str = "") -> str:
     if len_items == 0:
         return ""
     if len_items == 1:
-        return items[0]
-    phrase = items[0]
-    if conjunction:
+        return str(items[0])
+    phrase = str(items[0])
+    if conjunction is not None:
         for i in range(1, len_items - 1):
             phrase += f"{separator} {items[i]}"
+        if oxford and len_items > 2:
+            phrase += str(separator)
         phrase += f" {conjunction} {items[len_items - 1]}"
     else:
         for i in range(1, len_items):