j-perm 0.2.1.1__py3-none-any.whl → 0.2.3__py3-none-any.whl

j_perm/constructs/ref.py

@@ -4,17 +4,16 @@ import copy
 from typing import Mapping, Any
 
 from ..special_resolver import _MISSING, SpecialRegistry
-from ..utils.pointers import maybe_slice
 
 
 @SpecialRegistry.register("$ref")
 def of_ref(node: Mapping[str, Any], src: Mapping[str, Any], engine: "ActionEngine") -> Any:
     # Expand templates inside "$ref" using configured substitutor
-    ptr = engine.substitutor.substitute(node["$ref"], src)
+    ptr = engine.substitutor.substitute(node["$ref"], src, engine)
 
     dflt = node.get("$default", _MISSING)
     try:
-        return copy.deepcopy(maybe_slice(ptr, src))
+        return copy.deepcopy(engine.pointer_manager.maybe_slice(ptr, src))
     except Exception:
         if dflt is not _MISSING:
             return copy.deepcopy(dflt)

j_perm/engine.py

@@ -6,6 +6,7 @@ from typing import Any, List, Mapping, TypeAlias, MutableMapping, Union
 
 from .normalizer import Normalizer
 from .op_handler import Handlers
+from .pointers import PointerManager
 from .special_resolver import SpecialResolver
 from .subst import TemplateSubstitutor
 
@@ -48,6 +49,9 @@ class ActionEngine:
     special: SpecialResolver = field(default_factory=SpecialResolver)
     substitutor: TemplateSubstitutor = field(default_factory=TemplateSubstitutor)
     normalizer: Normalizer = field(default_factory=Normalizer)
+    pointer_manager: PointerManager = field(default_factory=PointerManager)
+
+    max_depth: int = 50
 
     def apply_actions(
             self,

j_perm/normalizer.py

@@ -19,6 +19,7 @@ class ShorthandRegistry:
             cls._rules[name] = fn
             cls._default_priority[name] = priority
             return fn
+
         return deco
 
     @classmethod

j_perm/ops/_assert.py

@@ -3,7 +3,6 @@ from __future__ import annotations
 from typing import MutableMapping, Any, Mapping
 
 from ..op_handler import OpRegistry
-from ..utils.pointers import jptr_get
 
 
 @OpRegistry.register("assert")
@@ -14,10 +13,10 @@ def op_assert(
         engine: "ActionEngine",
 ) -> MutableMapping[str, Any]:
     """Assert node existence and/or value at JSON Pointer path in dest."""
-    path = engine.substitutor.substitute(step["path"], src)
+    path = engine.substitutor.substitute(step["path"], src, engine)
 
     try:
-        current = jptr_get(src, path)
+        current = engine.pointer_manager.get_pointer(src, path)
     except Exception:
         raise AssertionError(f"'{path}' does not exist in source")
 

j_perm/ops/_assert_d.py

@@ -3,7 +3,6 @@ from __future__ import annotations
 from typing import MutableMapping, Any, Mapping
 
 from ..op_handler import OpRegistry
-from ..utils.pointers import jptr_get
 
 
 @OpRegistry.register("assertD")
@@ -14,10 +13,10 @@ def op_assert_d(
         engine: "ActionEngine",
 ) -> MutableMapping[str, Any]:
     """Assert node existence and/or value at JSON Pointer path in dest."""
-    path = engine.substitutor.substitute(step["path"], dest)
+    path = engine.substitutor.substitute(step["path"], dest, engine)
 
     try:
-        current = jptr_get(dest, path)
+        current = engine.pointer_manager.get_pointer(dest, path)
     except Exception:
         raise AssertionError(f"'{path}' does not exist in destination")
 

j_perm/ops/_exec.py

@@ -3,7 +3,6 @@ from __future__ import annotations
 from typing import MutableMapping, Any, Mapping
 
 from ..op_handler import OpRegistry
-from ..utils.pointers import maybe_slice
 
 
 @OpRegistry.register("exec")
@@ -24,20 +23,20 @@ def op_exec(
         raise ValueError("exec operation requires either 'from' or 'actions' parameter")
 
     if has_from:
-        actions_ptr = engine.substitutor.substitute(step["from"], src)
+        actions_ptr = engine.substitutor.substitute(step["from"], src, engine)
         try:
-            actions = maybe_slice(actions_ptr, src)
+            actions = engine.pointer_manager.maybe_slice(actions_ptr, src)
         except Exception:
             if "default" in step:
                 actions = engine.special.resolve(step["default"], src, engine)
                 if isinstance(actions, (str, list, dict)):
-                    actions = engine.substitutor.substitute(actions, src)
+                    actions = engine.substitutor.substitute(actions, src, engine)
             else:
                 raise ValueError(f"Cannot find actions at {actions_ptr}")
     else:
         actions = engine.special.resolve(step["actions"], src, engine)
         if isinstance(actions, (str, list, dict)):
-            actions = engine.substitutor.substitute(actions, src)
+            actions = engine.substitutor.substitute(actions, src, engine)
 
     merge = bool(step.get("merge", False))
 

j_perm/ops/_if.py

@@ -4,7 +4,6 @@ import copy
 from typing import MutableMapping, Any, Mapping
 
 from ..op_handler import OpRegistry
-from ..utils.pointers import maybe_slice
 
 
 @OpRegistry.register("if")
@@ -17,22 +16,22 @@ def op_if(
     """Conditionally execute nested actions based on a path or expression."""
     if "path" in step:
         try:
-            ptr = engine.substitutor.substitute(step["path"], src)
-            current = maybe_slice(ptr, dest)
+            ptr = engine.substitutor.substitute(step["path"], src, engine)
+            current = engine.pointer_manager.maybe_slice(ptr, dest)
             missing = False
         except Exception:
             current = None
             missing = True
 
         if "equals" in step:
-            expected = engine.substitutor.substitute(step["equals"], src)
+            expected = engine.substitutor.substitute(step["equals"], src, engine)
             cond_val = current == expected and not missing
         elif step.get("exists"):
             cond_val = not missing
         else:
             cond_val = bool(current) and not missing
     else:
-        raw_cond = engine.substitutor.substitute(step.get("cond"), src)
+        raw_cond = engine.substitutor.substitute(step.get("cond"), src, engine)
         cond_val = bool(raw_cond)
 
     branch_key = "then" if cond_val else "else"

j_perm/ops/copy.py

@@ -5,7 +5,6 @@ from typing import MutableMapping, Any, Mapping
 
 from .set import op_set
 from ..op_handler import OpRegistry
-from ..utils.pointers import maybe_slice
 
 
 @OpRegistry.register("copy")
@@ -16,15 +15,15 @@ def op_copy(
         engine: "ActionEngine",
 ) -> MutableMapping[str, Any]:
     """Copy value from source pointer into dest path."""
-    path = engine.substitutor.substitute(step["path"], src)
+    path = engine.substitutor.substitute(step["path"], src, engine)
     create = bool(step.get("create", True))
     extend_list = bool(step.get("extend", True))
 
-    ptr = engine.substitutor.substitute(step["from"], src)
+    ptr = engine.substitutor.substitute(step["from"], src, engine)
     ignore = bool(step.get("ignore_missing", False))
 
     try:
-        value = copy.deepcopy(maybe_slice(ptr, src))
+        value = copy.deepcopy(engine.pointer_manager.maybe_slice(ptr, src))
     except Exception:
         if "default" in step:
             value = copy.deepcopy(step["default"])

j_perm/ops/copy_d.py

@@ -5,7 +5,6 @@ from typing import MutableMapping, Any, Mapping
 
 from .set import op_set
 from ..op_handler import OpRegistry
-from ..utils.pointers import maybe_slice
 
 
 @OpRegistry.register("copyD")
@@ -16,14 +15,14 @@ def op_copy_d(
         engine: "ActionEngine",
 ) -> MutableMapping[str, Any]:
     """Copy value from dest (self) into another dest path."""
-    path = engine.substitutor.substitute(step["path"], src)
+    path = engine.substitutor.substitute(step["path"], src, engine)
     create = bool(step.get("create", True))
 
-    ptr = engine.substitutor.substitute(step["from"], dest)
+    ptr = engine.substitutor.substitute(step["from"], dest, engine)
     ignore = bool(step.get("ignore_missing", False))
 
     try:
-        value = copy.deepcopy(maybe_slice(ptr, dest))
+        value = copy.deepcopy(engine.pointer_manager.maybe_slice(ptr, dest))
     except Exception:
         if "default" in step:
             value = copy.deepcopy(step["default"])

j_perm/ops/delete.py

@@ -3,7 +3,6 @@ from __future__ import annotations
 from typing import MutableMapping, Any, Mapping
 
 from ..op_handler import OpRegistry
-from ..utils.pointers import jptr_ensure_parent
 
 
 @OpRegistry.register("delete")
@@ -14,11 +13,11 @@ def op_delete(
         engine: "ActionEngine",
 ) -> MutableMapping[str, Any]:
     """Delete node at the given JSON Pointer path in dest."""
-    path = engine.substitutor.substitute(step["path"], src)
+    path = engine.substitutor.substitute(step["path"], src, engine)
     ignore = bool(step.get("ignore_missing", True))
 
     try:
-        parent, leaf = jptr_ensure_parent(dest, path, create=False)
+        parent, leaf = engine.pointer_manager.ensure_parent(dest, path, create=False)
 
         if leaf == "-":
             raise ValueError("'-' not allowed in delete")

j_perm/ops/distinct.py

@@ -3,7 +3,6 @@ from __future__ import annotations
 from typing import MutableMapping, Any, Mapping
 
 from ..op_handler import OpRegistry
-from ..utils.pointers import jptr_get
 
 
 @OpRegistry.register("distinct")
@@ -14,20 +13,20 @@ def op_distinct(
         engine: "ActionEngine",
 ) -> MutableMapping[str, Any]:
     """Remove duplicates from a list at the given path, preserving order."""
-    path = engine.substitutor.substitute(step["path"], src)
-    lst = jptr_get(dest, path)
+    path = engine.substitutor.substitute(step["path"], src, engine)
+    lst = engine.pointer_manager.get_pointer(dest, path)
 
     if not isinstance(lst, list):
         raise TypeError(f"{path} is not a list (distinct)")
 
     key = step.get("key", None)
-    key_path = engine.substitutor.substitute(key, src)
+    key_path = engine.substitutor.substitute(key, src, engine)
 
     seen = set()
     unique = []
     for item in lst:
         if key is not None:
-            filter_item = jptr_get(item, key_path)
+            filter_item = engine.pointer_manager.get_pointer(item, key_path)
         else:
             filter_item = item
 

j_perm/ops/foreach.py

@@ -4,7 +4,6 @@ import copy
 from typing import MutableMapping, Any, Mapping
 
 from ..op_handler import OpRegistry
-from ..utils.pointers import maybe_slice
 
 
 @OpRegistry.register("foreach")
@@ -15,13 +14,13 @@ def op_foreach(
         engine: "ActionEngine",
 ) -> MutableMapping[str, Any]:
     """Iterate over array in source and execute nested actions for each element."""
-    arr_ptr = engine.substitutor.substitute(step["in"], src)
+    arr_ptr = engine.substitutor.substitute(step["in"], src, engine)
 
     default = copy.deepcopy(step.get("default", []))
     skip_empty = bool(step.get("skip_empty", True))
 
     try:
-        arr = maybe_slice(arr_ptr, src)
+        arr = engine.pointer_manager.maybe_slice(arr_ptr, src)
     except Exception:
         arr = default
 

j_perm/ops/replace_root.py

@@ -10,5 +10,5 @@ def op_replace_root(step, dest, src, engine):
     """Replace the whole dest root value with the resolved special value."""
     value = engine.special.resolve(step["value"], src, engine)
     if isinstance(value, (str, list, dict)):
-        value = engine.substitutor.substitute(value, src)
+        value = engine.substitutor.substitute(value, src, engine)
     return copy.deepcopy(value)

j_perm/ops/set.py

@@ -3,7 +3,6 @@ from __future__ import annotations
 from typing import Any, Mapping, MutableMapping
 
 from ..op_handler import OpRegistry
-from ..utils.pointers import jptr_ensure_parent
 
 
 @OpRegistry.register("set")
@@ -14,20 +13,20 @@ def op_set(
         engine: "ActionEngine",
 ) -> MutableMapping[str, Any]:
     """Set or append a value at JSON Pointer path in dest."""
-    path = engine.substitutor.substitute(step["path"], src)
+    path = engine.substitutor.substitute(step["path"], src, engine)
     create = bool(step.get("create", True))
     extend_list = bool(step.get("extend", True))
 
     value = engine.special.resolve(step["value"], src, engine)
     if isinstance(value, (str, list, Mapping)):
-        value = engine.substitutor.substitute(value, src)
+        value = engine.substitutor.substitute(value, src, engine)
 
-    parent, leaf = jptr_ensure_parent(dest, path, create=create)
+    parent, leaf = engine.pointer_manager.ensure_parent(dest, path, create=create)
 
     if leaf == "-":
         if not isinstance(parent, list):
             if create:
-                grand, last = jptr_ensure_parent(dest, path.rsplit("/", 1)[0], create=True)
+                grand, last = engine.pointer_manager.ensure_parent(dest, path.rsplit("/", 1)[0], create=True)
                 if not isinstance(grand[last], list):
                     if grand[last] == {}:
                         grand[last] = []

j_perm/ops/update.py

@@ -4,7 +4,6 @@ import copy
 from typing import MutableMapping, Any, Mapping
 
 from ..op_handler import OpRegistry
-from ..utils.pointers import maybe_slice, jptr_ensure_parent
 
 
 @OpRegistry.register("update")
@@ -15,14 +14,14 @@ def op_update(
         engine: "ActionEngine",
 ) -> MutableMapping[str, Any]:
     """Update a mapping at the given path using a mapping from source or inline value."""
-    path = engine.substitutor.substitute(step["path"], src)
+    path = engine.substitutor.substitute(step["path"], src, engine)
     create = bool(step.get("create", True))
     deep = bool(step.get("deep", False))
 
     if "from" in step:
-        ptr = engine.substitutor.substitute(step["from"], src)
+        ptr = engine.substitutor.substitute(step["from"], src, engine)
         try:
-            update_value = copy.deepcopy(maybe_slice(ptr, src))
+            update_value = copy.deepcopy(engine.pointer_manager.maybe_slice(ptr, src))
         except Exception:
             if "default" in step:
                 update_value = copy.deepcopy(step["default"])
@@ -31,7 +30,7 @@ def op_update(
     elif "value" in step:
         update_value = engine.special.resolve(step["value"], src, engine)
         if isinstance(update_value, (str, list, Mapping)):
-            update_value = engine.substitutor.substitute(update_value, src)
+            update_value = engine.substitutor.substitute(update_value, src, engine)
     else:
         raise ValueError("update operation requires either 'from' or 'value' parameter")
 

j_perm/pointers.py

@@ -0,0 +1,107 @@
+from __future__ import annotations
+
+import re
+from typing import Any, Mapping, MutableMapping, List, Tuple
+
+
+class PointerManager:
+    _SLICE_RE = re.compile(r"(.+)\[(-?\d*):(-?\d*)]$")
+
+    def _decode(self, tok: str) -> str:
+        """Decode a single JSON Pointer token, handling RFC6901-style escapes."""
+        return (
+            tok.replace("~0", "~")
+            .replace("~1", "/")
+            .replace("~2", "$")
+            .replace("~3", ".")
+        )
+
+    def get_pointer(self, doc: Any, ptr: str) -> Any:
+        """Read value by JSON Pointer, supporting root and '..' segments."""
+        if ptr in ("", "/", "."):
+            return doc
+
+        tokens = ptr.lstrip("/").split("/")
+        cur: Any = doc
+        parents: List[Tuple[Any, Any]] = []
+
+        for raw_tok in tokens:
+            if raw_tok == "..":
+                if parents:
+                    cur, _ = parents.pop()
+                else:
+                    cur = doc
+                continue
+
+            key = self._decode(raw_tok)
+
+            if isinstance(cur, (list, tuple)):
+                idx = int(key)
+                parents.append((cur, idx))
+                cur = cur[idx]
+            else:
+                parents.append((cur, key))
+                cur = cur[key]
+
+        return cur
+
+    def maybe_slice(self, ptr: str, src: Mapping[str, Any]) -> Any:
+        """Resolve a pointer and optional Python-style slice suffix '[start:end]' for arrays."""
+        m = self._SLICE_RE.match(ptr)
+        if m:
+            base, s, e = m.groups()
+            seq = self.get_pointer(src, base)
+            if not isinstance(seq, (list, tuple)):
+                raise TypeError(f"{base} is not a list (slice requested)")
+
+            start = int(s) if s else None
+            end = int(e) if e else None
+            return seq[start:end]
+
+        return self.get_pointer(src, ptr)
+
+    def ensure_parent(
+            self,
+            doc: MutableMapping[str, Any],
+            ptr: str,
+            *,
+            create: bool = False,
+    ):
+        """Return (container, leaf_key) for ptr, optionally creating intermediate nodes."""
+        raw_parts = ptr.lstrip("/").split("/")
+        parts: List[str] = []
+
+        for raw in raw_parts:
+            if raw == "..":
+                if parts:
+                    parts.pop()
+                continue
+            parts.append(raw)
+
+        if not parts:
+            return doc, ""
+
+        cur: Any = doc
+
+        for raw in parts[:-1]:
+            token = self._decode(raw)
+
+            if isinstance(cur, list):
+                idx = int(token)
+                if idx >= len(cur):
+                    if create:
+                        while idx >= len(cur):
+                            cur.append({})
+                    else:
+                        raise IndexError(f"{ptr}: index {idx} out of range")
+                cur = cur[idx]
+            else:
+                if token not in cur:
+                    if create:
+                        cur[token] = {}
+                    else:
+                        raise KeyError(f"{ptr}: missing key '{token}'")
+                cur = cur[token]
+
+        leaf = self._decode(parts[-1])
+        return cur, leaf

j_perm/subst.py

@@ -1,6 +1,5 @@
 from __future__ import annotations
 
-import copy
 import json
 from dataclasses import dataclass, field
 from typing import Any, Callable, Mapping
@@ -8,8 +7,6 @@ from typing import Any, Callable, Mapping
 import jmespath
 from jmespath import functions as _jp_funcs
 
-from j_perm.utils.pointers import maybe_slice
-
 # =============================================================================
 # Types
 # =============================================================================
@@ -186,21 +183,30 @@ class TemplateSubstitutor:
     # Public API
     # -------------------------------------------------------------------------
 
-    def substitute(self, obj: Any, data: Mapping[str, Any]) -> Any:
-        return self.deep_substitute(obj, data)
+    def substitute(self, obj: Any, data: Mapping[str, Any], engine: "ActionEngine") -> Any:
+        res = self.deep_substitute(obj, data, engine)
+        return self._final_unescape(res)
 
-    def flat_substitute(self, tmpl: str, data: Mapping[str, Any]) -> Any:
-        if "${" not in tmpl:
+    def flat_substitute(self, tmpl: str, data: Mapping[str, Any], engine: "ActionEngine") -> Any:
+        if not self._has_unescaped_placeholder(tmpl):
             return tmpl
 
-        if tmpl.startswith("${") and tmpl.endswith("}"):
-            body = tmpl[2:-1]
-            return copy.deepcopy(self._resolve_expr(body, data))
-
         out: list[str] = []
         i = 0
 
         while i < len(tmpl):
+            # literal "${"
+            if tmpl[i:i + 3] == "$${":
+                out.append("$${")
+                i += 3
+                continue
+
+            # literal "$"
+            if tmpl[i:i + 2] == "$$":
+                out.append("$$")
+                i += 2
+                continue
+
             if tmpl[i: i + 2] == "${":
                 depth = 0
                 j = i + 2
@@ -213,7 +219,7 @@ class TemplateSubstitutor:
                     elif ch == "}":
                         if depth == 0:
                             expr = tmpl[i + 2: j]
-                            val = self._resolve_expr(expr, data)
+                            val = self._resolve_expr(expr, data, engine)
 
                             if isinstance(val, (Mapping, list)):
                                 rendered = json.dumps(val, ensure_ascii=False)
@@ -236,29 +242,29 @@ class TemplateSubstitutor:
 
         return "".join(out)
 
-    def deep_substitute(self, obj: Any, data: Mapping[str, Any], _depth: int = 0) -> Any:
-        if _depth > 50:
+    def deep_substitute(self, obj: Any, data: Mapping[str, Any], engine: "ActionEngine", _depth: int = 0) -> Any:
+        if _depth > engine.max_depth:
             raise RecursionError("too deep interpolation")
 
         if isinstance(obj, str):
-            out = self.flat_substitute(obj, data)
-            if isinstance(out, str) and "${" in out:
-                return self.deep_substitute(out, data, _depth + 1)
+            out = self.flat_substitute(obj, data, engine)
+            if isinstance(out, str) and self._has_unescaped_placeholder(out):
+                return self.deep_substitute(out, data, engine, _depth + 1)
             return out
 
         if isinstance(obj, list):
-            return [self.deep_substitute(item, data, _depth) for item in obj]
+            return [self.deep_substitute(item, data, engine, _depth) for item in obj]
 
         if isinstance(obj, tuple):
-            return [self.deep_substitute(item, data, _depth) for item in obj]
+            return [self.deep_substitute(item, data, engine, _depth) for item in obj]
 
         if isinstance(obj, Mapping):
             out: dict[Any, Any] = {}
             for k, v in obj.items():
-                new_key = self.deep_substitute(k, data, _depth) if isinstance(k, str) else k
+                new_key = self.deep_substitute(k, data, engine, _depth) if isinstance(k, str) else k
                 if new_key in out:
                     raise KeyError(f"duplicate key after substitution: {new_key!r}")
-                out[new_key] = self.deep_substitute(v, data, _depth)
+                out[new_key] = self.deep_substitute(v, data, engine, _depth)
             return out
 
         return obj
@@ -267,7 +273,33 @@ class TemplateSubstitutor:
     # Internals
     # -------------------------------------------------------------------------
 
-    def _resolve_expr(self, expr: str, data: Mapping[str, Any]) -> Any:
+    def _final_unescape(self, obj: Any) -> Any:
+        if isinstance(obj, str):
+            return obj.replace("$${", "${").replace("$$", "$")
+        if isinstance(obj, list):
+            return [self._final_unescape(x) for x in obj]
+        if isinstance(obj, tuple):
+            return tuple(self._final_unescape(x) for x in obj)
+        if isinstance(obj, Mapping):
+            return {self._final_unescape(k) if isinstance(k, str) else k: self._final_unescape(v)
+                    for k, v in obj.items()}
+        return obj
+
+    @staticmethod
+    def _has_unescaped_placeholder(s: str) -> bool:
+        i = 0
+        while True:
+            j = s.find("${", i)
+            if j == -1:
+                return False
+            if j > 0 and s[j - 1] == "$":
+                i = j + 2
+                continue
+            return True
+
+        return False
+
+    def _resolve_expr(self, expr: str, data: Mapping[str, Any], engine: "ActionEngine") -> Any:
         expr = expr.strip()
 
         # 1) Casters
@@ -275,26 +307,26 @@ class TemplateSubstitutor:
             tag = f"{prefix}:"
             if expr.startswith(tag):
                 inner = expr[len(tag):]
-                value = self.flat_substitute(inner, data)
+                value = self.flat_substitute(inner, data, engine)
 
-                if isinstance(value, str) and value.startswith("${") and value.endswith("}"):
-                    value = self.flat_substitute(value, data)
+                if isinstance(value, str) and self._has_unescaped_placeholder(value):
+                    value = self.flat_substitute(value, data, engine)
 
                 return fn(value)
 
         # 2) JMESPath
         if expr.startswith("?"):
             query_raw = expr[1:].lstrip()
-            query_expanded = self.flat_substitute(query_raw, data)
+            query_expanded = self.flat_substitute(query_raw, data, engine)
             return jmespath.search(query_expanded, data, options=self._jp_options)
 
         # 3) Nested template
-        if expr.startswith("${") and expr.endswith("}"):
-            return self.flat_substitute(expr, data)
+        if self._has_unescaped_placeholder(expr):
+            return self.flat_substitute(expr, data, engine)
 
         # 4) JSON Pointer fallback
         pointer = "/" + expr.lstrip("/")
         try:
-            return maybe_slice(pointer, data)  # type: ignore[arg-type]
+            return engine.pointer_manager.maybe_slice(pointer, data)
         except Exception:
             return None

{j_perm-0.2.1.1.dist-info → j_perm-0.2.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: j-perm
-Version: 0.2.1.1
+Version: 0.2.3
 Summary: json permutation library
 Author-email: Roman <kuschanow@gmail.com>
 License: MIT
@@ -799,8 +799,8 @@ def my_op(step, dest, src, engine):
 from j_perm import SpecialRegistry
 
 @SpecialRegistry.register("$upper")
-def sp_upper(node, src, resolver):
-  value = resolver.substitutor.substitute(node["$upper"], src)
+def sp_upper(node, src, resolver, engine):
+  value = resolver.substitutor.substitute(node["$upper"], src, engine)
   return str(value).upper()
 ```
 

j_perm-0.2.3.dist-info/RECORD

@@ -0,0 +1,39 @@
+j_perm/__init__.py,sha256=81aLdcmlUg51R6xR-VXVDDUeM87ezy3ZuiLpblHZ_wk,873
+j_perm/engine.py,sha256=ETrLMr2VecSpiT8Ai9AL_-TW6sAlSQ-1Jpf7lttHNPY,4061
+j_perm/normalizer.py,sha256=zxWtARRNuzS-zgFuB40dqU0oaUUk8PLKJNOPNb5wbRw,2672
+j_perm/op_handler.py,sha256=h28thz_18DwZTb9IZtTd6kfsZj7hN4UsmU4uf3aMYpo,1649
+j_perm/pointers.py,sha256=Czhq9vre_HnxhT1iOs8cDcKdCvEum5_YdvaEzoZ3iTY,3205
+j_perm/special_resolver.py,sha256=khRVWXrE3Vch1gbxsfFwj9JQ37pZ-_ojMeh-G2Vv7bs,4032
+j_perm/subst.py,sha256=I1O9qdmJp9TYjpfnqOgyIgL064hWGCmsGoxCbFWCBL4,11026
+j_perm/casters/__init__.py,sha256=mD49oMEyj6oDfSKXEJ8DbnmqkSypfEEg3VMI_rfaK-4,114
+j_perm/casters/_bool.py,sha256=qRsT7IcFBApD09elKUyUUaZmfePSIsOsKQHQHsgnHsw,230
+j_perm/casters/_float.py,sha256=C4r-h6zbkjmQnoEdE2RDMhSkW9oGrvxbQngJZ2T7_tU,153
+j_perm/casters/_int.py,sha256=f1BKqsULiG6Puov1qcGS_inSnv0hZtQ0deQEMP0v0i4,145
+j_perm/casters/_str.py,sha256=v1_BD1_hPbOtvO5CKYAlNEGbMhpR56eKCnV2a2Q4kGU,145
+j_perm/constructs/__init__.py,sha256=TTUPSMyvj8HSfPikrFqXaFsechc9aOIbjtVjy4TOolE,50
+j_perm/constructs/eval.py,sha256=UzjZK27UAzsl3s26Y3RWBPhuKX1Az0fK6xk-cgpS8pQ,452
+j_perm/constructs/ref.py,sha256=WgzEo54IhGWvBVSwPGTeqCRLDyK5uPJ01p5Wjd1YdNM,634
+j_perm/funcs/__init__.py,sha256=8yIafxhCH5B7jXrsautQEtl4Qt8RcUK7IWNniORj9ow,31
+j_perm/funcs/subtract.py,sha256=8W49TsrnIU4EVjS8tWQY2GXlX2nAaQ1O9O1JlrVYdIw,288
+j_perm/ops/__init__.py,sha256=j_U4Aq0iwEvZOF0jqMmlQA0NisJsHNJWzqkfyMWuHFA,364
+j_perm/ops/_assert.py,sha256=vXsQBNIBQYLNSrO6u-vg4_oavvK5N_u-MAc8AqnISBk,769
+j_perm/ops/_assert_d.py,sha256=sG1DC-ElJi54EN2LPzzbvw_5jtOoR1w6j_Ml3mO5Gwo,779
+j_perm/ops/_exec.py,sha256=e3TCFN7bzJ_mjPbpm4ZZq0Dbz-YoJhOiHH1Dt4PwY3k,1919
+j_perm/ops/_if.py,sha256=QziuiEOSkcOMMbyHm_C9IYRhybdtqiLdtQSBbyEL6To,1596
+j_perm/ops/copy.py,sha256=XA5EysIAbbX7hrS1aeN7MidiX_8YyaeTjsZCKoMYbT0,1108
+j_perm/ops/copy_d.py,sha256=iTlZ6lE1gMMcCaUjVWhbXHpBxd97OLXM9Ml5SP0Xvbw,1015
+j_perm/ops/delete.py,sha256=YwPyMxPZ2LnCVC__bivvDLxlsvT2mnrmNIH7Qgw7bjk,894
+j_perm/ops/distinct.py,sha256=eL7Ja4YNVCpsrgiuMxew2xqO3pLitJyAI3ygzy3hSVs,1066
+j_perm/ops/foreach.py,sha256=zbELdguV5He_7nBoekaFsn6dsqBQuRzCoPIB44weUbE,1415
+j_perm/ops/replace_root.py,sha256=klPY9E3KsPfnswIM4CdX_JPXGE1WWjr0sXSXSwn3ooo,453
+j_perm/ops/set.py,sha256=YJjS1BXEEdPxFbUcJGu4YZPt0HHsk9cixpk0OnVQB4E,1886
+j_perm/ops/update.py,sha256=9ouXm4ICNBqr03gJXUvV78AiytgkA4K2Fwb648r8rhE,2457
+j_perm/schema/__init__.py,sha256=mhEbGdi1MgLeEm1IL8-tkTtbIdrdlvQi22sBr7vCUqg,3392
+j_perm/shorthands/__init__.py,sha256=zvsu15iExYtUrct6Ob4IRs6Ao46PoZaCKVIUhMBY4Dk,117
+j_perm/shorthands/_assert.py,sha256=iRvuUGlN5Bj9G5Bo-aXUa4MQujgmrR3N-PhDeee6xcY,555
+j_perm/shorthands/assign_or_append.py,sha256=TsSzaQXb5qoKtY6tvx_skHob-695Zii5roUfXltznAQ,621
+j_perm/shorthands/delete.py,sha256=PZeTRcP6-Q3SdbdyruWWXtMJ9mTnz1CBCHiOpHNI06Q,311
+j_perm-0.2.3.dist-info/METADATA,sha256=VC5n1B4bYvfhZ2Yl6m-MPlVknNUZESOjt9z4R9MgkkU,17674
+j_perm-0.2.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+j_perm-0.2.3.dist-info/top_level.txt,sha256=yveBxREqVn9DliNwmen1QWoxR0uta7bU5giS1CCffRI,7
+j_perm-0.2.3.dist-info/RECORD,,

j_perm/utils/pointers.py

@@ -1,108 +0,0 @@
-from __future__ import annotations
-
-import re
-from typing import Any, Mapping, MutableMapping, List, Tuple
-
-_SLICE_RE = re.compile(r"(.+)\[(-?\d*):(-?\d*)]$")
-
-
-def _decode(tok: str) -> str:
-    """Decode a single JSON Pointer token, handling RFC6901-style escapes."""
-    return (
-        tok.replace("~0", "~")
-        .replace("~1", "/")
-        .replace("~2", "$")
-        .replace("~3", ".")
-    )
-
-
-def jptr_get(doc: Any, ptr: str) -> Any:
-    """Read value by JSON Pointer, supporting root and '..' segments."""
-    if ptr in ("", "/", "."):
-        return doc
-
-    tokens = ptr.lstrip("/").split("/")
-    cur: Any = doc
-    parents: List[Tuple[Any, Any]] = []
-
-    for raw_tok in tokens:
-        if raw_tok == "..":
-            if parents:
-                cur, _ = parents.pop()
-            else:
-                cur = doc
-            continue
-
-        key = _decode(raw_tok)
-
-        if isinstance(cur, (list, tuple)):
-            idx = int(key)
-            parents.append((cur, idx))
-            cur = cur[idx]
-        else:
-            parents.append((cur, key))
-            cur = cur[key]
-
-    return cur
-
-
-def maybe_slice(ptr: str, src: Mapping[str, Any]) -> Any:
-    """Resolve a pointer and optional Python-style slice suffix '[start:end]' for arrays."""
-    m = _SLICE_RE.match(ptr)
-    if m:
-        base, s, e = m.groups()
-        seq = jptr_get(src, base)
-        if not isinstance(seq, (list, tuple)):
-            raise TypeError(f"{base} is not a list (slice requested)")
-
-        start = int(s) if s else None
-        end = int(e) if e else None
-        return seq[start:end]
-
-    return jptr_get(src, ptr)
-
-
-def jptr_ensure_parent(
-        doc: MutableMapping[str, Any],
-        ptr: str,
-        *,
-        create: bool = False,
-):
-    """Return (container, leaf_key) for ptr, optionally creating intermediate nodes."""
-    raw_parts = ptr.lstrip("/").split("/")
-    parts: List[str] = []
-
-    for raw in raw_parts:
-        if raw == "..":
-            if parts:
-                parts.pop()
-            continue
-        parts.append(raw)
-
-    if not parts:
-        return doc, ""
-
-    cur: Any = doc
-
-    for raw in parts[:-1]:
-        token = _decode(raw)
-
-        if isinstance(cur, list):
-            idx = int(token)
-            if idx >= len(cur):
-                if create:
-                    while idx >= len(cur):
-                        cur.append({})
-                else:
-                    raise IndexError(f"{ptr}: index {idx} out of range")
-            cur = cur[idx]
-        else:
-            if token not in cur:
-                if create:
-                    cur[token] = {}
-                else:
-                    raise KeyError(f"{ptr}: missing key '{token}'")
-            cur = cur[token]
-
-    leaf = _decode(parts[-1])
-    return cur, leaf

j_perm-0.2.1.1.dist-info/RECORD

@@ -1,40 +0,0 @@
-j_perm/__init__.py,sha256=81aLdcmlUg51R6xR-VXVDDUeM87ezy3ZuiLpblHZ_wk,873
-j_perm/engine.py,sha256=iaUxB7EWcqvWsP4Z8z49a6-atX9br1tTC-WlZVrVo-A,3923
-j_perm/normalizer.py,sha256=50pff5j3sTrCu2Fp_SW6m99qwt88CladpYlWpQ3c-ac,2671
-j_perm/op_handler.py,sha256=h28thz_18DwZTb9IZtTd6kfsZj7hN4UsmU4uf3aMYpo,1649
-j_perm/special_resolver.py,sha256=khRVWXrE3Vch1gbxsfFwj9JQ37pZ-_ojMeh-G2Vv7bs,4032
-j_perm/subst.py,sha256=oW21Gs2nTEQLcOC_xMKzeuZFtfNvnB2QZAIWl7U4TSg,9802
-j_perm/casters/__init__.py,sha256=mD49oMEyj6oDfSKXEJ8DbnmqkSypfEEg3VMI_rfaK-4,114
-j_perm/casters/_bool.py,sha256=qRsT7IcFBApD09elKUyUUaZmfePSIsOsKQHQHsgnHsw,230
-j_perm/casters/_float.py,sha256=C4r-h6zbkjmQnoEdE2RDMhSkW9oGrvxbQngJZ2T7_tU,153
-j_perm/casters/_int.py,sha256=f1BKqsULiG6Puov1qcGS_inSnv0hZtQ0deQEMP0v0i4,145
-j_perm/casters/_str.py,sha256=v1_BD1_hPbOtvO5CKYAlNEGbMhpR56eKCnV2a2Q4kGU,145
-j_perm/constructs/__init__.py,sha256=TTUPSMyvj8HSfPikrFqXaFsechc9aOIbjtVjy4TOolE,50
-j_perm/constructs/eval.py,sha256=UzjZK27UAzsl3s26Y3RWBPhuKX1Az0fK6xk-cgpS8pQ,452
-j_perm/constructs/ref.py,sha256=GtR2hpENev9k1lsx3mHGM8956vBfrPUgHm3IydYr-_I,644
-j_perm/funcs/__init__.py,sha256=8yIafxhCH5B7jXrsautQEtl4Qt8RcUK7IWNniORj9ow,31
-j_perm/funcs/subtract.py,sha256=8W49TsrnIU4EVjS8tWQY2GXlX2nAaQ1O9O1JlrVYdIw,288
-j_perm/ops/__init__.py,sha256=j_U4Aq0iwEvZOF0jqMmlQA0NisJsHNJWzqkfyMWuHFA,364
-j_perm/ops/_assert.py,sha256=O7MFxW3FDCglPMx-tBwi67k2Wd-Mds996AQdeGLbM6Q,773
-j_perm/ops/_assert_d.py,sha256=xEjqBryCbzBpkzYhwRZht7-uyXv7XaCkEcRt6sjwE7k,783
-j_perm/ops/_exec.py,sha256=HaFy__49QXnxYNbh1IdIu8ZQoWlQsrms5HgyRN5lV6o,1913
-j_perm/ops/_if.py,sha256=DNYp0j3-3YYMIR_CcDM3Ai0CpW2Qt4SYtKxk-9onu8c,1590
-j_perm/ops/copy.py,sha256=fV2rE92JyTRqo91GjXwWucklDR1T1ZcFHHbxG1F8S9g,1110
-j_perm/ops/copy_d.py,sha256=2SGHoq4vaD79diJos_oO3pvZvC_XrQorxhXAgZ5l09E,1017
-j_perm/ops/delete.py,sha256=7SzLE9W_dlmcLOVzKjOzIFLSAHf9nGlagbhbwIH_PmI,916
-j_perm/ops/distinct.py,sha256=RoVIIRNm7C9iAjcPZHpoMfgKw6pGx7nuLkYwruhHeYY,1036
-j_perm/ops/foreach.py,sha256=6tEQ9PyiWBvrm0eANg18p5hV-OvIiL2O1rdqWOC18tQ,1425
-j_perm/ops/replace_root.py,sha256=FFyc-95n3kTzcOXrnjwDdvwOnKNitXKb_1F25MMnXd8,445
-j_perm/ops/set.py,sha256=-kFFgHxeq65K5vLzDe6PhUoLT-ksoZYUVL1Jxf8bRA0,1882
-j_perm/ops/update.py,sha256=gvJTh3vS4zD-lpaqN23w5OO3hTtkSdu8RPy0V8r8Rwg,2471
-j_perm/schema/__init__.py,sha256=mhEbGdi1MgLeEm1IL8-tkTtbIdrdlvQi22sBr7vCUqg,3392
-j_perm/shorthands/__init__.py,sha256=zvsu15iExYtUrct6Ob4IRs6Ao46PoZaCKVIUhMBY4Dk,117
-j_perm/shorthands/_assert.py,sha256=iRvuUGlN5Bj9G5Bo-aXUa4MQujgmrR3N-PhDeee6xcY,555
-j_perm/shorthands/assign_or_append.py,sha256=TsSzaQXb5qoKtY6tvx_skHob-695Zii5roUfXltznAQ,621
-j_perm/shorthands/delete.py,sha256=PZeTRcP6-Q3SdbdyruWWXtMJ9mTnz1CBCHiOpHNI06Q,311
-j_perm/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-j_perm/utils/pointers.py,sha256=X1HSCag4t-qq5zTvBMRAlBKXwpHVNNZYJrdJRtyEr4g,2788
-j_perm-0.2.1.1.dist-info/METADATA,sha256=zwwrX08mxWxT5sMGLkh4PaLBVs7FMspDzwhcqj8sfpg,17660
-j_perm-0.2.1.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-j_perm-0.2.1.1.dist-info/top_level.txt,sha256=yveBxREqVn9DliNwmen1QWoxR0uta7bU5giS1CCffRI,7
-j_perm-0.2.1.1.dist-info/RECORD,,