minecraft-datapack-language 15.4.33__tar.gz → 15.4.35__tar.gz

{minecraft_datapack_language-15.4.33 → minecraft_datapack_language-15.4.35}/CONDITIONALS_IMPLEMENTATION.md

@@ -37,11 +37,11 @@ This document summarizes the implementation of if/else if/else functionality in
 - `README.md` - Added conditional blocks section
 - `docs/_docs/language-reference.md` - Added comprehensive conditional documentation
 - `docs/_docs/examples.md` - Added conditional examples
-- `docs/_docs/python-api.md` - Added conditional Python API examples
+- `docs/_docs/python-bindings.md` - Added conditional Python bindings examples
 
 ### Tests
 - `test_examples/conditionals.mdl` - Comprehensive MDL test file
-- `test_examples/conditionals.py` - Python API test file
+- `test_examples/conditionals.py` - Python bindings test file
 - `test_regression.py` - Regression test suite
 - `test_examples/run_all_tests.py` - Updated to include conditionals
 
@@ -55,12 +55,12 @@ This document summarizes the implementation of if/else if/else functionality in
 - ✅ Conditional function calls
 - ✅ Invalid syntax handling
 - ✅ Regression testing (existing functionality)
-- ✅ Python API compatibility
+- ✅ Python bindings compatibility
 
 ### Test Results
 - **Regression Tests**: 7/7 passed ✅
 - **Comprehensive Tests**: 17/17 passed ✅
-- **Python API Tests**: All passed ✅
+- **Python bindings tests**: All passed ✅
 
 ## 📖 Documentation
 
@@ -152,7 +152,7 @@ execute unless entity @s[type=minecraft:player,nbt={SelectedItem:{id:"minecraft:
 - ✅ Comprehensive testing completed
 - ✅ Documentation updated
 - ✅ Examples created
-- ✅ Python API support
+- ✅ Python bindings support
 - ✅ Regression tests passing
 - ✅ Backward compatibility verified
 - ✅ Error handling implemented

{minecraft_datapack_language-15.4.33/minecraft_datapack_language.egg-info → minecraft_datapack_language-15.4.35}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: minecraft-datapack-language
-Version: 15.4.33
+Version: 15.4.35
 Summary: Compile MDL language with explicit scoping into a Minecraft datapack (1.21+ ready). Features variables, control flow, error handling, and VS Code extension.
 Project-URL: Homepage, https://www.mcmdl.com
 Project-URL: Documentation, https://www.mcmdl.com/docs

{minecraft_datapack_language-15.4.33 → minecraft_datapack_language-15.4.35}/docs/_config.yml

@@ -1,5 +1,5 @@
 title: Minecraft Datapack Language (MDL) v12
-description: A powerful compiler that lets you write Minecraft datapacks in a modern JavaScript-style language (.mdl) or via a clean Python API
+description: A powerful compiler that lets you write Minecraft datapacks in a modern JavaScript-style language (.mdl) or via clean Python bindings
 url: "https://www.mcmdl.com"
 github_username: aaron777collins
 github_repo: MinecraftDatapackLanguage
@@ -68,7 +68,7 @@ nav:
     url: /docs/multi-file-projects/
   - title: CLI Reference
     url: /docs/cli-reference/
-  - title: Python API
+  - title: Python Bindings
     url: /docs/python-api/
   - title: VS Code Extension
     url: /docs/vscode-extension/

minecraft_datapack_language-15.4.35/docs/_data/version.yml

@@ -0,0 +1,3 @@
+current: "15.4.34"
+tag: "v15.4.34"
+updated_at: "2025-09-04T04:59:52Z"

{minecraft_datapack_language-15.4.33 → minecraft_datapack_language-15.4.35}/docs/_docs/contributing.md

@@ -73,9 +73,9 @@ MinecraftDatapackLanguage/
 - **Configuration**: Add configuration options
 - **Integration**: Better integration with other tools
 
-### 3. Python API
+### 3. Python Bindings
 
-- **API improvements**: Enhance the Python API
+- **Bindings improvements**: Enhance the Python bindings
 - **New features**: Add new capabilities
 - **Documentation**: Improve API documentation
 - **Examples**: Add more examples
@@ -135,7 +135,7 @@ python -m pytest
 mdl --help
 mdl build --mdl sample.mdl -o test_output
 
-# Test the Python API
+# Test the Python bindings
 python -c "from minecraft_datapack_language import Pack; print('API works!')"
 ```
 

{minecraft_datapack_language-15.4.33 → minecraft_datapack_language-15.4.35}/docs/_docs/docs-hub.md

@@ -58,7 +58,7 @@ Search and browse all available documentation for the Minecraft Datapack Languag
   </div>
   
   <div class="doc-card" data-categories="python api programming">
-    <h3>🐍 Python API</h3>
+    <h3>🐍 Python Bindings</h3>
     <p>Programmatic access to MDL functionality for automation and integration.</p>
     <div class="doc-meta">
       <span class="category">API</span>

{minecraft_datapack_language-15.4.33 → minecraft_datapack_language-15.4.35}/docs/_docs/documentation.md

@@ -17,12 +17,12 @@ Welcome to the complete documentation for the Minecraft Datapack Language (MDL).
 {% assign language_ref = site.nav | where: "title", "Language Reference" | first %}
 {% assign multi_file = site.nav | where: "title", "Multi-file Projects" | first %}
 {% assign cli_ref = site.nav | where: "title", "CLI Reference" | first %}
-{% assign python_api = site.nav | where: "title", "Python API" | first %}
+{% assign python_api = site.nav | where: "title", "Python Bindings" | first %}
 
 - **[Language Reference]({{ language_ref.url }})** - Complete syntax and language features
 - **[Multi-file Projects]({{ multi_file.url }})** - How to organize and structure larger MDL projects
 - **[CLI Reference]({{ cli_ref.url }})** - Command-line interface usage and options
-- **[Python API]({{ python_api.url }})** - Programmatic access to MDL functionality
+- **[Python Bindings]({{ python_api.url }})** - Programmatic access to MDL functionality
 
 ## Tools and Extensions
 
@@ -64,7 +64,7 @@ Welcome to the complete documentation for the Minecraft Datapack Language (MDL).
   </div>
   
   <div class="doc-card">
-    <h3>🐍 Python API</h3>
+    <h3>🐍 Python Bindings</h3>
     <p>Programmatic access to MDL functionality for automation and integration.</p>
     <a href="{{ python_api.url }}" class="doc-link">API Reference →</a>
   </div>

minecraft_datapack_language-15.4.33/docs/_docs/python-api.md → minecraft_datapack_language-15.4.35/docs/_docs/python-bindings.md

@@ -1,10 +1,10 @@
 ---
 layout: page
-title: Python API
-permalink: /docs/python-api/
+title: Python Bindings
+permalink: /docs/python-bindings/
 ---
 
-The MDL Python API provides a clean, programmatic way to create Minecraft datapacks. It's fully compatible with the new JavaScript-style MDL language and supports all advanced features including variables, control flow, complex nesting, and the explicit scope system.
+The MDL Python bindings provide a clean, programmatic way to create Minecraft datapacks. They're fully compatible with the MDL language and support all advanced features including variables, control flow, complex nesting, and the explicit scope system.
 
 ## Quick Start
 
@@ -67,6 +67,36 @@ ns.function("function_name", "command1", "command2", ...)
 **Methods:**
 - `function(name, *commands)` - Add a function with commands
 
+### Control Flow and Expressions (Bindings)
+
+Bindings include helpers to compose expressions and control flow identical to MDL:
+
+```python
+from minecraft_datapack_language import Pack
+from minecraft_datapack_language.python_api import num, var_read, binop
+
+p = Pack("Control Flow", "desc", 82)
+ns = p.namespace("game")
+
+def build_logic(fb):
+    # declare variable
+    fb.declare_var("counter", "<@s>", 0)
+
+    # counter<@s> = $counter<@s>$ + 1
+    fb.set("counter", "<@s>", binop(var_read("counter", "<@s>"), "PLUS", num(1)))
+
+    # if $counter<@s>$ > 5 { say "hi" } else { say "low" }
+    cond = binop(var_read("counter", "<@s>"), "GREATER", num(5))
+    fb.if_(cond, lambda t: t.say("hi"), lambda e: e.say("low"))
+
+    # while $counter<@s>$ < 10 { counter<@s> = $counter<@s>$ + 1 }
+    wcond = binop(var_read("counter", "<@s>"), "LESS", num(10))
+    fb.while_(wcond, lambda b: b.set("counter", "<@s>", binop(var_read("counter", "<@s>"), "PLUS", num(1))))
+
+ns.function("main", build_logic)
+p.build("dist")
+```
+
 ## Basic Examples
 
 ### Hello World
@@ -121,7 +151,7 @@ def create_particle_pack():
 
 ### Variables and Control Flow
 
-The Python API supports all the advanced features of the JavaScript-style MDL language including the explicit scope system:
+The bindings support all the advanced features of the MDL language including the explicit scope system:
 
 ```python
 from minecraft_datapack_language import Pack
@@ -327,7 +357,7 @@ p.build("output_dir", wrapper="my_pack")
 
 ## Integration with MDL Files
 
-You can use the Python API alongside MDL files:
+You can use the Python bindings alongside MDL files:
 
 ```python
 from minecraft_datapack_language import Pack
@@ -340,7 +370,7 @@ def create_hybrid_pack():
     
     ast = parse_mdl_js(mdl_content)
     
-    # Create pack via Python API
+    # Create pack via Python bindings
     p = Pack("Hybrid Pack", "Combines MDL and Python", 82)
     
     # Add functions from MDL
@@ -348,7 +378,7 @@ def create_hybrid_pack():
         ns = p.namespace(func.namespace)
         ns.function(func.name, *func.commands)
     
-    # Add additional functions via Python API
+    # Add additional functions via Python bindings
     ns = p.namespace("python")
     ns.function("python_func", "say Created via Python API!")
     
@@ -505,4 +535,4 @@ if __name__ == "__main__":
     print("Complete example pack built successfully!")
 ```
 
-The Python API provides a powerful, flexible way to create Minecraft datapacks with full support for the JavaScript-style MDL language features including the new explicit scope system.
+The Python bindings provide a powerful, flexible way to create Minecraft datapacks with full support for the MDL language features including the explicit scope system.

{minecraft_datapack_language-15.4.33 → minecraft_datapack_language-15.4.35}/docs/docs.md

@@ -16,12 +16,12 @@ Welcome to the complete documentation for the Minecraft Datapack Language (MDL).
 {% assign language_ref = site.nav | where: "title", "Language Reference" | first %}
 {% assign multi_file = site.nav | where: "title", "Multi-file Projects" | first %}
 {% assign cli_ref = site.nav | where: "title", "CLI Reference" | first %}
-{% assign python_api = site.nav | where: "title", "Python API" | first %}
+{% assign python_api = site.nav | where: "title", "Python Bindings" | first %}
 
 - **[Language Reference]({{ language_ref.url }})** - Complete syntax and language features
 - **[Multi-file Projects]({{ multi_file.url }})** - How to organize and structure larger MDL projects
 - **[CLI Reference]({{ cli_ref.url }})** - Command-line interface usage and options
-- **[Python API]({{ python_api.url }})** - Programmatic access to MDL functionality
+- **[Python Bindings]({{ python_api.url }})** - Programmatic access to MDL functionality
 
 ## Tools and Extensions
 
@@ -63,7 +63,7 @@ Welcome to the complete documentation for the Minecraft Datapack Language (MDL).
   </div>
   
   <div class="doc-card">
-    <h3>🐍 Python API</h3>
+    <h3>🐍 Python Bindings</h3>
     <p>Programmatic access to MDL functionality for automation and integration.</p>
     <a href="{{ python_api.url }}" class="doc-link">API Reference →</a>
   </div>

{minecraft_datapack_language-15.4.33 → minecraft_datapack_language-15.4.35}/docs/index.md

@@ -74,13 +74,13 @@ A **modern JavaScript-style compiler** that lets you write Minecraft datapacks w
     <a href="{{ site.baseurl }}/docs/multi-file-projects/" class="doc-link">Learn More →</a>
   </div>
   <div class="doc-card">
-    <h3>🐍 Python API</h3>
+    <h3>🐍 Python Bindings</h3>
     <p>Programmatic datapack creation</p>
     <div class="doc-meta">
       <span class="category">API</span>
       <span class="category">Python</span>
     </div>
-    <a href="{{ site.baseurl }}/docs/python-api/" class="doc-link">Python API →</a>
+    <a href="{{ site.baseurl }}/docs/python-bindings/" class="doc-link">Python Bindings →</a>
   </div>
 </div>
 

{minecraft_datapack_language-15.4.33 → minecraft_datapack_language-15.4.35}/minecraft_datapack_language/__init__.py

@@ -3,6 +3,7 @@ from .mdl_lexer import MDLLexer, Token, TokenType
 from .mdl_parser import MDLParser
 from .ast_nodes import *
 from .dir_map import DirMap
+from .python_api import Pack
 
 __all__ = [
     "MDLLexer", "Token", "TokenType",
@@ -13,7 +14,8 @@ __all__ = [
     "SayCommand", "TellrawCommand", "ExecuteCommand", "ScoreboardCommand",
     "BinaryExpression", "UnaryExpression", "ParenthesizedExpression", "LiteralExpression",
     "ScopeSelector",
-    "DirMap"
+    "DirMap",
+    "Pack"
 ]
 
 # CLI entry point

{minecraft_datapack_language-15.4.33 → minecraft_datapack_language-15.4.35}/minecraft_datapack_language/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '15.4.33'
-__version_tuple__ = version_tuple = (15, 4, 33)
+__version__ = version = '15.4.35'
+__version_tuple__ = version_tuple = (15, 4, 35)
 
-__commit_id__ = commit_id = 'gf8b0c72b5'
+__commit_id__ = commit_id = 'gc1645a725'

{minecraft_datapack_language-15.4.33 → minecraft_datapack_language-15.4.35}/minecraft_datapack_language/mdl_compiler.py

@@ -152,6 +152,12 @@ class MDLCompiler:
         if hasattr(self, 'temp_commands'):
             self.temp_commands = []
         
+        # Set current function context and reset per-function counters
+        self._current_function_name = func.name
+        self.if_counter = 0
+        self.else_counter = 0
+        self.while_counter = 0
+        
         # Generate commands from function body
         for statement in func.body:
             cmd = self._statement_to_command(statement)
@@ -231,6 +237,12 @@ class MDLCompiler:
         load_file = functions_dir / "load.mcfunction"
         with open(load_file, 'w') as f:
             f.write(load_content)
+        # Ensure minecraft load tag points to namespace:load
+        tags_fn_dir = self.output_dir / "data" / "minecraft" / self.dir_map.tags_function
+        tags_fn_dir.mkdir(parents=True, exist_ok=True)
+        load_tag_file = tags_fn_dir / "load.json"
+        with open(load_tag_file, 'w') as f:
+            json.dump({"values": [f"{self.current_namespace}:load"]}, f, indent=2)
         
         # Create tick function if needed
         tick_hooks = [h for h in hooks if h.hook_type == "on_tick"]
@@ -239,6 +251,10 @@ class MDLCompiler:
             tick_file = functions_dir / "tick.mcfunction"
             with open(tick_file, 'w') as f:
                 f.write(tick_content)
+            # Ensure minecraft tick tag points to namespace:tick
+            tick_tag_file = tags_fn_dir / "tick.json"
+            with open(tick_tag_file, 'w') as f:
+                json.dump({"values": [f"{self.current_namespace}:tick"]}, f, indent=2)
     
     def _generate_load_function(self, hooks: List[HookDeclaration]) -> str:
         """Generate the content of load.mcfunction."""
@@ -487,10 +503,8 @@ class MDLCompiler:
                 loop_body_lines.append(cmd)
         
         # Add the recursive call at the end to continue the loop
-        if self._is_scoreboard_condition(while_loop.condition):
-            loop_body_lines.append(f"execute if score {condition} run function {self.current_namespace}:{loop_function_name}")
-        else:
-            loop_body_lines.append(f"execute if {condition} run function {self.current_namespace}:{loop_function_name}")
+        cond_str, _inv = self._build_condition(while_loop.condition)
+        loop_body_lines.append(f"execute if {cond_str} run function {self.current_namespace}:{loop_function_name}")
         
         # Store the loop function as its own file
         self._store_generated_function(loop_function_name, loop_body_lines)
@@ -507,24 +521,21 @@ class MDLCompiler:
     
     def _generate_if_function_name(self) -> str:
         """Generate a unique name for an if function."""
-        if not hasattr(self, 'if_counter'):
-            self.if_counter = 0
         self.if_counter += 1
-        return f"if_{self.if_counter}"
+        prefix = getattr(self, '_current_function_name', 'fn')
+        return f"{prefix}__if_{self.if_counter}"
     
     def _generate_else_function_name(self) -> str:
         """Generate a unique name for an else function."""
-        if not hasattr(self, 'else_counter'):
-            self.else_counter = 0
         self.else_counter += 1
-        return f"else_{self.else_counter}"
+        prefix = getattr(self, '_current_function_name', 'fn')
+        return f"{prefix}__else_{self.else_counter}"
     
     def _generate_while_function_name(self) -> str:
         """Generate a unique name for a while function."""
-        if not hasattr(self, 'while_counter'):
-            self.while_counter = 0
         self.while_counter += 1
-        return f"while_{self.while_counter}"
+        prefix = getattr(self, '_current_function_name', 'fn')
+        return f"{prefix}__while_{self.while_counter}"
     
     def _store_generated_function(self, name: str, lines: List[str]):
         """Store a generated function as a separate file under the same namespace."""

minecraft_datapack_language-15.4.35/minecraft_datapack_language/python_api.py

@@ -0,0 +1,207 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Callable, List, Optional, Union
+
+from .ast_nodes import (
+    Program,
+    PackDeclaration,
+    NamespaceDeclaration,
+    TagDeclaration,
+    VariableDeclaration,
+    VariableAssignment,
+    VariableSubstitution,
+    FunctionDeclaration,
+    FunctionCall,
+    IfStatement,
+    WhileLoop,
+    RawBlock,
+    SayCommand,
+    BinaryExpression,
+    LiteralExpression,
+)
+from .mdl_compiler import MDLCompiler
+
+
+# ---------- Expression helpers ----------
+
+def num(value: Union[int, float]) -> LiteralExpression:
+    return LiteralExpression(value=value, type="number")
+
+
+def var_read(name: str, scope: str) -> VariableSubstitution:
+    # scope must look like <@s>, <@a>, <@e[...]>, or <global>
+    return VariableSubstitution(name=name, scope=scope)
+
+
+def binop(left, operator: str, right) -> BinaryExpression:
+    # operator one of: PLUS, MINUS, MULTIPLY, DIVIDE, GREATER, LESS, GREATER_EQUAL, LESS_EQUAL, EQUAL, NOT_EQUAL
+    return BinaryExpression(left=left, operator=operator, right=right)
+
+
+# ---------- Python Bindings ----------
+
+
+class Pack:
+    def __init__(self, name: str, description: str = "", pack_format: int = 82):
+        self._pack = PackDeclaration(name=name, description=description, pack_format=pack_format)
+        self._namespaces: List[Namespace] = []
+        self._variables: List[VariableDeclaration] = []
+        self._tags: List[TagDeclaration] = []
+        self._hooks: List = []  # HookDeclaration built by Namespace
+
+    def namespace(self, name: str) -> "Namespace":
+        ns = Namespace(self, name)
+        self._namespaces.append(ns)
+        return ns
+
+    # Lifecycle hooks reference functions by id "ns:name"
+    def on_load(self, function_id: str, scope: Optional[str] = None):
+        # defer to Namespace to create HookDeclaration during build
+        self._hooks.append(("on_load", function_id, scope))
+
+    def on_tick(self, function_id: str, scope: Optional[str] = None):
+        self._hooks.append(("on_tick", function_id, scope))
+
+    def tag(self, registry: str, name: str, values: Optional[List[str]] = None, replace: bool = False):
+        values = values or []
+        # We store TagDeclaration; the compiler writes tag files based on tag_type/name/file_path
+        # Here, we map registry + name to a tag reference name; file_path left as name for placeholder.
+        self._tags.append(TagDeclaration(tag_type=registry, name=name, file_path=name))
+
+    def declare_var(self, name: str, scope: str, initial_value: Union[int, float]) -> None:
+        self._variables.append(
+            VariableDeclaration(var_type="num", name=name, scope=scope, initial_value=num(initial_value))
+        )
+
+    def build(self, output_dir: str):
+        # Build Program AST
+        namespace_nodes: List[NamespaceDeclaration] = []
+        function_nodes: List[FunctionDeclaration] = []
+        hook_nodes: List = []
+
+        # Namespaces and functions
+        for ns in self._namespaces:
+            namespace_nodes.append(NamespaceDeclaration(name=ns.name))
+            function_nodes.extend(ns._functions)
+            hook_nodes.extend(ns._hooks)
+
+        # Hooks added via Pack-level convenience
+        for hook_type, function_id, scope in self._hooks:
+            ns_name, fn_name = function_id.split(":", 1)
+            from .ast_nodes import HookDeclaration
+
+            hook_nodes.append(
+                HookDeclaration(hook_type=hook_type, namespace=ns_name, name=fn_name, scope=scope)
+            )
+
+        program = Program(
+            pack=self._pack,
+            namespace=namespace_nodes[0] if namespace_nodes else None,
+            tags=self._tags,
+            variables=self._variables,
+            functions=function_nodes,
+            hooks=hook_nodes,
+            statements=[],
+        )
+
+        MDLCompiler(output_dir).compile(program, output_dir)
+
+
+class Namespace:
+    def __init__(self, pack: Pack, name: str):
+        self._pack = pack
+        self.name = name
+        self._functions: List[FunctionDeclaration] = []
+        self._hooks: List = []
+
+    def function(self, name: str, *commands_or_builder: Union[str, Callable[["FunctionBuilder"], None]]):
+        builder = FunctionBuilder(self._pack, self, name)
+
+        # If a single callable is given, treat it as a builder lambda
+        if len(commands_or_builder) == 1 and callable(commands_or_builder[0]):
+            commands_or_builder[0](builder)
+        else:
+            # Interpret simple strings: say "..."; exec ns:name; raw lines fall back to RawBlock
+            for cmd in commands_or_builder:
+                if not isinstance(cmd, str):
+                    continue
+                stripped = cmd.strip().rstrip(";")
+                if stripped.startswith("say "):
+                    msg = stripped[len("say ") :].strip()
+                    if msg.startswith("\"") and msg.endswith("\""):
+                        msg = msg[1:-1]
+                    builder.say(msg)
+                elif stripped.startswith("exec "):
+                    target = stripped[len("exec ") :].strip()
+                    # Optional scope in angle brackets e.g., util:helper<@s>
+                    scope = None
+                    if "<" in target and target.endswith(">"):
+                        scope = target[target.index("<") :]
+                        target = target[: target.index("<")]
+                    builder.exec(target, scope)
+                else:
+                    builder.raw(cmd)
+
+        func_node = FunctionDeclaration(namespace=self.name, name=name, scope=None, body=builder._body)
+        self._functions.append(func_node)
+        return func_node
+
+    # Convenience forwarding
+    def on_load(self, function_id: str, scope: Optional[str] = None):
+        from .ast_nodes import HookDeclaration
+
+        ns_name, fn_name = function_id.split(":", 1)
+        self._hooks.append(HookDeclaration(hook_type="on_load", namespace=ns_name, name=fn_name, scope=scope))
+
+    def on_tick(self, function_id: str, scope: Optional[str] = None):
+        from .ast_nodes import HookDeclaration
+
+        ns_name, fn_name = function_id.split(":", 1)
+        self._hooks.append(HookDeclaration(hook_type="on_tick", namespace=ns_name, name=fn_name, scope=scope))
+
+
+class FunctionBuilder:
+    def __init__(self, pack: Pack, namespace: Namespace, function_name: str):
+        self._pack = pack
+        self._namespace = namespace
+        self._name = function_name
+        self._body: List = []
+
+    # Basics
+    def say(self, message: str):
+        self._body.append(SayCommand(message=message, variables=[]))
+
+    def raw(self, content: str):
+        self._body.append(RawBlock(content=content.rstrip(";")))
+
+    def exec(self, function_id: str, scope: Optional[str] = None):
+        ns, fn = function_id.split(":", 1)
+        self._body.append(FunctionCall(namespace=ns, name=fn, scope=scope))
+
+    # Variables
+    def declare_var(self, name: str, scope: str, initial_value: Union[int, float]):
+        self._pack.declare_var(name, scope, initial_value)
+        # Also set to initial value in this function
+        self.set(name, scope, num(initial_value))
+
+    def set(self, name: str, scope: str, value_expr) -> None:
+        self._body.append(VariableAssignment(name=name, scope=scope, value=value_expr))
+
+    # Control flow
+    def if_(self, condition_expr, then_builder: Callable[["FunctionBuilder"], None], else_builder: Optional[Callable[["FunctionBuilder"], None]] = None):
+        then_fb = FunctionBuilder(self._pack, self._namespace, self._name)
+        then_builder(then_fb)
+        else_body = None
+        if else_builder:
+            else_fb = FunctionBuilder(self._pack, self._namespace, self._name)
+            else_builder(else_fb)
+            else_body = else_fb._body
+        self._body.append(IfStatement(condition=condition_expr, then_body=then_fb._body, else_body=else_body))
+
+    def while_(self, condition_expr, body_builder: Callable[["FunctionBuilder"], None]):
+        body_fb = FunctionBuilder(self._pack, self._namespace, self._name)
+        body_builder(body_fb)
+        self._body.append(WhileLoop(condition=condition_expr, body=body_fb._body))
+
+

{minecraft_datapack_language-15.4.33 → minecraft_datapack_language-15.4.35/minecraft_datapack_language.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: minecraft-datapack-language
-Version: 15.4.33
+Version: 15.4.35
 Summary: Compile MDL language with explicit scoping into a Minecraft datapack (1.21+ ready). Features variables, control flow, error handling, and VS Code extension.
 Project-URL: Homepage, https://www.mcmdl.com
 Project-URL: Documentation, https://www.mcmdl.com/docs

{minecraft_datapack_language-15.4.33 → minecraft_datapack_language-15.4.35}/minecraft_datapack_language.egg-info/SOURCES.txt

@@ -28,6 +28,7 @@ test_simple.mdl
 ./minecraft_datapack_language/mdl_lexer.py
 ./minecraft_datapack_language/mdl_linter.py
 ./minecraft_datapack_language/mdl_parser.py
+./minecraft_datapack_language/python_api.py
 ./minecraft_datapack_language/utils.py
 .cursor/rules/aispec.mdc
 .github/actions/mdl-compile/action.yml
@@ -248,7 +249,7 @@ docs/_docs/examples.md
 docs/_docs/getting-started.md
 docs/_docs/language-reference.md
 docs/_docs/multi-file-projects.md
-docs/_docs/python-api.md
+docs/_docs/python-bindings.md
 docs/_docs/vscode-extension.md
 docs/_includes/head-custom.html
 docs/_includes/navigation.html
@@ -294,6 +295,7 @@ minecraft_datapack_language/mdl_errors.py
 minecraft_datapack_language/mdl_lexer.py
 minecraft_datapack_language/mdl_linter.py
 minecraft_datapack_language/mdl_parser.py
+minecraft_datapack_language/python_api.py
 minecraft_datapack_language/utils.py
 minecraft_datapack_language.egg-info/PKG-INFO
 minecraft_datapack_language.egg-info/SOURCES.txt
@@ -347,10 +349,12 @@ test_project/complex_test.mdl
 tests/__init__.py
 tests/run_all_tests.py
 tests/test_cli.py
+tests/test_codegen_naming_and_logic.py
 tests/test_compiler_fixes.py
 tests/test_complex_scenarios.py
 tests/test_comprehensive_end_to_end.py
 tests/test_python_api.py
+tests/test_python_bindings.py
 vscode-extension/README.md
 vscode-extension/language-configuration.json
 vscode-extension/package-lock.json

{minecraft_datapack_language-15.4.33 → minecraft_datapack_language-15.4.35}/pytest.ini

@@ -19,6 +19,6 @@ markers =
     compiler: Compiler-specific tests
     parser: Parser-specific tests
     lexer: Lexer-specific tests
-    python_api: Python API tests
+    python_bindings: Python bindings tests
     cli: CLI tests
     slow: Slow running tests

{minecraft_datapack_language-15.4.33 → minecraft_datapack_language-15.4.35}/tests/run_all_tests.py

@@ -78,7 +78,7 @@ def main():
         ("test_comprehensive_end_to_end.py", "End-to-end comprehensive tests"),
         ("test_complex_scenarios.py", "Complex scenario tests"),
         ("test_compiler_fixes.py", "Compiler fix verification tests"),
-        ("test_python_api.py", "Python API tests"),
+        ("test_python_bindings.py", "Python bindings tests"),
         ("test_cli.py", "CLI functionality tests"),
     ]
     
@@ -122,13 +122,13 @@ def main():
     results.append(("Function Execution", function_result))
     
     # 4. Test Python API
-    print("\nTesting Python API...")
+    print("\nTesting Python bindings...")
     api_result = run_test_suite(
-        "Python API Basic",
+        "Python Bindings Basic",
         "python -c \"from minecraft_datapack_language import Pack; import tempfile; from pathlib import Path; p = Pack('Test', 'Test pack', 82); ns = p.namespace('test'); ns.function('hello', 'say Hello World!'); with tempfile.TemporaryDirectory() as temp_dir: p.build(temp_dir); output = Path(temp_dir) / 'data' / 'test' / 'function' / 'hello.mcfunction'; assert output.exists(); print('Python API test successful')\"",
-        "Test basic Python API functionality"
+        "Test basic Python bindings functionality"
     )
-    results.append(("Python API", api_result))
+    results.append(("Python Bindings", api_result))
     
     # 5. Test CLI
     print("\nTesting CLI...")