mapres 3.dev8__py3-none-any.whl → 3.dev10__py3-none-any.whl

mapres/datamap.py

@@ -27,14 +27,23 @@ class DataMap:
 
     Syntax metadata (__syntax__) determines which delimiters
     this map responds to (angle, brace, colon, percent, pipe, etc).
+
+    Mode metadata (__mode__) controls behavior:
+        - None: plain static map
+        - "dynamic": values may be provided by callables/providers
+        - "config": config-style maps (no dynamic evaluation)
+        - "callable": map exposes callable methods for nested calls
     '''
     __syntax__: str = None
-    __mode__: str | None = None  # "dynamic", "config", or None
+    __mode__: str | None = None  # "dynamic", "config", "callable", or None
 
     def as_map(self):
         '''
         Convert datamap fields into a dictionary.
         If mode='dynamic', evaluate provider functions.
+
+        Callable mode does NOT change as_map() behavior; methods are
+        used by the evaluator, not exported as map entries.
         '''
         result = {}
 
@@ -59,15 +68,7 @@ class DataMap:
 
 # main decorator factory
 def datamap(_cls=None, *, syntax=None, mode=None):
-    '''
-    @datamap decorator.
-
-    Supports:
-        @datamap
-        @datamap(mode='dynamic')
-        @datamap(syntax='angle')
-        @datamap(syntax='angle', mode='config')
-    '''
+    '''@datamap decorator'''
     def wrap(cls):
         cls.__syntax__ = syntax
         cls.__mode__ = mode
@@ -90,6 +91,8 @@ class _SyntaxFactory:
         @datamap.angles
         @datamap.angles(mode='config')
         @datamap.angles.config
+        @datamap.angles.dynamic
+        @datamap.angles.callable
     '''
     def __init__(self, syntax_name):
         self._syntax = syntax_name
@@ -106,24 +109,30 @@ class _SyntaxFactory:
     def config(self):
         # Case 3: @datamap.angles.config
         return datamap(syntax=self._syntax, mode='config')
-    
+
     @property
     def dynamic(self):
+        # @datamap.angles.dynamic
         return datamap(syntax=self._syntax, mode='dynamic')
 
+    @property
+    def callable(self):
+        # @datamap.angles.callable
+        return datamap(syntax=self._syntax, mode='callable')
 
 
 # build syntax shortcuts
-datamap.braces      = _SyntaxFactory(syntax.braces)
-
-datamap.dollars     = _SyntaxFactory(syntax.dollars)
-datamap.angles      = _SyntaxFactory(syntax.angles)
-datamap.percents    = _SyntaxFactory(syntax.percents)
-datamap.pipes   = _SyntaxFactory(syntax.pipes)
-datamap.colons      = _SyntaxFactory(syntax.colons)
-datamap.at_tags     = _SyntaxFactory(syntax.at_tags)
-datamap.hash_tags   = _SyntaxFactory(syntax.hash_tags)
+datamap.braces        = _SyntaxFactory(syntax.braces)
+datamap.dollars       = _SyntaxFactory(syntax.dollars)
+datamap.angles        = _SyntaxFactory(syntax.angles)
+datamap.percents      = _SyntaxFactory(syntax.percents)
+datamap.pipes         = _SyntaxFactory(syntax.pipes)
+datamap.colons        = _SyntaxFactory(syntax.colons)
+datamap.at_tags       = _SyntaxFactory(syntax.at_tags)
+datamap.hash_tags     = _SyntaxFactory(syntax.hash_tags)
 datamap.paren_dollars = _SyntaxFactory(syntax.paren_dollars)
 
-# global mode shortcut
-datamap.config = datamap(mode='config')
+# global mode shortcuts
+datamap.config   = datamap(mode='config')
+datamap.dynamic  = datamap(mode='dynamic')
+datamap.callable = datamap(mode='callable')

mapres/evaluator.py

@@ -11,15 +11,11 @@ class Evaluator:
         self.ctx = ctx or {}
         self._seen = set()  # cycle detection
 
-    # -----------------------------
-    # PUBLIC API
-    # -----------------------------
+    # public api
     def evaluate(self, node):
         return self._eval(node)
 
-    # -----------------------------
-    # INTERNAL DISPATCH
-    # -----------------------------
+    # internal dispatch
     def _eval(self, node):
         if isinstance(node, TemplateNode):
             return self._eval_template(node)
@@ -35,18 +31,14 @@ class Evaluator:
 
         raise EvaluationError(f"Unknown AST node: {node}")
 
-    # -----------------------------
-    # TEMPLATE
-    # -----------------------------
+    # template
     def _eval_template(self, node: TemplateNode):
         parts = []
         for child in node.children:
             parts.append(self._eval(child))
         return "".join(parts)
 
-    # -----------------------------
-    # IDENTIFIER
-    # -----------------------------
+    # identifier
     def _eval_ident(self, node: IdentNode):
         name = node.name
 
@@ -77,9 +69,7 @@ class Evaluator:
         self._seen.remove(name)
         raise EvaluationError(f"Missing key '{name}'")
 
-    # -----------------------------
-    # CALL (nested token)
-    # -----------------------------
+    # call (nested token)
     def _eval_call(self, node: CallNode):
         outer = node.name
 
@@ -110,9 +100,7 @@ class Evaluator:
         self._seen.remove(outer)
         raise EvaluationError(f"Missing nested key '{outer}({arg_value})'")
 
-    # -----------------------------
-    # HELPERS
-    # -----------------------------
+    # helpers
     def _map_to_dict(self, m):
         if hasattr(m, "as_map"):
             return m.as_map()

{mapres-3.dev8.dist-info → mapres-3.dev10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mapres
-Version: 3.dev8
+Version: 3.dev10
 Summary: A powerfull mapping utility
 Author: iFamished
 License: MIT

{mapres-3.dev8.dist-info → mapres-3.dev10.dist-info}/RECORD

@@ -1,8 +1,8 @@
 mapres/__init__.py,sha256=t23ofM-wzpPByYi1rEQonxyU1yyza4ZzwwHDZUa5QqA,1010
 mapres/ast.py,sha256=6PcMkwtNHYD8xEkdyzDgn_mRTj1ZaWSyuHZK3BtXiuo,427
 mapres/cache.py,sha256=hbvsoc6Qw3RhWAEfOOpKHtC7i9EomoUgWzyd4dnH71w,333
-mapres/datamap.py,sha256=HAflZFD9eh2VRkR9_2aDtXxY3r_A5ZUnpxNJ_VqmFBE,3837
-mapres/evaluator.py,sha256=-MsLxUlmYIOz5IOR5KT8IclJXtABGukLoQVmqkOTqTA,3780
+mapres/datamap.py,sha256=0kfxBSAaIXwT8srkcurPbXBbbpmc_HbAzL-iJ45pKNc,4439
+mapres/evaluator.py,sha256=YZ4SUTMM1XhcxH1Skm2J4QSP6_P79TfuQn33cCekRsI,3348
 mapres/exceptions.py,sha256=jirHKK5yCffSCWWkgZY_gTSIOaFCmXOe5NJJf60HeeQ,130
 mapres/layers.py,sha256=sFc1eUOBg2BoB2cBXIleq8RMYcg5GZpUoCnGh-uKN6U,1380
 mapres/parser.py,sha256=8XLCzYosvh81bN-Jddc1AM4w0X7bsHnBzmA8sq5_72w,4018
@@ -11,8 +11,8 @@ mapres/tokenizer.py,sha256=zw1jhnfypak1bLSTlyo9Xj4UoOF9DJ3y1qqu2OzudiI,5702
 mapres/maps/__init__.py,sha256=lIRRfem1Fw4iynuwUQ7BY5qrC4fbJKxqLivao2_Dtm4,239
 mapres/maps/color.py,sha256=noRTGFNo9xLl5YEhX0tttV6i_oDAiptXmRVnkr5EzwM,1348
 mapres/maps/time.py,sha256=TyncycYoIGVZWps32qWlFy2a2hTayvZWVHu9uh2nid8,2050
-mapres-3.dev8.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-mapres-3.dev8.dist-info/METADATA,sha256=394wGpH8u6Ty7yMaxlW5HfTfky8_9W-wQ2NNNIRZ-dM,1475
-mapres-3.dev8.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
-mapres-3.dev8.dist-info/top_level.txt,sha256=5LMVQqJdtyjxfzv7wJBOZ-360m0Yc79w_-Y7s3n6cTw,7
-mapres-3.dev8.dist-info/RECORD,,
+mapres-3.dev10.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+mapres-3.dev10.dist-info/METADATA,sha256=JEbQIvISO6tzTT-q8T_4vqZ3fbfhjATadPmbiq2LdM0,1476
+mapres-3.dev10.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+mapres-3.dev10.dist-info/top_level.txt,sha256=5LMVQqJdtyjxfzv7wJBOZ-360m0Yc79w_-Y7s3n6cTw,7
+mapres-3.dev10.dist-info/RECORD,,