dotted-notation 0.44.9__tar.gz → 0.44.11__tar.gz

{dotted_notation-0.44.9 → dotted_notation-0.44.11}/CHANGELOG.md

@@ -3,6 +3,46 @@
 All notable changes to `dotted` are recorded here. Versions prior to
 the ones listed are omitted — browse git history for earlier entries.
 
+## [0.44.11]
+
+### Changed
+- `build()` copies its leaves with the standard library's
+  `copy.deepcopy` even when copium is installed. copium 0.1.0 gets slow
+  at small copies once it has copied something large in the same
+  process ([copium#54](https://github.com/percolab/copium/issues/54)),
+  which made `build` slower with the extra than without it. copium is
+  still used for the whole-object copy made by `mutable=False`.
+
+## [0.44.10]
+
+### Performance
+- `build()` and `build_multi()` keep the parsed paths they expand
+  instead of assembling each one to a string and parsing it again. A
+  pattern matching more paths than the parse cache holds (300) used to
+  miss on every one; `build` over 1000 matches is about 35x faster.
+
+### Changed
+- Three edge cases of `build()` change with the string round trip gone:
+  with `strict=True`, a trailing `[]` or `[:]` now creates the empty
+  list where it was a no-op, and raises `TypeError` on a list root; a
+  wildcard over keys that cannot be written as a path, such as `None` or
+  `True`, now succeeds where it raised `AttributeError`.
+
+### Added
+- Benchmark suite: `python -m benchmarks` or `make bench`. Times reads
+  and writes at two data sizes, and the copying cases under both
+  `copy.deepcopy` and copium. Results can be saved and compared.
+
+### Fixed
+- `make` targets failed because the install rule depended on
+  `setup.py`, removed in the move to `pyproject.toml`.
+
+### Documentation
+- README caveat for the `copium` extra: copium 0.1.0 gets slower at
+  copying small objects once it has copied a large one in the same
+  process. Reported upstream as
+  [copium#54](https://github.com/percolab/copium/issues/54).
+
 ## [0.44.9]
 
 ### Performance

{dotted_notation-0.44.9/dotted_notation.egg-info → dotted_notation-0.44.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dotted_notation
-Version: 0.44.9
+Version: 0.44.11
 Summary: Dotted notation for safe nested data traversal with optional chaining, pattern matching, and transforms
 Author-email: Frey Waid <logophage1@gmail.com>
 License: MIT
@@ -83,6 +83,12 @@ For faster `mutable=False` updates and removes, install the
 
     pip install dotted-notation[copium]
 
+> **Caveat (copium 0.1.0):** after copium copies a large object, its copies of
+> small objects in the same process become slower than `copy.deepcopy` and stay
+> that way. Copying whole documents is 3-9x faster, but a long-running process
+> that mixes one large copy with many small ones can come out slower overall.
+> Tracked upstream in [copium#54](https://github.com/percolab/copium/issues/54).
+
 ## Table of Contents
 
 - [Safe Traversal (Optional Chaining)](#safe-traversal-optional-chaining)

{dotted_notation-0.44.9 → dotted_notation-0.44.11}/README.md

@@ -37,6 +37,12 @@ For faster `mutable=False` updates and removes, install the
 
     pip install dotted-notation[copium]
 
+> **Caveat (copium 0.1.0):** after copium copies a large object, its copies of
+> small objects in the same process become slower than `copy.deepcopy` and stay
+> that way. Copying whole documents is 3-9x faster, but a long-running process
+> that mixes one large copy with many small ones can come out slower overall.
+> Tracked upstream in [copium#54](https://github.com/percolab/copium/issues/54).
+
 ## Table of Contents
 
 - [Safe Traversal (Optional Chaining)](#safe-traversal-optional-chaining)

{dotted_notation-0.44.9 → dotted_notation-0.44.11}/dotted/api.py

@@ -396,6 +396,23 @@ _mutable = mutable
 is_mutable = mutable
 
 
+def _pluck_parsed(obj, ops, strict=False):
+    """
+    Yield deduped (parsed path, value) pairs from obj matching `ops`.
+    Like pluck_multi, but the paths stay parsed so callers that hand them
+    straight back to dotted skip the assemble and re-parse.
+    """
+    seen = set()
+    for path, val in engine.walk(ops, obj, paths=True, strict=strict):
+        if path is utypes.CUT_SENTINEL:
+            break
+        found = results.Dotted({'ops': path, 'transforms': ops.transforms})
+        if found in seen:
+            continue
+        seen.add(found)
+        yield (found, val)
+
+
 def build_multi(obj, paths, strict=False, bindings=None):
     """
     Build a subset/default obj based on concrete path fields
@@ -406,8 +423,9 @@ def build_multi(obj, paths, strict=False, bindings=None):
     if obj is AUTO:
         obj = _auto_root(((p, None) for p in paths))
     for path in paths:
-        built = engine.build(parse(path, bindings=bindings, partial=False), obj, strict=strict)
-        obj = update_multi(obj, pluck_multi(built, (path,), strict=strict), strict=strict)
+        ops = parse(path, bindings=bindings, partial=False)
+        built = engine.build(ops, obj, strict=strict)
+        obj = update_multi(obj, _pluck_parsed(built, ops, strict=strict), strict=strict)
     return obj
 
 

{dotted_notation-0.44.9 → dotted_notation-0.44.11}/dotted/engine.py

@@ -3,10 +3,10 @@ Traversal engine for dotted path operations.
 
 Core traversal functions (walk, gets, updates, removes, expands).
 """
+import copy
 
 from . import base
 from . import matchers
-from . import utils
 from . import wrappers
 from .access import Attr, Slot
 from .results import Dotted
@@ -42,7 +42,9 @@ def build(ops, node, deepcopy=True, **kwargs):
     built = node.__class__()
     for k,v in cur.items(node, **kwargs):
         if not ops:
-            built = cur.update(built, k, utils.deepcopy(v) if deepcopy else v)
+            # stdlib copy, not utils.deepcopy: copium gets slow at small
+            # copies like these after a large one (percolab/copium#54)
+            built = cur.update(built, k, copy.deepcopy(v) if deepcopy else v)
         else:
             built = cur.update(built, k, build(ops, v, deepcopy=deepcopy, **kwargs))
     return built or build_default([cur]+ops)

{dotted_notation-0.44.9 → dotted_notation-0.44.11/dotted_notation.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dotted_notation
-Version: 0.44.9
+Version: 0.44.11
 Summary: Dotted notation for safe nested data traversal with optional chaining, pattern matching, and transforms
 Author-email: Frey Waid <logophage1@gmail.com>
 License: MIT
@@ -83,6 +83,12 @@ For faster `mutable=False` updates and removes, install the
 
     pip install dotted-notation[copium]
 
+> **Caveat (copium 0.1.0):** after copium copies a large object, its copies of
+> small objects in the same process become slower than `copy.deepcopy` and stay
+> that way. Copying whole documents is 3-9x faster, but a long-running process
+> that mixes one large copy with many small ones can come out slower overall.
+> Tracked upstream in [copium#54](https://github.com/percolab/copium/issues/54).
+
 ## Table of Contents
 
 - [Safe Traversal (Optional Chaining)](#safe-traversal-optional-chaining)

{dotted_notation-0.44.9 → dotted_notation-0.44.11}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dotted_notation"
-version = "0.44.9"
+version = "0.44.11"
 description = "Dotted notation for safe nested data traversal with optional chaining, pattern matching, and transforms"
 readme = "README.md"
 requires-python = ">=3.6"