Merge branch 'trs/json-serialize-dates'

augur/io/json.py

@@ -32,14 +32,29 @@
     SOFTWARE.
 """
 import json
-from datetime import datetime
+from datetime import date, datetime
 from typing import Iterable
 from uuid import UUID
 
 
 def as_json(value):
     """
     Converts *value* to a JSON string using our custom :class:`JsonEncoder`.
+
+    The custom encoder supports serialization of :class:`~datetime.date` objects:
+
+    >>> as_json(date(year=2024, month=7, day=17))
+    '"2024-07-17"'
+
+    :class:`~datetime.datetime` objects:
+
+    >>> as_json(datetime(year=2024, month=7, day=17, hour=11, minute=38))
+    '"2024-07-17T11:38:00"'
+
+    and :class:`~uuid.UUID` objects:
+
+    >>> as_json(UUID(int=147952133113722764103424939352979237618))
+    '"6f4e8b5a-8500-4928-b7ae-dc098a256af2"'
     """
     return json.dumps(value, allow_nan = False, cls = JsonEncoder)
 
@@ -96,10 +111,11 @@ def default(self, value):
         """
         Returns *value* as JSON or raises a TypeError.
         Serializes:
+        * :class:`~datetime.date` using :meth:`~datetime.date.isoformat()`
         * :class:`~datetime.datetime` using :meth:`~datetime.datetime.isoformat()`
         * :class:`~uuid.UUID` using ``str()``
         """
-        if isinstance(value, datetime):
+        if isinstance(value, (date, datetime)):
             return value.isoformat()
 
         elif isinstance(value, UUID):