Add .api.decimal() encoder

Simply casts to `Decimal` then calls `item()` on it as normal for most
basic types.

Author: goodboy

tomlkit/__init__.py

@@ -5,6 +5,7 @@
 from tomlkit.api import comment
 from tomlkit.api import date
 from tomlkit.api import datetime
+from tomlkit.api import decimal
 from tomlkit.api import document
 from tomlkit.api import dump
 from tomlkit.api import dumps
@@ -33,6 +34,7 @@
     "comment",
     "date",
     "datetime",
+    "decimal",
     "document",
     "dump",
     "dumps",

tomlkit/api.py

@@ -3,6 +3,7 @@
 import datetime as _datetime
 
 from collections.abc import Mapping
+from decimal import Decimal
 from typing import IO
 from typing import Iterable
 
@@ -99,6 +100,10 @@ def float_(raw: str | float) -> Float:
     """Create an float item from a number or string."""
     return item(float(raw))
 
+def decimal(raw: str | Decimal | float) -> String:
+    """Create an string item from a ``decimal.Decimal``."""
+    return item(Decimal(raw))
+
 
 def boolean(raw: str) -> Bool:
     """Turn `true` or `false` into a boolean item."""