chore: add type stubs

.pre-commit-config.yaml

@@ -16,7 +16,7 @@ repos:
       - id: fmt
       - id: cargo-check
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.14.10
+    rev: v0.15.0
     hooks:
       - id: ruff
         args: [--fix, --select, I]  # I = isort (import sorting)

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "toons"
-version = "0.5.0"
+version = "0.5.1"
 edition = "2024"
 
 # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

pyproject.toml

@@ -23,6 +23,7 @@ Source = "https://github.com/alesanfra/toons"
 
 [tool.maturin]
 features = ["pyo3/extension-module", "pyo3/abi3-py37"]
+include = ["toons.pyi"]
 
 [tool.ruff]
 line-length = 79

toons.pyi

@@ -0,0 +1,33 @@
+from typing import IO, Any, Optional
+
+def load(
+    fp: IO[str],
+    *,
+    strict: bool = True,
+    expand_paths: Optional[str] = None,
+    indent: Optional[int] = None,
+) -> Any: ...
+def loads(
+    s: str,
+    *,
+    strict: bool = True,
+    expand_paths: Optional[str] = None,
+    indent: Optional[int] = None,
+) -> Any: ...
+def dump(
+    obj: Any,
+    fp: IO[str],
+    *,
+    indent: int = 2,
+    delimiter: str = ",",
+    key_folding: Optional[str] = None,
+    flatten_depth: Optional[int] = None,
+) -> None: ...
+def dumps(
+    obj: Any,
+    *,
+    indent: int = 2,
+    delimiter: str = ",",
+    key_folding: Optional[str] = None,
+    flatten_depth: Optional[int] = None,
+) -> str: ...