j-perm 0.1.3__py3-none-any.whl → 0.2.0__py3-none-any.whl

j_perm-0.2.0.dist-info/RECORD

@@ -0,0 +1,34 @@
+j_perm/__init__.py,sha256=RUpTLecqmkXgyy91s8DHNMEStW4almMYGHTJMmLR5NY,714
+j_perm/engine.py,sha256=xKSokxnkuVUyGZcsC1F88xzBw3vLpPPPUD1iHYKuKsI,5562
+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=ZckFMcerRWnu-51WAEdm35kuO7t_EzqvtiCAgVWDsjQ,457
+j_perm/constructs/ref.py,sha256=eUrRCanKAEWZ98jOAHNhjs5UhXNAm17NWd4Cbus_cyY,654
+j_perm/funcs/__init__.py,sha256=8yIafxhCH5B7jXrsautQEtl4Qt8RcUK7IWNniORj9ow,31
+j_perm/funcs/subtract.py,sha256=0UW3McKL7VDPVj0UwfvZlrSXGs1uQ6yIdLz5rPqa7bY,293
+j_perm/ops/__init__.py,sha256=G4j6MGnEVnHSeJIBwrpV9oMk7s_djlEaOmLRW_4IEEo,329
+j_perm/ops/_assert.py,sha256=l07DjqsMbvoTDzLbVVcMciblYw8O4D6gBwPt3yFKPhs,758
+j_perm/ops/_exec.py,sha256=-esjfF2te1NvkclrJJ9lGU7YdwY_15vuxMihG08HhQM,1934
+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/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+j_perm/utils/pointers.py,sha256=X1HSCag4t-qq5zTvBMRAlBKXwpHVNNZYJrdJRtyEr4g,2788
+j_perm-0.2.0.dist-info/METADATA,sha256=DuPKOquojX3jKmrER86guVZXtha52te5M2xo3oN3Azc,16228
+j_perm-0.2.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+j_perm-0.2.0.dist-info/top_level.txt,sha256=yveBxREqVn9DliNwmen1QWoxR0uta7bU5giS1CCffRI,7
+j_perm-0.2.0.dist-info/RECORD,,

{j_perm-0.1.3.dist-info → j_perm-0.2.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

j_perm/jmes_ext.py

@@ -1,17 +0,0 @@
-from __future__ import annotations
-
-import jmespath
-from jmespath import functions as _jp_funcs
-
-
-class _UserFunctions(_jp_funcs.Functions):
-    """Container for custom JMESPath functions used by the DSL."""
-
-    @_jp_funcs.signature({'types': ['number']}, {'types': ['number']})
-    def _func_subtract(self, a: float, b: float) -> float:
-        """JMESPath function that subtracts two numbers (a - b)."""
-        return a - b
-
-
-USER_FUNCTIONS = _UserFunctions()
-JP_OPTIONS = jmespath.Options(custom_functions=USER_FUNCTIONS)

j_perm/registry.py

@@ -1,30 +0,0 @@
-from __future__ import annotations
-
-from typing import Any, Callable, Dict, MutableMapping, Mapping, TypeAlias
-
-Handler: TypeAlias = Callable[
-    [dict, MutableMapping[str, Any], Mapping[str, Any]],
-    MutableMapping[str, Any],
-]
-
-_OP_HANDLERS: Dict[str, Handler] = {}
-
-
-def register_op(name: str) -> Callable[[Handler], Handler]:
-    """Decorator that registers a DSL operation handler under a given name."""
-
-    def decorator(func: Handler) -> Handler:
-        if name in _OP_HANDLERS:
-            raise ValueError(f"Handler for op '{name}' is already registered")
-        _OP_HANDLERS[name] = func
-        return func
-
-    return decorator
-
-
-def get_handler(name: str) -> Handler:
-    """Return a registered handler or raise ValueError if it does not exist."""
-    try:
-        return _OP_HANDLERS[name]
-    except KeyError:
-        raise ValueError(f"Unknown op '{name}'") from None

j_perm/utils/special.py

@@ -1,41 +0,0 @@
-from __future__ import annotations
-
-import copy
-from typing import Any, Mapping
-
-from .pointers import maybe_slice
-from .subst import substitute
-from ..engine import apply_actions
-
-_MISSING = object()
-
-
-def resolve_special(val: Any, src: Mapping[str, Any]):
-    """Resolve $ref / $eval constructs inside an arbitrary value tree."""
-    if isinstance(val, dict):
-        if "$ref" in val:
-            ptr = substitute(val["$ref"], src)
-            dflt = val.get("$default", _MISSING)
-            try:
-                return copy.deepcopy(maybe_slice(ptr, src))
-            except Exception:
-                if dflt is not _MISSING:
-                    return copy.deepcopy(dflt)
-                raise
-
-        if "$eval" in val:
-            out = apply_actions(val["$eval"], dest={}, source=src)
-            if "$select" in val:
-                sel = maybe_slice(val["$select"], out)  # type: ignore[arg-type]
-                return sel
-            return out
-
-        return {k: resolve_special(v, src) for k, v in val.items()}
-
-    if isinstance(val, list):
-        return [resolve_special(x, src) for x in val]
-
-    if isinstance(val, tuple):
-        return tuple(resolve_special(x, src) for x in val)
-
-    return val

j_perm/utils/subst.py

@@ -1,133 +0,0 @@
-from __future__ import annotations
-
-import copy
-import json
-from typing import Any, Mapping, List
-
-import jmespath
-
-from ..jmes_ext import JP_OPTIONS
-
-_CASTERS = {
-    "int": int,
-    "float": float,
-    "str": str,
-    "bool": lambda x: bool(int(x)) if isinstance(x, (int, str)) else bool(x),
-}
-
-
-def _resolve_expr(expr: str, data: Mapping[str, Any]) -> Any:
-    """Resolve a single ${...} expression body."""
-    from .pointers import maybe_slice  # local import to avoid cycles
-
-    expr = expr.strip()
-
-    # 1) simple casters like int:/path
-    for prefix, fn in _CASTERS.items():
-        tag = f"{prefix}:"
-        if expr.startswith(tag):
-            inner = expr[len(tag):]
-            value = flat_substitute(inner, data)
-            if isinstance(value, str) and value.startswith("${") and value.endswith("}"):
-                value = flat_substitute(value, data)
-            return fn(value)
-
-    # 2) JMESPath expression ? <expr>
-    if expr.startswith("?"):
-        query_raw = expr[1:].lstrip()
-        query_expanded = flat_substitute(query_raw, data)
-        return jmespath.search(query_expanded, data, options=JP_OPTIONS)
-
-    # 3) nested template ${...}
-    if expr.startswith("${") and expr.endswith("}"):
-        return flat_substitute(expr, data)
-
-    # 4) default: treat as JSON Pointer (relative to root)
-    pointer = "/" + expr.lstrip("/")
-    try:
-        return maybe_slice(pointer, data)  # type: ignore[arg-type]
-    except Exception:
-        return None
-
-
-def flat_substitute(tmpl: str, data: Mapping[str, Any]) -> Any:
-    """One-pass interpolation that replaces all ${...} occurrences in a string."""
-    if "${" not in tmpl:
-        return tmpl
-
-    # Entire string is a single ${...}
-    if tmpl.startswith("${") and tmpl.endswith("}"):
-        body = tmpl[2:-1]
-        return copy.deepcopy(_resolve_expr(body, data))
-
-    out: List[str] = []
-    i = 0
-    while i < len(tmpl):
-        if tmpl[i:i + 2] == "${":
-            depth = 0
-            j = i + 2
-
-            while j < len(tmpl):
-                ch = tmpl[j]
-
-                if ch == "{" and tmpl[j - 1] == "$":
-                    depth += 1
-                elif ch == "}":
-                    if depth == 0:
-                        expr = tmpl[i + 2:j]
-                        val = _resolve_expr(expr, data)
-
-                        if isinstance(val, (Mapping, list)):
-                            rendered = json.dumps(val, ensure_ascii=False)
-                        else:
-                            rendered = str(val)
-
-                        out.append(rendered)
-                        i = j + 1
-                        break
-                    depth -= 1
-
-                j += 1
-            else:
-                # no closing brace found, treat '${' as a literal
-                out.append(tmpl[i])
-                i += 1
-        else:
-            out.append(tmpl[i])
-            i += 1
-
-    return "".join(out)
-
-
-def deep_substitute(obj: Any, data: Mapping[str, Any], _depth: int = 0) -> Any:
-    """Recursively apply interpolation to strings, mapping keys/values and sequences."""
-    if _depth > 50:
-        raise RecursionError("too deep interpolation")
-
-    if isinstance(obj, str):
-        out = flat_substitute(obj, data)
-        if isinstance(out, str) and "${" in out:
-            return deep_substitute(out, data, _depth + 1)
-        return out
-
-    if isinstance(obj, list):
-        return [deep_substitute(item, data, _depth) for item in obj]
-
-    if isinstance(obj, tuple):
-        return [deep_substitute(item, data, _depth) for item in obj]
-
-    if isinstance(obj, Mapping):
-        out: dict[Any, Any] = {}
-        for k, v in obj.items():
-            new_key = deep_substitute(k, data, _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] = deep_substitute(v, data, _depth)
-        return out
-
-    return obj
-
-
-# Public alias mirroring the original _substitute name
-substitute = deep_substitute
-substitute.__name__ = "substitute"

j_perm/utils/tuples.py

@@ -1,17 +0,0 @@
-from __future__ import annotations
-
-from typing import Any, Mapping
-
-
-def tuples_to_lists(obj: Any) -> Any:
-    """Recursively convert all tuples into lists so JMESPath indexers work reliably."""
-    if isinstance(obj, tuple):
-        return [tuples_to_lists(x) for x in obj]
-
-    if isinstance(obj, list):
-        return [tuples_to_lists(x) for x in obj]
-
-    if isinstance(obj, Mapping):
-        return {k: tuples_to_lists(v) for k, v in obj.items()}
-
-    return obj

j_perm-0.1.3.dist-info/METADATA

@@ -1,116 +0,0 @@
-Metadata-Version: 2.4
-Name: j-perm
-Version: 0.1.3
-Summary: jsom permutation library
-Author-email: Roman <kuschanow@gmail.com>
-License: MIT
-Project-URL: Homepage, https://github.com/kuschanow/j-perm
-Project-URL: Source, https://github.com/kuschanow/j-perm
-Project-URL: Tracker, https://github.com/kuschanow/j-perm/issues
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: jmespath
-
-
-# JSON patch applier
-
-A small, composable JSON transformation DSL implemented in Python.
-
-The library lets you describe transformations as data (a list of steps) and then
-apply them to an input document. It supports JSON Pointer paths, custom
-JMESPath expressions, interpolation with `${...}` syntax, and a set of
-built-in operations.
-
-## Features
-
-- JSON Pointer read/write with support for:
-  - root pointers (`''`, `'/'`, `'.'`)
-  - relative `..` segments
-  - list slices like `/items[1:3]`
-- String interpolation:
-  - `${/path/to/node}` — JSON Pointer lookup
-  - `${int:/path}` / `${float:/path}` / `${bool:/path}` — simple casters
-  - `${? some.jmespath(expression) }` — JMESPath with custom functions
-- Special values:
-  - `$ref` — reference into the source document
-  - `$eval` — nested DSL evaluation with optional `$select`
-- Rich set of operations:
-  - `set`, `copy`, `copyD`, `delete`, `assert`
-  - `foreach`, `if`, `distinct`
-  - `replace_root`, `exec`, `update`
-- Schema helper: approximate JSON Schema generation for a given DSL script.
-
-## Basic usage
-
-```python
-from j_perm import apply_actions
-
-source = {
-    "users": [
-        {"name": "Alice", "age": 17},
-        {"name": "Bob", "age": 22}
-    ]
-}
-
-actions = [
-    # Start with empty list
-    {"op": "replace_root", "value": []},
-
-    # For each user - build a simplified object
-    {
-        "op": "foreach",
-        "in": "/users",
-        "as": "u",
-        "do": [
-            {
-                "op": "set",
-                "path": "/-",
-                "value": {
-                    "name": "${/u/name}",
-                    "is_adult": {
-                        "$eval": [
-                            {"op": "replace_root", "value": False},
-                            {
-                                "op": "if",
-                                "cond": "${?`${/u/age}` >= `18`}",
-                                "then": [{"op": "replace_root", "value": True}]
-                            }
-                        ]
-                    }
-                }
-            }
-        ]
-    }
-]
-
-result = apply_actions(actions, dest={}, source=source)
-# result -> {"fullName": "Alice", "isAdult": True}
-```
-
-## Schema generation
-
-```python
-from j_perm import build_schema
-
-schema = build_schema(script)
-```
-
-`schema` is a JSON-Schema-like structure that you can use for documentation,
-validation or introspection.
-
-## Extending with custom operations
-
-```python
-from j_perm import register_op
-
-@register_op("my_op")
-def my_op(step, dest, src):
-    # implement your logic here
-    return dest
-```
-
-Any registered operation can then be used in DSL scripts via `{"op": "my_op", ...}`.
-
-## License
-
-This package is provided as-is; feel free to adapt it to your project structure.

j_perm-0.1.3.dist-info/RECORD

@@ -1,26 +0,0 @@
-j_perm/__init__.py,sha256=2be5yKOQ_3owmfpZB4op_uso6rHf06aUiOBuiVZO8rU,354
-j_perm/engine.py,sha256=5u0aB_hr9qgwMRaq_KKo34z-dUo6rdFmnc6XIIi3Bss,2484
-j_perm/jmes_ext.py,sha256=z4Feqx0H_4EzEILYd6jo7AGvsyFvabAfp2kVXL_E5Mg,527
-j_perm/registry.py,sha256=mq6TrP9kehJlqCOp-bflGAetEwoE2PHFoRbM7E-ov6o,890
-j_perm/ops/__init__.py,sha256=TdwKGx97X9_1Ti-VWLNBt5DGwR-cvXS7lkJf1lMD7Oo,298
-j_perm/ops/_exec.py,sha256=7Ip1keFIv2V29sb-N10cRGTHrKhI6MP-zgTNx8aPNvM,1887
-j_perm/ops/_if.py,sha256=ggQa73LmXbPmgkvOdeaY7czTzFaWRrVWpFL4EZ0tZY4,1569
-j_perm/ops/assert.py,sha256=p-wu1wcoPzrgT1VtKSoQAd8ff06unz-gvaETPGW3cB0,735
-j_perm/ops/copy.py,sha256=7cKQrRci31MxbVX7nuDGpuQDytTQ1rTF5RoL1FV2wlg,1068
-j_perm/ops/copy_d.py,sha256=kzzOCqOpVvEeNZ-ypIi7r__ei13E0aOQsLDi0QkDxuY,975
-j_perm/ops/delete.py,sha256=j4VZ-cnc_Txg7lgkJgJcQV9YDRIIXlTge9lRi03gPQk,893
-j_perm/ops/distinct.py,sha256=U8BO14Nf5wLE19hR7-oNQuv2rWHTv7QKkViXfNn561E,994
-j_perm/ops/foreach.py,sha256=EYNiM2zpxOLvX5W23ajIHrBOpbqNdV4256EAUdac_es,1442
-j_perm/ops/replace_root.py,sha256=pUreYnQDC6jekLZMnDsRx1MsBVsKzWX-KMea5jHHqts,475
-j_perm/ops/set.py,sha256=27CdeSoQRP2hNqTXWMvFMqxEj3BISOX7iySZdLftxHs,1869
-j_perm/ops/update.py,sha256=JvaajmKhzHrcD_tVTT9JB-lSPaCsyvFAIt7OvXiwqT4,2439
-j_perm/schema/__init__.py,sha256=xJML5yc85qnU-_aSTLeeDqfPYqo9-DfrENihnp1DfK8,3201
-j_perm/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-j_perm/utils/pointers.py,sha256=X1HSCag4t-qq5zTvBMRAlBKXwpHVNNZYJrdJRtyEr4g,2788
-j_perm/utils/special.py,sha256=KhKgrmR_pRyIbMubtV-62nNPzoLIMbxVBGpOPZQTTlA,1221
-j_perm/utils/subst.py,sha256=hPLtqgaRTzJmvDGuQxM9VnIMCKK08IAWo_gfhogb57s,4077
-j_perm/utils/tuples.py,sha256=0XsMId9J2T7MxtmpWQaNnbmxhileTs8Xm_vSPICkxNI,469
-j_perm-0.1.3.dist-info/METADATA,sha256=nQqj6jp30FxhTi39rghOfOYGU2gvuSR5bvxrE1p_81U,3169
-j_perm-0.1.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-j_perm-0.1.3.dist-info/top_level.txt,sha256=yveBxREqVn9DliNwmen1QWoxR0uta7bU5giS1CCffRI,7
-j_perm-0.1.3.dist-info/RECORD,,