fastsimdjson 0.1.0__tar.gz → 0.2.0__tar.gz

{fastsimdjson-0.1.0 → fastsimdjson-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastsimdjson
-Version: 0.1.0
+Version: 0.2.0
 Summary: Fast JSON parsing for Python, built on simdjson
 Author-email: Daniel Lemire <daniel@lemire.me>
 License-Expression: Apache-2.0
@@ -46,6 +46,36 @@ the exception is re-raised with Python's message and byte position. Any other
 exception from `json.loads` propagates. `release()` frees the simdjson parser
 and the string caches kept by the calling thread.
 
+## Lazy parsing
+
+When you need only part of a document, `parse` avoids building the rest.
+It accepts the same inputs as `loads` and returns read-only views:
+`fastsimdjson.Object` (a `Mapping`) and `fastsimdjson.Array` (a
+`Sequence`). Values are converted when you access them; nested objects and
+arrays are returned as views. A scalar root is returned as a plain value.
+
+```python
+doc = fastsimdjson.parse(open("twitter.json", "rb").read())
+ids = [(s["id"], s["user"]["screen_name"]) for s in doc["statuses"]]
+doc.at_pointer("/statuses/0/user/name")   # JSON Pointer (RFC 6901)
+doc["search_metadata"].as_dict()          # convert a subtree, like loads
+```
+
+`Object` supports `obj[key]`, `get`, `in`, `len`, iteration over the keys,
+`keys()`, `values()`, `items()` (iterators), `at_pointer` and `as_dict()`.
+`Array` supports `arr[i]` (negative indexes and slices), `len`, iteration,
+`at_pointer` and `as_list()`. Both work with `match` statements.
+
+* A view keeps its document alive; the document owns its own buffers, so
+  it remains valid while other documents are parsed.
+* A key lookup scans the object. With duplicate keys, lookups return the
+  first value, whereas `as_dict()` (like `json.loads`) keeps the last.
+* Indexing an array walks it from the last index reached, so a loop over
+  `arr[i]` is linear; iteration is the fastest way to visit an array.
+* A document that simdjson rejects but `json.loads` accepts (an overflowing
+  number, an unpaired surrogate) is returned as plain Python objects, as
+  `loads` would return it.
+
 ## How it works
 
 1. simdjson's DOM parser (with runtime CPU dispatch: AVX-512, AVX2, SSE4.2, ...)
@@ -79,7 +109,7 @@ accepts it, so `loads` returns that string. A leading UTF-8 BOM is accepted.
 
 ## Build and test
 
-Python 3.10 or newer, and a C++17 compiler (clang or GCC). The simdjson 5.0.1
+Python 3.10 or newer, and a C++17 compiler (clang, GCC or MSVC). The simdjson 5.0.2
 and simdutf 9.2.1 amalgamations are already in `vendor/`.
 
 pip:

{fastsimdjson-0.1.0 → fastsimdjson-0.2.0}/README.md

@@ -18,6 +18,36 @@ the exception is re-raised with Python's message and byte position. Any other
 exception from `json.loads` propagates. `release()` frees the simdjson parser
 and the string caches kept by the calling thread.
 
+## Lazy parsing
+
+When you need only part of a document, `parse` avoids building the rest.
+It accepts the same inputs as `loads` and returns read-only views:
+`fastsimdjson.Object` (a `Mapping`) and `fastsimdjson.Array` (a
+`Sequence`). Values are converted when you access them; nested objects and
+arrays are returned as views. A scalar root is returned as a plain value.
+
+```python
+doc = fastsimdjson.parse(open("twitter.json", "rb").read())
+ids = [(s["id"], s["user"]["screen_name"]) for s in doc["statuses"]]
+doc.at_pointer("/statuses/0/user/name")   # JSON Pointer (RFC 6901)
+doc["search_metadata"].as_dict()          # convert a subtree, like loads
+```
+
+`Object` supports `obj[key]`, `get`, `in`, `len`, iteration over the keys,
+`keys()`, `values()`, `items()` (iterators), `at_pointer` and `as_dict()`.
+`Array` supports `arr[i]` (negative indexes and slices), `len`, iteration,
+`at_pointer` and `as_list()`. Both work with `match` statements.
+
+* A view keeps its document alive; the document owns its own buffers, so
+  it remains valid while other documents are parsed.
+* A key lookup scans the object. With duplicate keys, lookups return the
+  first value, whereas `as_dict()` (like `json.loads`) keeps the last.
+* Indexing an array walks it from the last index reached, so a loop over
+  `arr[i]` is linear; iteration is the fastest way to visit an array.
+* A document that simdjson rejects but `json.loads` accepts (an overflowing
+  number, an unpaired surrogate) is returned as plain Python objects, as
+  `loads` would return it.
+
 ## How it works
 
 1. simdjson's DOM parser (with runtime CPU dispatch: AVX-512, AVX2, SSE4.2, ...)
@@ -51,7 +81,7 @@ accepts it, so `loads` returns that string. A leading UTF-8 BOM is accepted.
 
 ## Build and test
 
-Python 3.10 or newer, and a C++17 compiler (clang or GCC). The simdjson 5.0.1
+Python 3.10 or newer, and a C++17 compiler (clang, GCC or MSVC). The simdjson 5.0.2
 and simdutf 9.2.1 amalgamations are already in `vendor/`.
 
 pip:

{fastsimdjson-0.1.0 → fastsimdjson-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "fastsimdjson"
-version = "0.1.0"
+version = "0.2.0"
 description = "Fast JSON parsing for Python, built on simdjson"
 readme = "README.md"
 authors = [