dotted-notation 0.47.1__tar.gz → 0.47.2__tar.gz

{dotted_notation-0.47.1 → dotted_notation-0.47.2}/CHANGELOG.md

@@ -3,6 +3,13 @@
 All notable changes to `dotted` are recorded here. Versions prior to
 the ones listed are omitted — browse git history for earlier entries.
 
+## [0.47.2]
+
+### Added
+- `$str`, a `$` before a word, is a plain string wherever a key, guard
+  value or transform argument may stand, as `^str` already was. It was a
+  `ParseError`. `$0`, `$(name)` and `$$(path)` are unchanged.
+
 ## [0.47.1]
 
 ### Added

{dotted_notation-0.47.1/dotted_notation.egg-info → dotted_notation-0.47.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dotted_notation
-Version: 0.47.1
+Version: 0.47.2
 Summary: Dotted notation for safe nested data traversal with optional chaining, pattern matching, and transforms
 Author-email: Frey Waid <logophage1@gmail.com>
 License-Expression: MIT
@@ -1655,6 +1655,13 @@ Quoting also works — a quoted string is always literal:
 To use a literal `$$` as a key, escape with backslash (`\$$`) or quote it
 (`'$$(…)'`).
 
+A `$` before a word is not a substitution at all: `$str` is the plain string
+`$str`, in a segment, a guard value or a transform argument alike, just as
+`^str` is. Only `$0`, `$(name)` and `$$(path)` have meaning:
+
+    >>> dotted.get({'$amount': {'value': 2}}, '$amount.value')
+    2
+
 <a id="type-restrictions"></a>
 ## Type Restrictions
 

{dotted_notation-0.47.1 → dotted_notation-0.47.2}/README.md

@@ -1608,6 +1608,13 @@ Quoting also works — a quoted string is always literal:
 To use a literal `$$` as a key, escape with backslash (`\$$`) or quote it
 (`'$$(…)'`).
 
+A `$` before a word is not a substitution at all: `$str` is the plain string
+`$str`, in a segment, a guard value or a transform argument alike, just as
+`^str` is. Only `$0`, `$(name)` and `$$(path)` have meaning:
+
+    >>> dotted.get({'$amount': {'value': 2}}, '$amount.value')
+    2
+
 <a id="type-restrictions"></a>
 ## Type Restrictions
 

{dotted_notation-0.47.1 → dotted_notation-0.47.2}/dotted/grammar.py

@@ -1,6 +1,7 @@
 """
 """
 import decimal
+import re
 import pyparsing as pp
 from pyparsing import pyparsing_common as ppc
 
@@ -275,7 +276,9 @@ def _paren_subst_action(t):
 _paren_subst = pp.Regex(r'\$\([^)]+\)').set_parse_action(_paren_subst_action)
 _raw_subst = pp.Regex(r'\$[0-9]+').set_parse_action(
     lambda t: matchers.Subst(int(t[0][1:])))
-var = _escaped_dollar | _reference | _paren_subst | _raw_subst
+# $str, a $ before a word: a plain string, as ^str is. Not $0, $(name) or $$(path).
+_dollar_word = pp.Regex(r'\$(?![0-9($])[^' + re.escape(reserved) + r' \t\n\r]+').set_parse_action(matchers.Word)
+var = _escaped_dollar | _reference | _paren_subst | _raw_subst | _dollar_word
 slice = pp.Optional(integer | plus) + ':' + pp.Optional(integer | plus) \
          + pp.Optional(':') + pp.Optional(integer | plus)
 

{dotted_notation-0.47.1 → dotted_notation-0.47.2/dotted_notation.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dotted_notation
-Version: 0.47.1
+Version: 0.47.2
 Summary: Dotted notation for safe nested data traversal with optional chaining, pattern matching, and transforms
 Author-email: Frey Waid <logophage1@gmail.com>
 License-Expression: MIT
@@ -1655,6 +1655,13 @@ Quoting also works — a quoted string is always literal:
 To use a literal `$$` as a key, escape with backslash (`\$$`) or quote it
 (`'$$(…)'`).
 
+A `$` before a word is not a substitution at all: `$str` is the plain string
+`$str`, in a segment, a guard value or a transform argument alike, just as
+`^str` is. Only `$0`, `$(name)` and `$$(path)` have meaning:
+
+    >>> dotted.get({'$amount': {'value': 2}}, '$amount.value')
+    2
+
 <a id="type-restrictions"></a>
 ## Type Restrictions
 

{dotted_notation-0.47.1 → dotted_notation-0.47.2}/pyproject.toml

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