toml-rs 0.0.13__cp310-cp310-win_amd64.whl

toml_rs/__init__.py

@@ -0,0 +1,74 @@
+__all__ = (
+    "TOMLDecodeError",
+    "TOMLEncodeError",
+    "__version__",
+    "dump",
+    "dumps",
+    "load",
+    "loads",
+)
+
+from collections.abc import Callable
+from pathlib import Path
+from typing import Any, BinaryIO, TextIO
+
+from ._toml_rs import (
+    _dumps,
+    _loads,
+    _version,
+)
+
+__version__: str = _version
+
+
+def load(fp: BinaryIO, /, *, parse_float: Callable[[str], Any] = float) -> 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)
+
+
+def loads(s: str, /, *, parse_float: Callable[[str], Any] = float) -> 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)
+
+
+def dump(obj: Any, /, file: str | Path | TextIO, *, pretty: bool = False) -> int:
+    s = _dumps(obj, pretty=pretty)
+    if isinstance(file, str):
+        file = Path(file)
+    if isinstance(file, Path):
+        return file.write_text(s, encoding="utf-8")
+    else:
+        return file.write(s)
+
+
+def dumps(obj: Any, /, *, pretty: bool = False) -> str:
+    return _dumps(obj, pretty=pretty)
+
+
+class TOMLDecodeError(ValueError):
+    def __init__(self, msg: str, doc: str, pos: int, *args: Any):
+        msg = msg.rstrip()
+        super().__init__(msg)
+        lineno = doc.count("\n", 0, pos) + 1
+        if lineno == 1:
+            colno = pos + 1
+        else:
+            colno = pos - doc.rindex("\n", 0, pos)
+        self.msg = msg
+        self.doc = doc
+        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.0.13.dist-info/METADATA

@@ -0,0 +1,158 @@
+Metadata-Version: 2.4
+Name: toml-rs
+Version: 0.0.13
+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 (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
+```
+
+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.0.13.dist-info/RECORD

@@ -0,0 +1,7 @@
+toml_rs-0.0.13.dist-info/METADATA,sha256=8z59j2YAyvRB7wuPkN8Z3dXRYmoS-xp9MApbcqm_Imk,4049
+toml_rs-0.0.13.dist-info/WHEEL,sha256=EzedEmBOXE1tNSzXszfrmtdogTWmygt86emP3GfIvPc,96
+toml_rs-0.0.13.dist-info/licenses/UNLICENSE,sha256=pO9SJPWzhoS7yVUh8EuWMlwkAsA9o-yzXiMtgqmWKC8,1233
+toml_rs/__init__.py,sha256=QWnz3ay-gZAPI_mnxsiOzcIiG2uMKt_zfTGS_24H050,1998
+toml_rs/_toml_rs.cp310-win_amd64.pyd,sha256=5lSEy5H3ncr5tL2eMzCbiuSrEqNiRwtnlUyCf8UEFlA,595456
+toml_rs/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+toml_rs-0.0.13.dist-info/RECORD,,

toml_rs-0.0.13.dist-info/WHEEL

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

toml_rs-0.0.13.dist-info/licenses/UNLICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <http://unlicense.org/>