minecraft-datapack-language 15.4.29__py3-none-any.whl → 15.4.30__py3-none-any.whl

minecraft_datapack_language/__init__.py

@@ -16,6 +16,12 @@ __all__ = [
     "DirMap"
 ]
 
+# CLI entry point
+def main():
+    """CLI entry point for the mdl command."""
+    from .cli import main as cli_main
+    return cli_main()
+
 try:
     from ._version import version as __version__   # written by setuptools-scm
 except Exception:

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.29'
-__version_tuple__ = version_tuple = (15, 4, 29)
+__version__ = version = '15.4.30'
+__version_tuple__ = version_tuple = (15, 4, 30)
 
 __commit_id__ = commit_id = None

minecraft_datapack_language/cli.py

@@ -0,0 +1,296 @@
+#!/usr/bin/env python3
+"""
+MDL CLI - Command Line Interface for Minecraft Datapack Language
+"""
+
+import argparse
+import sys
+import os
+from pathlib import Path
+from .mdl_lexer import MDLLexer
+from .mdl_parser import MDLParser
+from .mdl_compiler import MDLCompiler
+from .mdl_errors import MDLLexerError, MDLParserError, MDLCompilerError
+
+
+def main():
+    """Main CLI entry point."""
+    parser = argparse.ArgumentParser(
+        description="MDL (Minecraft Datapack Language) - Compile MDL files to Minecraft datapacks",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  mdl build --mdl main.mdl -o dist          # Build a single MDL file
+  mdl build --mdl . -o dist                 # Build all MDL files in current directory
+  mdl check main.mdl                        # Check syntax without building
+  mdl new my_project                        # Create a new project
+        """
+    )
+    
+    subparsers = parser.add_subparsers(dest='command', help='Available commands')
+    
+    # Build command
+    build_parser = subparsers.add_parser('build', help='Build MDL files into a datapack')
+    build_parser.add_argument('--mdl', required=True, help='MDL file(s) or directory to build')
+    build_parser.add_argument('-o', '--output', required=True, help='Output directory for the datapack')
+    build_parser.add_argument('--verbose', action='store_true', help='Show detailed output')
+    
+    # Check command
+    check_parser = subparsers.add_parser('check', help='Check MDL files for syntax errors')
+    check_parser.add_argument('files', nargs='+', help='MDL files to check')
+    check_parser.add_argument('--verbose', action='store_true', help='Show detailed output')
+    
+    # New command
+    new_parser = subparsers.add_parser('new', help='Create a new MDL project')
+    new_parser.add_argument('project_name', help='Name of the new project')
+    new_parser.add_argument('--pack-name', help='Custom name for the datapack')
+    new_parser.add_argument('--pack-format', type=int, default=82, help='Pack format number (default: 82)')
+    
+    args = parser.parse_args()
+    
+    if not args.command:
+        parser.print_help()
+        return 1
+    
+    try:
+        if args.command == 'build':
+            return build_command(args)
+        elif args.command == 'check':
+            return check_command(args)
+        elif args.command == 'new':
+            return new_command(args)
+        else:
+            print(f"Unknown command: {args.command}")
+            return 1
+    except Exception as e:
+        print(f"Error: {e}")
+        if args.verbose:
+            import traceback
+            traceback.print_exc()
+        return 1
+
+
+def build_command(args):
+    """Build MDL files into a datapack."""
+    mdl_path = Path(args.mdl)
+    output_dir = Path(args.output)
+    
+    if not mdl_path.exists():
+        print(f"Error: MDL path '{mdl_path}' does not exist")
+        return 1
+    
+    # Determine what to build
+    if mdl_path.is_file():
+        mdl_files = [mdl_path]
+    elif mdl_path.is_dir():
+        mdl_files = list(mdl_path.glob("**/*.mdl"))
+        if not mdl_files:
+            print(f"Error: No .mdl files found in directory '{mdl_path}'")
+            return 1
+    else:
+        print(f"Error: Invalid MDL path '{mdl_path}'")
+        return 1
+    
+    if args.verbose:
+        print(f"Building {len(mdl_files)} MDL file(s)...")
+        for f in mdl_files:
+            print(f"  {f}")
+    
+    # Parse and compile each file
+    all_asts = []
+    for mdl_file in mdl_files:
+        try:
+            with open(mdl_file, 'r', encoding='utf-8') as f:
+                source = f.read()
+            
+            if args.verbose:
+                print(f"Parsing {mdl_file}...")
+            
+            parser = MDLParser(str(mdl_file))
+            ast = parser.parse(source)
+            all_asts.append(ast)
+            
+        except (MDLLexerError, MDLParserError) as e:
+            print(f"Error in {mdl_file}: {e}")
+            return 1
+    
+    # Merge all ASTs if multiple files
+    if len(all_asts) == 1:
+        final_ast = all_asts[0]
+    else:
+        # Merge multiple ASTs
+        final_ast = all_asts[0]
+        for ast in all_asts[1:]:
+            final_ast.variables.extend(ast.variables)
+            final_ast.functions.extend(ast.functions)
+            final_ast.tags.extend(ast.tags)
+            final_ast.hooks.extend(ast.hooks)
+            final_ast.statements.extend(ast.statements)
+    
+    # Compile
+    try:
+        if args.verbose:
+            print(f"Compiling to {output_dir}...")
+        
+        compiler = MDLCompiler()
+        output_path = compiler.compile(final_ast, str(output_dir))
+        
+        print(f"Successfully built datapack: {output_path}")
+        return 0
+        
+    except MDLCompilerError as e:
+        print(f"Compilation error: {e}")
+        return 1
+
+
+def check_command(args):
+    """Check MDL files for syntax errors."""
+    all_errors = []
+    
+    for file_path in args.files:
+        file_path = Path(file_path)
+        if not file_path.exists():
+            print(f"Error: File '{file_path}' does not exist")
+            continue
+        
+        try:
+            with open(file_path, 'r', encoding='utf-8') as f:
+                source = f.read()
+            
+            if args.verbose:
+                print(f"Checking {file_path}...")
+            
+            # Lex and parse to check for errors
+            lexer = MDLLexer(str(file_path))
+            tokens = list(lexer.lex(source))
+            
+            parser = MDLParser(str(file_path))
+            ast = parser.parse(source)
+            
+            if args.verbose:
+                print(f"  ✓ {file_path} - {len(ast.functions)} functions, {len(ast.variables)} variables")
+            
+        except MDLLexerError as e:
+            print(f"Lexer error in {file_path}: {e}")
+            all_errors.append(e)
+        except MDLParserError as e:
+            print(f"Parser error in {file_path}: {e}")
+            all_errors.append(e)
+        except Exception as e:
+            print(f"Unexpected error in {file_path}: {e}")
+            all_errors.append(e)
+    
+    if all_errors:
+        print(f"\nFound {len(all_errors)} error(s)")
+        return 1
+    else:
+        print("All files passed syntax check!")
+        return 0
+
+
+def new_command(args):
+    """Create a new MDL project."""
+    project_name = args.project_name
+    pack_name = args.pack_name or project_name
+    pack_format = args.pack_format
+    
+    # Create project directory
+    project_dir = Path(project_name)
+    if project_dir.exists():
+        print(f"Error: Project directory '{project_name}' already exists")
+        return 1
+    
+    project_dir.mkdir(parents=True)
+    
+    # Create main MDL file
+    mdl_file = project_dir / f"{project_name}.mdl"
+    
+    template_content = f'''pack "{pack_name}" "Generated by MDL CLI" {pack_format};
+namespace "{project_name}";
+
+// Variables
+var num counter<@s> = 0;
+var num global_timer<@a> = 0;
+
+// Main function
+function {project_name}:main<@s> {{
+    say "Hello from {project_name}!";
+    
+    // Variable example
+    counter<@s> = 10;
+    say "Counter: $counter<@s>$";
+    
+    // Conditional example
+    if $counter<@s>$ > 5 {{
+        say "High counter!";
+    }} else {{
+        say "Try again!";
+    }}
+}}
+
+// Load function
+function {project_name}:load<@s> {{
+    say "Datapack loaded successfully!";
+}}
+
+// Hook to run on load
+on_load {project_name}:load<@s>;
+'''
+    
+    with open(mdl_file, 'w', encoding='utf-8') as f:
+        f.write(template_content)
+    
+    # Create README
+    readme_file = project_dir / "README.md"
+    readme_content = f'''# {project_name}
+
+A Minecraft datapack created with MDL (Minecraft Datapack Language).
+
+## Getting Started
+
+1. **Build the datapack:**
+   ```bash
+   mdl build --mdl {project_name}.mdl -o dist
+   ```
+
+2. **Install in Minecraft:**
+   - Copy `dist/{project_name}/` to your world's `datapacks/` folder
+   - Run `/reload` in-game
+
+3. **Run the main function:**
+   ```bash
+   /function {project_name}:main
+   ```
+
+## Features
+
+- **Variables**: Player-scoped counter and global timer
+- **Control Flow**: If/else statements
+- **Functions**: Main function and load hook
+- **Automatic Execution**: Runs on datapack load
+
+## Development
+
+- Edit `{project_name}.mdl` to modify the datapack
+- Use `mdl check {project_name}.mdl` to validate syntax
+- Use `mdl build --mdl {project_name}.mdl -o dist` to rebuild
+
+For more information, visit: https://www.mcmdl.com
+'''
+    
+    with open(readme_file, 'w', encoding='utf-8') as f:
+        f.write(readme_content)
+    
+    print(f"Created new MDL project: {project_name}/")
+    print(f"  - {mdl_file}")
+    print(f"  - {readme_file}")
+    print(f"\nNext steps:")
+    print(f"  1. cd {project_name}")
+    print(f"  2. mdl build --mdl {project_name}.mdl -o dist")
+    print(f"  3. Copy dist/{project_name}/ to your Minecraft world's datapacks folder")
+    
+    return 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())

{minecraft_datapack_language-15.4.29.dist-info → minecraft_datapack_language-15.4.30.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: minecraft-datapack-language
-Version: 15.4.29
+Version: 15.4.30
 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.29.dist-info → minecraft_datapack_language-15.4.30.dist-info}/RECORD

@@ -1,6 +1,7 @@
-minecraft_datapack_language/__init__.py,sha256=c5k0fBKRAxF0557G2v-cYEIlWMenxpZvqF4Vc-a2h_w,1020
-minecraft_datapack_language/_version.py,sha256=rnQ_6GFc2eBI-vGa-wlHgmkGjEcl6g4Z2WASG1ABT3g,708
+minecraft_datapack_language/__init__.py,sha256=YoTmZWZVH6POAVYMvOTEBKdC-cxQsWi2VomSWZDgYFw,1158
+minecraft_datapack_language/_version.py,sha256=RNZhwzYxN2eHj_5xQ53YZcxK_zAZYSM3MZOH61TI9KQ,708
 minecraft_datapack_language/ast_nodes.py,sha256=nbWrRz137MGMRpmnq8QkXNzrtlaCgyPEknytbkrS_M8,3899
+minecraft_datapack_language/cli.py,sha256=dy1KBDULHpaHYYzNfL42EuhOAB5_GTfSVt7_bMImSno,9000
 minecraft_datapack_language/dir_map.py,sha256=HmxFkuvWGkzHF8o_GFb4BpuMCRc6QMw8UbmcAI8JVdY,1788
 minecraft_datapack_language/mdl_compiler.py,sha256=GQv2CD29aj8vxhqRczTn_2JjNn6hiHQ4XoU2qh-s1n4,20429
 minecraft_datapack_language/mdl_errors.py,sha256=r0Gu3KhoX1YLPAVW_iO7Q_fPgaf_Dv9tOGSOdKNSzmw,16114
@@ -8,9 +9,9 @@ minecraft_datapack_language/mdl_lexer.py,sha256=CjbEUpuuF4eU_ucA_WIhw6wSMcHGk2Bc
 minecraft_datapack_language/mdl_linter.py,sha256=z85xoAglENurCh30bR7kEHZ_JeMxcYaLDcGNRAl-RAI,17253
 minecraft_datapack_language/mdl_parser.py,sha256=aQPKcmATM9BOMzO7vCXmMdxU1qjOJNLCSAKJopu5h3g,23429
 minecraft_datapack_language/utils.py,sha256=Aq0HAGlXqj9BUTEjaEilpvzEW0EtZYYMMwOqG9db6dE,684
-minecraft_datapack_language-15.4.29.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-minecraft_datapack_language-15.4.29.dist-info/METADATA,sha256=NtDozp6aH8Laa8M8Dh9uWw7mt3EtqTK9QQQdaFImcT8,8475
-minecraft_datapack_language-15.4.29.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-minecraft_datapack_language-15.4.29.dist-info/entry_points.txt,sha256=c6vjBeCiyQflvPHBRyBk2nJCSfYt3Oc7Sc9V87ySi_U,108
-minecraft_datapack_language-15.4.29.dist-info/top_level.txt,sha256=ADtFI476tbKLLxEAA-aJQAfg53MA3k_DOb0KTFiggfw,28
-minecraft_datapack_language-15.4.29.dist-info/RECORD,,
+minecraft_datapack_language-15.4.30.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+minecraft_datapack_language-15.4.30.dist-info/METADATA,sha256=H6Y7lVMRongNa0nvQPE8xUEaIt7h1WLyp92hlsg1doo,8475
+minecraft_datapack_language-15.4.30.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+minecraft_datapack_language-15.4.30.dist-info/entry_points.txt,sha256=c6vjBeCiyQflvPHBRyBk2nJCSfYt3Oc7Sc9V87ySi_U,108
+minecraft_datapack_language-15.4.30.dist-info/top_level.txt,sha256=ADtFI476tbKLLxEAA-aJQAfg53MA3k_DOb0KTFiggfw,28
+minecraft_datapack_language-15.4.30.dist-info/RECORD,,