toml-rs 0.0.6__cp314-cp314t-win_amd64.whl → 0.2.0__cp314-cp314t-win_amd64.whl

toml_rs/__init__.py

@@ -1,15 +1,19 @@
 __all__ = (
     "TOMLDecodeError",
+    "TOMLEncodeError",
     "__version__",
+    "dump",
+    "dumps",
     "load",
     "loads",
 )
 
 from collections.abc import Callable
-from typing import Any, BinaryIO
+from pathlib import Path
+from typing import Any, BinaryIO, Literal, TextIO
 
 from ._toml_rs import (
-    _load,
+    _dumps,
     _loads,
     _version,
 )
@@ -17,14 +21,71 @@ from ._toml_rs import (
 __version__: str = _version
 
 
-def load(fp: BinaryIO, /, *, parse_float: Callable[[str], Any] = float) -> dict[str, Any]:
-    return _load(fp, parse_float=parse_float)
+def load(
+    fp: BinaryIO,
+    /,
+    *,
+    parse_float: Callable[[str], Any] = float,
+    toml_version: Literal["1.0.0", "1.1.0"] = "1.0.0",
+) -> dict[str, Any]:
+    _bytes = fp.read()
+    try:
+        _str = _bytes.decode()
+    except AttributeError:
+        msg = "File must be opened in binary mode, e.g. use `open('foo.toml', 'rb')`"
+        raise TypeError(msg) from None
+    return loads(_str, parse_float=parse_float, toml_version=toml_version)
 
 
-def loads(s: str, /, *, parse_float: Callable[[str], Any] = float) -> dict[str, Any]:
+def loads(
+    s: str,
+    /,
+    *,
+    parse_float: Callable[[str], Any] = float,
+    toml_version: Literal["1.0.0", "1.1.0"] = "1.0.0",
+) -> dict[str, Any]:
     if not isinstance(s, str):
-        raise TypeError(f"Expected str object, not '{type(s).__name__}'")
-    return _loads(s, parse_float=parse_float)
+        raise TypeError(f"Expected str object, not '{type(s).__qualname__}'")
+    return _loads(s, parse_float=parse_float, toml_version=toml_version)
+
+
+def dump(
+    obj: Any,
+    /,
+    file: str | Path | TextIO,
+    inline_tables: set[str] | None = None,
+    *,
+    pretty: bool = False,
+    toml_version: Literal["1.0.0", "1.1.0"] = "1.0.0",
+) -> int:
+    _str = _dumps(
+        obj,
+        inline_tables=inline_tables,
+        pretty=pretty,
+        toml_version=toml_version,
+    )
+    if isinstance(file, str):
+        file = Path(file)
+    if isinstance(file, Path):
+        return file.write_text(_str, encoding="utf-8")
+    else:
+        return file.write(_str)
+
+
+def dumps(
+    obj: Any,
+    /,
+    inline_tables: set[str] | None = None,
+    *,
+    pretty: bool = False,
+    toml_version: Literal["1.0.0", "1.1.0"] = "1.0.0",
+) -> str:
+    return _dumps(
+        obj,
+        inline_tables=inline_tables,
+        pretty=pretty,
+        toml_version=toml_version,
+    )
 
 
 class TOMLDecodeError(ValueError):
@@ -41,3 +102,10 @@ class TOMLDecodeError(ValueError):
         self.pos = pos
         self.colno = colno
         self.lineno = lineno
+
+
+class TOMLEncodeError(TypeError):
+    def __init__(self, msg: str, *args: Any):
+        msg = msg.rstrip()
+        super().__init__(msg)
+        self.msg = msg

toml_rs-0.2.0.dist-info/METADATA

@@ -0,0 +1,179 @@
+Metadata-Version: 2.4
+Name: toml-rs
+Version: 0.2.0
+Classifier: Typing :: Typed
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Software Development :: Libraries
+Classifier: License :: OSI Approved :: The Unlicense (Unlicense)
+License-File: UNLICENSE
+Summary: A High-Performance TOML Parser for Python written in Rust
+Author-email: chirizxc <chirizxc@proton.me>
+Maintainer-email: chirizxc <chirizxc@proton.me>
+License-Expression: UNLICENSE
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Source, https://github.com/lava-sh/toml-rs
+Project-URL: Homepage, https://github.com/lava-sh/toml-rs
+Project-URL: Bug Tracker, https://github.com/lava-sh/toml-rs/issues
+
+<div align="center">
+
+# toml-rs
+
+*A High-Performance TOML v1.0.0 and v1.1.0 parser for Python written in Rust*
+
+[![PyPI License](https://img.shields.io/pypi/l/toml_rs.svg?style=flat-square)](https://pypi.org/project/toml_rs/)
+[![Python version](https://img.shields.io/pypi/pyversions/toml_rs.svg?style=flat-square)](https://pypi.org/project/toml_rs/)
+[![Implementation](https://img.shields.io/pypi/implementation/toml_rs.svg?style=flat-square)](https://pypi.org/project/toml_rs/)
+
+[![Monthly downloads](https://img.shields.io/pypi/dm/toml_rs.svg?style=)](https://pypi.org/project/toml_rs/)
+[![Github Repository size](https://img.shields.io/github/repo-size/lava-sh/toml-rs?style=flat-square)](https://github.com/lava-sh/toml-rs)
+
+</div>
+
+## Features
+
+* The fastest TOML parser in Python (see [benchmarks](https://github.com/lava-sh/toml-rs/tree/main/benchmark))
+
+* Drop-in compatibility with most [`tomllib`](https://docs.python.org/3/library/tomllib.html) use cases (see [below](#differences-with-tomllib))
+
+## Installation
+
+```bash
+# Using pip
+pip install toml-rs
+
+# Using uv
+uv pip install toml-rs
+```
+
+## Examples
+
+```python
+import tomllib
+from pprint import pprint
+
+import toml_rs
+
+toml = """\
+title = "TOML Example"
+
+[owner]
+name = "Tom Preston-Werner"
+dob = 1979-05-27T07:32:00-08:00
+
+[database]
+enabled = true
+ports = [ 8000, 8001, 8002 ]
+data = [ ["delta", "phi"], [3.14] ]
+temp_targets = { cpu = 79.5, case = 72.0 }
+
+[servers]
+[servers.alpha]
+ip = "10.0.0.1"
+role = "frontend"
+[servers.beta]
+ip = "10.0.0.2"
+role = "backend"
+"""
+
+tomllib_loads = tomllib.loads(toml)
+toml_rs_loads = toml_rs.loads(toml)
+toml_rs_dumps = toml_rs.dumps(toml_rs_loads)
+
+assert tomllib_loads == toml_rs_loads
+
+print("toml_rs.loads:")
+pprint(toml_rs_loads)
+print("toml_rs.dumps:")
+print(toml_rs_dumps)
+```
+
+## Differences with [`tomllib`](https://docs.python.org/3/library/tomllib.html)
+
+1. More understandable errors
+
+```python
+import tomllib
+
+t = """\
+x = 1
+y = 2
+v = 
+"""
+print(tomllib.loads(t))
+# tomllib.TOMLDecodeError: Invalid value (at line 3, column 5)
+```
+
+```python
+import toml_rs
+
+t = """\
+x = 1
+y = 2
+v = 
+"""
+print(toml_rs.loads(t))
+# toml_rs.TOMLDecodeError: TOML parse error at line 3, column 5
+#   |
+# 3 | v = 
+#   |     ^
+# string values must be quoted, expected literal string
+```
+
+2. Strict compliance with TOML v1.0.0
+
+From [TOML spec](https://toml.io/en/v1.0.0#integer):
+
+> Arbitrary 64-bit signed integers (from `−2^63` to `2^63−1`) should be accepted and handled losslessly. If an integer cannot be represented losslessly, an error must be thrown.
+
+```python
+import tomllib
+
+t = "x = 999_999_999_999_999_999_999_999"
+print(tomllib.loads(t))
+# {'x': 999999999999999999999999} <== speс violation
+```
+
+```python
+import toml_rs
+
+t = "x = 999_999_999_999_999_999_999_999"
+print(toml_rs.loads(t))
+# toml_rs.TOMLDecodeError: TOML parse error at line 1, column 5
+#   |
+# 1 | x = 999_999_999_999_999_999_999_999
+#   |     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+# invalid type: integer `999999999999999999999999` as i128, expected any valid TOML value
+```
+
+Note: TOML v1.1.0 allows parsers to support integers and floats beyond `i64`/`f64` limits,
+ so the behavior will be the same as [`tomllib`](https://docs.python.org/3/library/tomllib.html)
+
+3. Supports serialization (`toml_rs.dumps` and `toml_rs.dump`)
+
+```python
+from pathlib import Path
+
+import toml_rs
+
+data = {
+    "title": "TOML Example",
+    "owner": {"name": "Alice", "age": 30},
+}
+
+print(toml_rs.dumps(data))
+
+toml_rs.dump(data, Path("example.toml"))  
+# or `toml_rs.dump(data, "example.toml")`
+```
+

toml_rs-0.2.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+toml_rs-0.2.0.dist-info/METADATA,sha256=P2_ZcVUcRFAdTXCTMACj0qUcwofqoKhwLjBtA-BzlHE,4928
+toml_rs-0.2.0.dist-info/WHEEL,sha256=kee6LsGytVOkPnxDiMvgzc1PY-2HQL3iJ66h1TyPAyI,98
+toml_rs-0.2.0.dist-info/licenses/UNLICENSE,sha256=pO9SJPWzhoS7yVUh8EuWMlwkAsA9o-yzXiMtgqmWKC8,1233
+toml_rs/__init__.py,sha256=1vith0RH50xfp86FqY_Nrd5idD_9WgieLSBXeu4-mtw,2687
+toml_rs/_toml_rs.cp314t-win_amd64.pyd,sha256=r_M6V1ekPugzdNLR_gWLWjw2h1g9AeK4Nu8zB-GzT2A,894464
+toml_rs/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+toml_rs-0.2.0.dist-info/RECORD,,

{toml_rs-0.0.6.dist-info → toml_rs-0.2.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: maturin (1.9.6)
+Generator: maturin (1.10.2)
 Root-Is-Purelib: false
 Tag: cp314-cp314t-win_amd64

toml_rs-0.0.6.dist-info/METADATA

@@ -1,84 +0,0 @@
-Metadata-Version: 2.4
-Name: toml-rs
-Version: 0.0.6
-Classifier: Typing :: Typed
-Classifier: Programming Language :: Rust
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Programming Language :: Python :: Implementation :: PyPy
-Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: Topic :: Software Development :: Libraries
-Classifier: License :: OSI Approved :: The Unlicense (Unlicense)
-License-File: UNLICENSE
-Summary: A High-Performance TOML Parser for Python written in Rust
-Author-email: chirizxc <chirizxc@proton.me>
-Maintainer-email: chirizxc <chirizxc@proton.me>
-License-Expression: UNLICENSE
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
-Project-URL: Source, https://github.com/lava-sh/toml-rs
-Project-URL: Homepage, https://github.com/lava-sh/toml-rs
-Project-URL: Bug Tracker, https://github.com/lava-sh/toml-rs/issues
-
-# `toml-rs` — A High-Performance TOML Parser for Python written in Rust
-
-## Features
-
-• The fastest TOML parser in Python (see [benchmarks](https://github.com/lava-sh/toml-rs/tree/main/benchmark))
-
-• Drop-in compatibility with most [`tomllib`](https://docs.python.org/3/library/tomllib.html) use cases
-
-## Installation
-```bash
-# Using pip
-pip install toml-rs
-
-# Using uv
-uv pip install toml-rs
-```
-
-## Examples
-```python
-from pprint import pprint
-
-import toml_rs
-import tomllib
-
-toml = """\
-title = "TOML Example"
-
-[owner]
-name = "Tom Preston-Werner"
-dob = 1979-05-27T07:32:00-08:00
-
-[database]
-enabled = true
-ports = [ 8000, 8001, 8002 ]
-data = [ ["delta", "phi"], [3.14] ]
-temp_targets = { cpu = 79.5, case = 72.0 }
-
-[servers]
-[servers.alpha]
-ip = "10.0.0.1"
-role = "frontend"
-[servers.beta]
-ip = "10.0.0.2"
-role = "backend"
-"""
-
-tomllib_loads = tomllib.loads(toml)
-toml_rs_loads = toml_rs.loads(toml)
-
-assert tomllib_loads == toml_rs_loads
-
-print("tomllib:")
-pprint(tomllib_loads)
-print("toml_rs:")
-pprint(toml_rs_loads)
-```
-

toml_rs-0.0.6.dist-info/RECORD

@@ -1,7 +0,0 @@
-toml_rs-0.0.6.dist-info/METADATA,sha256=HbODFJ90NPcc4tEBGJ1ZzK1Wx3Syu7pIKCLuP9k7kes,2306
-toml_rs-0.0.6.dist-info/WHEEL,sha256=DyJBVhA1hlR1K33J-EVD6hJjYEhlXPD8lNx9_PF41TU,97
-toml_rs-0.0.6.dist-info/licenses/UNLICENSE,sha256=pO9SJPWzhoS7yVUh8EuWMlwkAsA9o-yzXiMtgqmWKC8,1233
-toml_rs/__init__.py,sha256=NIiAfcSc1whF7NT0jfypUpEACbx4_yfP1PATASZiQi8,1113
-toml_rs/_toml_rs.cp314t-win_amd64.pyd,sha256=gYGCABtAVcfcCmyHM2dGDmPh9xtMM9NuUNhg0iE5sQ4,517120
-toml_rs/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-toml_rs-0.0.6.dist-info/RECORD,,