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

minecraft_datapack_language/cli_new.py

@@ -1,300 +0,0 @@
-"""
-CLI New Project - Create new MDL projects with templates
-"""
-
-import os
-import shutil
-from pathlib import Path
-from typing import Optional
-
-from .cli_utils import _slugify
-
-
-def create_new_project(project_name: str, pack_name: str = None, pack_format: int = 82) -> None:
-    """Create a new MDL project with template files."""
-    # Validate project name
-    if not project_name or not project_name.strip():
-        raise ValueError("Project name cannot be empty")
-    
-    # Clean and validate project name
-    clean_name = _slugify(project_name.strip())
-    if not clean_name:
-        raise ValueError("Project name must contain valid characters")
-    
-    # Use pack_name if provided, otherwise use project name
-    if pack_name is None:
-        pack_name = project_name
-    
-    # Validate pack format
-    if not isinstance(pack_format, int) or pack_format < 1:
-        raise ValueError("Pack format must be a positive integer")
-    
-    # Create project directory
-    project_dir = Path(clean_name)
-    if project_dir.exists():
-        raise ValueError(f"Project directory '{clean_name}' already exists")
-    
-    try:
-        # Create the project directory
-        project_dir.mkdir(parents=True, exist_ok=False)
-        
-        # Create the main MDL file
-        mdl_file = project_dir / "main.mdl"
-        
-        # Generate template content
-        template_content = _generate_mdl_template(clean_name, pack_name, pack_format)
-        
-        with open(mdl_file, 'w', encoding='utf-8') as f:
-            f.write(template_content)
-        
-        # Create README.md
-        readme_content = _generate_readme_template(clean_name, pack_name)
-        readme_file = project_dir / "README.md"
-        
-        with open(readme_file, 'w', encoding='utf-8') as f:
-            f.write(readme_content)
-        
-        try:
-            from .cli_colors import color
-            print(f"{color.success('[OK]')} Successfully created new MDL project: {color.highlight(clean_name)}")
-            print(f"{color.info('[DIR]')} Project directory: {color.file_path(str(project_dir.absolute()))}")
-            print(f"{color.info('[FILE]')} Main file: {color.file_path(str(mdl_file))}")
-            print(f"{color.info('[DOC]')} Documentation: {color.file_path(str(readme_file))}")
-            print()
-            print(f"{color.section('[NEXT]')} Next steps:")
-            print(f"  1. cd {color.highlight(clean_name)}")
-            print(f"  2. Edit main.mdl with your code")
-            print(f"  3. mdl build --mdl main.mdl -o dist")
-            print(f"  4. mdl check main.mdl")
-            print()
-            print(f"{color.section('[INFO]')} Learn more:")
-            print("   • Language Reference: https://www.mcmdl.com/docs/language-reference")
-            print("   • Examples: https://www.mcmdl.com/docs/examples")
-            print("   • CLI Reference: https://www.mcmdl.com/docs/cli-reference")
-        except ImportError:
-            # Fallback if colors aren't available
-            print(f"[OK] Successfully created new MDL project: {clean_name}")
-            print(f"[DIR] Project directory: {project_dir.absolute()}")
-            print(f"[FILE] Main file: {mdl_file}")
-            print(f"[DOC] Documentation: {readme_file}")
-            print()
-            print("[NEXT] Next steps:")
-            print(f"  1. cd {clean_name}")
-            print(f"  2. Edit main.mdl with your code")
-            print(f"  3. mdl build --mdl main.mdl -o dist")
-            print(f"  4. mdl check main.mdl")
-            print()
-            print("[INFO] Learn more:")
-            print("   • Language Reference: https://www.mcmdl.com/docs/language-reference")
-            print("   • Examples: https://www.mcmdl.com/docs/examples")
-            print("   • CLI Reference: https://www.mcmdl.com/docs/cli-reference")
-    
-    except Exception as e:
-        # Clean up on error
-        if project_dir.exists():
-            shutil.rmtree(project_dir)
-        raise ValueError(f"Failed to create project: {str(e)}")
-
-
-def _generate_mdl_template(project_name: str, pack_name: str, pack_format: int) -> str:
-    """Generate the template MDL content."""
-    return f'''pack "{pack_name}" "Generated by MDL CLI" {pack_format};
-namespace "{pack_name}";
-
-// Example variables
-var num score = 0;
-var num lives = 3;
-
-// Main function - this runs when called
-function "main" {{
-    say Hello from {project_name}!;
-    
-    // Set initial values
-    score = 10;
-    lives = 3;
-    
-    // Display current values
-    say Score: $score$;
-    say Lives: $lives$;
-    
-    // Example conditional statement
-    if "$score$ > 5" {{
-        say Great score!;
-    }} else {{
-        say Keep trying!;
-    }};
-    
-    // Example while loop
-    while "$lives$ > 0" {{
-        say You have $lives$ lives remaining;
-        lives = lives - 1;
-    }};
-    
-    say Game over!;
-}}
-
-// Init function - this runs when the datapack loads
-function "init" {{
-    say [GAME] {pack_name} loaded successfully!;
-    say Type: /function {project_name}:main;
-}}
-
-// Tick function - this runs every tick (20 times per second)
-function "tick" {{
-    // Add your tick logic here
-    // Be careful with performance!
-}}
-
-// Example function with parameters
-function "greet_player" {{
-    say Welcome to {pack_name}!;
-    say Have fun playing!;
-}}
-
-// Raw Minecraft commands example
-$!raw
-# You can use raw Minecraft commands here
-# These are passed through directly to the output
-# Useful for complex commands or commands not yet supported by MDL
-tellraw @a {{"text":"Raw command example","color":"gold"}}
-raw!$
-
-// Example recipe (optional)
-// recipe "diamond_sword" "diamond_sword.json";
-
-// Example loot table (optional)
-// loot_table "chest_loot" "chest_loot.json";
-
-// Example advancement (optional)
-// advancement "first_diamond" "first_diamond.json";
-
-// Hook the init function to run when the datapack loads
-on_load "{project_name}:init";
-'''
-
-
-def _generate_readme_template(project_name: str, pack_name: str) -> str:
-    """Generate the README template content."""
-    return f'''# {pack_name}
-
-A Minecraft datapack created with MDL (Minecraft Datapack Language).
-
-## [GAME] About
-
-This datapack was generated using the MDL CLI tool. MDL is a simplified language for creating Minecraft datapacks with variables, control structures, and easy syntax.
-
-## [DIR] Project Structure
-
-```
-{project_name}/
-├── README.md              # This file
-└── main.mdl              # Main MDL source file
-```
-
-## [NEXT] Getting Started
-
-### Prerequisites
-
-- Minecraft Java Edition (1.20+ recommended)
-- MDL CLI tool installed (`pipx install minecraft-datapack-language`)
-
-### Building the Datapack
-
-1. **Build the project:**
-   ```bash
-   mdl build --mdl {project_name}.mdl -o dist
-   ```
-
-2. **Check for errors:**
-   ```bash
-   mdl check {project_name}.mdl
-   ```
-
-3. **Install in Minecraft:**
-   - Copy the `dist` folder to your world's `datapacks` directory
-   - Or use the `--wrapper` option to create a zip file:
-     ```bash
-     mdl build --mdl {project_name}.mdl -o dist --wrapper {project_name}
-     ```
-
-### Using the Datapack
-
-1. Load your world in Minecraft
-2. The datapack will automatically load
-3. Run the main function: `/function {project_name}:main`
-
-## [OPT] Development
-
-### Editing the Code
-
-Open `{project_name}.mdl` in your favorite text editor. The file contains:
-
-- **Pack declaration** - Datapack metadata
-- **Variables** - Scoreboard variables for storing data
-- **Functions** - The main logic of your datapack
-- **Control structures** - If/else statements and loops
-- **Raw commands** - Direct Minecraft commands when needed
-
-### Key Features
-
-- **Variables**: Use `variable name = value` to create scoreboard objectives
-- **Functions**: Define reusable code blocks with `function name { ... }`
-- **Conditionals**: Use `if (condition) { ... } else { ... }`
-- **Loops**: Use `while (condition) { ... }` for repeating actions
-- **Variable substitution**: Use `$variable$` in commands to insert values
-
-### Example Code
-
-```mdl
-// Set a variable
-score = 10
-
-// Use it in a command
-say "Your score is: $score$"
-
-// Conditional logic
-if (score > 5) {{
-  say "Great job!"
-}} else {{
-  say "Keep trying!"
-}}
-```
-
-## [INFO] Resources
-
-- **Language Reference**: https://www.mcmdl.com/docs/language-reference
-- **CLI Reference**: https://www.mcmdl.com/docs/cli-reference
-- **Examples**: https://www.mcmdl.com/docs/examples
-- **Website**: https://www.mcmdl.com
-- **GitHub**: https://github.com/aaron777collins/MinecraftDatapackLanguage
-
-## 🐛 Troubleshooting
-
-### Common Issues
-
-1. **"No .mdl files found"**
-   - Make sure you're in the correct directory
-   - Check that the file has a `.mdl` extension
-
-2. **Syntax errors**
-   - Use `mdl check {project_name}.mdl` to find and fix errors
-   - Check the error messages for line numbers and suggestions
-
-3. **Datapack not loading**
-   - Verify the pack format is correct for your Minecraft version
-   - Check that the `dist` folder is in the right location
-
-### Getting Help
-
-- Check the error messages - they include helpful suggestions
-- Visit the documentation: https://www.mcmdl.com/docs
-- Report bugs: https://github.com/aaron777collins/MinecraftDatapackLanguage/issues
-
-## [FILE] License
-
-This project is licensed under the MIT License - see the LICENSE file for details.
-
----
-
-Happy coding! [GAME]
-'''

minecraft_datapack_language/cli_utils.py

@@ -1,276 +0,0 @@
-"""
-CLI Utilities - Helper functions for the MDL CLI
-"""
-
-import os
-import json
-import re
-from pathlib import Path
-from typing import Any, List
-
-
-def ensure_dir(path: str) -> None:
-    """Ensure a directory exists, creating it if necessary."""
-    os.makedirs(path, exist_ok=True)
-
-
-def write_json(path: str, data: Any) -> None:
-    """Write JSON data to a file."""
-    with open(path, 'w', encoding='utf-8') as f:
-        json.dump(data, f, indent=2)
-
-
-def _process_variable_substitutions(command: str, selector: str = "@s") -> str:
-    """Process $variable$ and $variable<selector>$ substitutions in commands."""
-    
-    # Skip say commands - they have their own variable substitution logic
-    if command.strip().startswith('say '):
-        return command
-    
-    # Check if this is a tellraw command with JSON
-    if command.strip().startswith('tellraw'):
-        # Special handling for tellraw commands with variable substitutions
-        # Find the JSON part of the tellraw command
-        json_start = command.find('[')
-        if json_start == -1:
-            json_start = command.find('{')
-        json_end = command.rfind(']') + 1
-        if json_end == 0:
-            json_end = command.rfind('}') + 1
-        
-        if json_start != -1 and json_end != -1:
-                prefix = command[:json_start]
-                json_part = command[json_start:json_end]
-                suffix = command[json_end:]
-                
-                # Parse the JSON to handle variable substitutions properly
-                try:
-                    data = json.loads(json_part)
-                    
-                    # Handle both single object and array formats
-                    if isinstance(data, list):
-                        # JSON array format - process each element
-                        for item in data:
-                            if isinstance(item, dict) and 'score' in item and 'name' in item['score']:
-                                # Resolve scope selector in score components
-                                name = item['score']['name']
-                                if name == "global":
-                                    item['score']['name'] = _resolve_selector("global")
-                        
-                        # Return the processed JSON
-                        new_json = json.dumps(data)
-                        return f"{prefix}{new_json}{suffix}"
-                    
-                    elif isinstance(data, dict) and 'text' in data and '$' in data['text']:
-                        # Single object format with variable substitutions
-                        # Split the text into parts before and after variables
-                        text = data['text']
-                        parts = []
-                        current_pos = 0
-                        
-                        # Find all variable substitutions (including scoped ones)
-                        var_pattern = r'\$([^$]+)\$'
-                        for match in re.finditer(var_pattern, text):
-                            start, end = match.span()
-                            var_name = match.group(1)
-                            
-                            # Add text before the variable
-                            if start > current_pos:
-                                parts.append(text[current_pos:start])
-                            
-                            # Process the variable
-                            if '<' in var_name and '>' in var_name:
-                                # Scoped variable: $var<selector>$
-                                base_name, scope = var_name.split('<', 1)
-                                scope = scope.rstrip('>')
-                                resolved_scope = _resolve_selector(scope)
-                                parts.append(f"${{{base_name}}}")
-                                # Replace the scope in the command
-                                command = command.replace(f"${{{base_name}}}", f"${{{base_name}}}")
-                            else:
-                                # Simple variable: $var$
-                                parts.append(f"${{{var_name}}}")
-                            
-                            current_pos = end
-                        
-                        # Add remaining text
-                        if current_pos < len(text):
-                            parts.append(text[current_pos:])
-                        
-                        # Update the text in the JSON
-                        data['text'] = ''.join(parts)
-                        new_json = json.dumps(data)
-                        return f"{prefix}{new_json}{suffix}"
-                    
-                except json.JSONDecodeError:
-                    # If JSON parsing fails, fall back to simple substitution
-                    pass
-    
-    # Simple variable substitution for non-JSON commands
-    # Handle scoped variables: $variable<selector>$
-    scoped_pattern = r'\$([^$<]+)<([^>]+)>\$'
-    command = re.sub(scoped_pattern, lambda m: f"${{{m.group(1)}}}", command)
-    
-    # Handle simple variables: $variable$
-    simple_pattern = r'\$([^$]+)\$'
-    command = re.sub(simple_pattern, lambda m: f"${{{m.group(1)}}}", command)
-    
-    return command
-
-
-def _convert_condition_to_minecraft_syntax(condition: str, selector: str = "@s", variable_scopes: dict = None) -> str:
-    """Convert MDL condition syntax to Minecraft scoreboard syntax."""
-    # Remove extra whitespace and normalize
-    condition = condition.strip()
-    
-    # Handle variable substitution in conditions (e.g., "$value$ > 3")
-    import re
-    var_pattern = r'\$([^$]+)\$'
-    
-    # Replace variable references with proper scoreboard syntax
-    def replace_var(match):
-        var_name = match.group(1)
-        # Check if variable has explicit scope selector
-        if '<' in var_name and var_name.endswith('>'):
-            var_parts = var_name.split('<', 1)
-            base_var = var_parts[0]
-            scope_selector = var_parts[1][:-1]  # Remove trailing >
-            # Resolve special selectors
-            if scope_selector == "global":
-                scope_selector = "@e[type=armor_stand,tag=mdl_server,limit=1]"
-            return f"{scope_selector} {base_var}"
-        else:
-            # Use declared scope if available, otherwise default to current selector
-            if variable_scopes and var_name in variable_scopes:
-                declared_scope = variable_scopes[var_name]
-                if declared_scope == 'global':
-                    return f"@e[type=armor_stand,tag=mdl_server,limit=1] {var_name}"
-                else:
-                    return f"{declared_scope} {var_name}"
-            else:
-                # Default to current selector
-                return f"{selector} {var_name}"
-    
-    # Apply variable substitution
-    condition = re.sub(var_pattern, replace_var, condition)
-    
-    # Handle common patterns
-    if '==' in condition:
-        var1, var2 = condition.split('==', 1)
-        var1 = var1.strip()
-        var2 = var2.strip()
-        
-        # Check if var2 is a number
-        try:
-            value = int(var2)
-            return f"score {var1} matches {value}"
-        except ValueError:
-            # Both are variables, compare them
-            return f"score {var1} = {var2}"
-    
-    elif '!=' in condition:
-        var1, var2 = condition.split('!=', 1)
-        var1 = var1.strip()
-        var2 = var2.strip()
-        
-        try:
-            value = int(var2)
-            return f"score {var1} matches ..{value-1} {value+1}.."
-        except ValueError:
-            return f"score {var1} != {var2}"
-    
-    elif '>' in condition:
-        var1, var2 = condition.split('>', 1)
-        var1 = var1.strip()
-        var2 = var2.strip()
-        
-        try:
-            value = int(var2)
-            return f"score {var1} matches {value+1}.."
-        except ValueError:
-            return f"score {var1} > {var2}"
-    
-    elif '<' in condition:
-        var1, var2 = condition.split('<', 1)
-        var1 = var1.strip()
-        var2 = var2.strip()
-        
-        try:
-            value = int(var2)
-            return f"score {var1} matches ..{value-1}"
-        except ValueError:
-            return f"score {var1} < {var2}"
-    
-    elif '>=' in condition:
-        var1, var2 = condition.split('>=', 1)
-        var1 = var1.strip()
-        var2 = var2.strip()
-        
-        try:
-            value = int(var2)
-            return f"score {var1} matches {value}.."
-        except ValueError:
-            return f"score {var1} >= {var2}"
-    
-    elif '<=' in condition:
-        var1, var2 = condition.split('<=', 1)
-        var1 = var1.strip()
-        var2 = var2.strip()
-        
-        try:
-            value = int(var2)
-            return f"score {var1} matches ..{value}"
-        except ValueError:
-            return f"score {var1} <= {var2}"
-    
-    # Default: treat as a variable that should be non-zero
-    return f"score {condition} matches 1.."
-
-
-def _find_mdl_files(directory: Path) -> List[Path]:
-    """Find all .mdl files in a directory recursively."""
-    mdl_files = []
-    if directory.is_file():
-        if directory.suffix == '.mdl':
-            mdl_files.append(directory)
-    else:
-        for file_path in directory.rglob('*.mdl'):
-            mdl_files.append(file_path)
-    
-    return sorted(mdl_files)
-
-
-def _validate_selector(selector: str, variable_name: str) -> None:
-    """Validate a selector string."""
-    valid_selectors = ['@s', '@p', '@a', '@r', '@e', 'global']
-    if selector not in valid_selectors:
-        raise ValueError(f"Invalid selector '{selector}' for variable '{variable_name}'. Valid selectors: {', '.join(valid_selectors)}")
-
-
-def _resolve_selector(selector: str) -> str:
-    """Resolve a selector to its Minecraft equivalent."""
-    if selector == "global":
-        return "global"
-    return selector
-
-
-def _extract_base_variable_name(var_name: str) -> str:
-    """Extract the base variable name from a scoped variable."""
-    if '<' in var_name and '>' in var_name:
-        return var_name.split('<')[0]
-    return var_name
-
-
-def _slugify(name: str) -> str:
-    """Convert a string to a valid namespace/identifier."""
-    # Remove special characters and replace spaces with underscores
-    import re
-    slug = re.sub(r'[^a-zA-Z0-9_]', '_', name)
-    # Remove multiple consecutive underscores
-    slug = re.sub(r'_+', '_', slug)
-    # Remove leading/trailing underscores
-    slug = slug.strip('_')
-    # Ensure it starts with a letter or underscore
-    if slug and not slug[0].isalpha() and slug[0] != '_':
-        slug = '_' + slug
-    return slug.lower()