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

minecraft_datapack_language-15.4.29.dist-info/METADATA

@@ -0,0 +1,266 @@
+Metadata-Version: 2.4
+Name: minecraft-datapack-language
+Version: 15.4.29
+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
+Project-URL: Repository, https://github.com/aaron777collins/MinecraftDatapackLanguage
+Project-URL: Bug Tracker, https://github.com/aaron777collins/MinecraftDatapackLanguage/issues
+Project-URL: VS Code Extension, https://marketplace.visualstudio.com/items?itemName=mdl.minecraft-datapack-language
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mecha>=0.99.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Dynamic: license-file
+
+# <img src="https://github.com/aaron777collins/MinecraftDatapackLanguage/raw/main/icons/icon-128.png" width="32" height="32" alt="MDL Icon"> Minecraft Datapack Language (MDL)
+
+A **modern, scope-aware language** that lets you write Minecraft datapacks with **explicit scoping, variables, control structures, and expressions** that actually work.
+
+📖 **[View Full Documentation](https://www.mcmdl.com/)** - Complete guides, examples, and API reference  
+📦 **[View on PyPI](https://pypi.org/project/minecraft-datapack-language/)** - Download and install from PyPI  
+🔧 **[VS Code Extension](https://marketplace.visualstudio.com/items?itemName=mdl.minecraft-datapack-language)** - Syntax highlighting, IntelliSense, and snippets
+
+![CI](https://github.com/aaron777collins/MinecraftDatapackLanguage/workflows/CI/badge.svg)
+![Test Examples](https://github.com/aaron777collins/MinecraftDatapackLanguage/workflows/Test%20Examples/badge.svg)
+![Documentation](https://github.com/aaron777collins/MinecraftDatapackLanguage/workflows/Build%20and%20Deploy%20Documentation/badge.svg)
+![PyPI](https://img.shields.io/pypi/v/minecraft-datapack-language?style=flat-square)
+![Release](https://github.com/aaron777collins/MinecraftDatapackLanguage/workflows/Release/badge.svg)
+
+## 🎯 **MODERN** MDL Language with Explicit Scoping
+
+**MDL uses a modern, scope-aware language format** with **explicit scoping, control structures, variables, and expressions**:
+
+### ✨ **MODERN** Features
+- **🎯 Explicit scoping** with angle brackets `<@s>`, `<@a[team=red]>` for all operations
+- **📝 Modern comments** using `//` and `/* */`
+- **🔢 Number variables** with `var num` type (stored in scoreboards)
+- **🔄 Full control structures** including `if/else`, `while` loops
+- **💲 Variable substitution** with `$variable<scope>$` syntax
+- **🧮 Expressions** with arithmetic operations (`+`, `-`, `*`, `/`)
+- **📦 Namespace system** for modular code organization
+- **🏷️ Tag system** for all datapack resources (recipes, loot tables, advancements, etc.)
+- **🎨 VS Code extension** with full IntelliSense and snippets
+- **🧪 Comprehensive testing** with E2E validation
+- **📚 Extensive documentation** with examples for every feature
+
+### 🏗️ Core Features
+- ✅ **Modern pack format 15** by default for latest Minecraft features
+- ✅ **Explicit scoping** - every variable operation specifies its scope
+- ✅ **Real control structures** - `if/else`, `while` loops
+- ✅ **Number variables** stored in scoreboards with `$variable<scope>$` substitution
+- ✅ **Expressions** with arithmetic operations and variable substitution
+- ✅ **Multi-file projects** with automatic merging and dependency resolution
+- ✅ **Variable optimization** - automatic load function generation for initialization
+- ✅ **Selector optimization** - proper `@a` usage for system commands
+- ✅ **Easy hooks** into `minecraft:tick` and `minecraft:load` via function tags
+- ✅ **Tag support** for `recipe`, `loot_table`, `advancement`, `item_modifier`, `predicate`, and `structure`
+- ✅ **Raw blocks** for direct Minecraft command injection
+- ✅ **Say commands** that auto-convert to `tellraw` with JSON formatting
+
+> **Note**: Version 1.0+ uses **pack_format 15** by default for the modern MDL syntax.
+
+---
+
+## 🚀 Install
+
+### Option A — from PyPI (recommended for users)
+Global, isolated CLI via **pipx**:
+```bash
+python3 -m pip install --user pipx
+python3 -m pipx ensurepath    # reopen terminal
+pipx install minecraft-datapack-language
+
+mdl --help
+```
+
+Virtualenv (if you prefer):
+```bash
+python3 -m venv .venv
+source .venv/bin/activate      # Windows: .\.venv\Scripts\Activate.ps1
+pip install minecraft-datapack-language
+```
+
+### Option B — from source (for contributors)
+```bash
+# inside the repo
+python -m pip install -e .
+```
+
+---
+
+## 🔄 Update
+
+- **pipx**: `pipx upgrade minecraft-datapack-language`  
+- **pip (venv)**: `pip install -U minecraft-datapack-language`  
+- Pin a version: `pipx install "minecraft-datapack-language==<version>"` (replace `<version>` with desired version)
+
+---
+
+## 💻 CLI
+
+### Modern MDL (v1.0+)
+```bash
+# Build MDL files
+mdl build --mdl my_pack/mypack.mdl -o dist --wrapper mypack
+mdl check my_pack/mypack.mdl
+
+# Validate generated mcfunction files
+mdl check my_pack/mypack.mdl
+
+# Multi-file projects
+mdl build --mdl my_pack/ -o dist      # Build entire directory
+mdl build --mdl "file1.mdl file2.mdl" -o dist  # Build specific files
+
+# Create new projects
+mdl new my_awesome_pack
+```
+
+### Quick Start
+```bash
+# Create a new project
+mdl new my_first_pack
+
+# Build it
+cd my_first_pack
+mdl build --mdl main.mdl -o dist
+
+# Check for errors
+mdl check main.mdl
+```
+
+---
+
+## 📝 Language Examples
+
+### Basic Structure
+```mdl
+pack "MyPack" "My awesome datapack" 15;
+namespace "game";
+
+var num player_score<@s> = 0;
+var num team_score<@a[team=red]> = 0;
+
+function game:start<@s> {
+    player_score<@s> = 100;
+    say "Welcome! Your score is $player_score<@s>$";
+}
+
+on_load game:start<@s>;
+```
+
+### Control Structures
+```mdl
+function game:check_score<@s> {
+    if $player_score<@s>$ > 10 {
+        say "Great score!";
+        player_score<@s> = $player_score<@s>$ + 5;
+    } else {
+        say "Keep trying!";
+    }
+    
+    while $player_score<@s>$ < 100 {
+        player_score<@s> = $player_score<@s>$ + 1;
+    }
+}
+```
+
+### Tags and Resources
+```mdl
+// Recipe tags
+tag recipe "diamond_sword" "recipes/diamond_sword.json";
+tag loot_table "epic_loot" "loot_tables/epic_loot.json";
+tag advancement "first_spell" "advancements/first_spell.json";
+
+// Item modifiers and predicates
+tag item_modifier "enchanted_tool" "item_modifiers/enchanted_tool.json";
+tag predicate "has_mana" "predicates/has_mana.json";
+tag structure "wizard_tower" "structures/wizard_tower.json";
+```
+
+### Raw Blocks and Say Commands
+```mdl
+function game:special_effect<@s> {
+    $!raw
+    execute as @s run particle minecraft:explosion ~ ~ ~ 1 1 1 0 10
+    execute as @s run playsound minecraft:entity.player.levelup player @s ~ ~ ~ 1 1
+    raw!$
+    
+    say "Special effect triggered! Score: $player_score<@s>$";
+}
+```
+
+---
+
+## 🔧 Development
+
+### Building from Source
+```bash
+git clone https://github.com/aaron777collins/MinecraftDatapackLanguage.git
+cd MinecraftDatapackLanguage
+python -m pip install -e .
+```
+
+### Running Tests
+```bash
+# Run all tests
+python -m pytest
+
+# Run specific test file
+python -m pytest test_comprehensive_end_to_end.py
+
+# Run with coverage
+python -m pytest --cov=minecraft_datapack_language
+```
+
+### Building the Extension
+```bash
+cd vscode-extension
+npm install
+npm run compile
+```
+
+---
+
+## 📚 Documentation
+
+- **[Language Reference](docs/_docs/language-reference.md)** - Complete language specification
+- **[VS Code Extension](vscode-extension/README.md)** - Extension documentation
+- **[Examples](examples/)** - Sample projects and code snippets
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+### Development Setup
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests for new functionality
+5. Submit a pull request
+
+---
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+## 🙏 Acknowledgments
+
+- Minecraft community for inspiration
+- Contributors and testers
+- VS Code team for the excellent extension API
+
+---
+
+**Happy coding with MDL! 🎮**

minecraft_datapack_language-15.4.29.dist-info/RECORD

@@ -0,0 +1,16 @@
+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/ast_nodes.py,sha256=nbWrRz137MGMRpmnq8QkXNzrtlaCgyPEknytbkrS_M8,3899
+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
+minecraft_datapack_language/mdl_lexer.py,sha256=CjbEUpuuF4eU_ucA_WIhw6wSMcHGk2BchtQ0bLAGvwg,22033
+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/cli.py

@@ -1,159 +0,0 @@
-"""
-MDL CLI - Simplified Minecraft Datapack Language Compiler
-Handles basic control structures and number variables only
-"""
-
-import argparse
-import sys
-from pathlib import Path
-from typing import Optional
-
-from .cli_build import build_mdl
-from .cli_check import lint_mdl_file_wrapper, lint_mdl_directory_wrapper
-from .cli_new import create_new_project
-from .cli_help import show_main_help, show_build_help, show_check_help, show_new_help
-from .mdl_errors import MDLErrorCollector, create_error, MDLConfigurationError
-
-
-def main():
-    """Main CLI entry point."""
-    error_collector = MDLErrorCollector()
-    
-    try:
-        # Check for help requests and determine command first
-        has_help = '--help' in sys.argv or '-h' in sys.argv
-        
-        # Determine which command is being used for help
-        help_command = None
-        if has_help:
-            for i, arg in enumerate(sys.argv[1:], 1):
-                if arg in ['build', 'check', 'new']:
-                    help_command = arg
-                    break
-        
-        # Handle command-specific help before any parsing
-        if has_help and help_command == 'build':
-            show_build_help()
-            return
-        elif has_help and help_command == 'check':
-            show_check_help()
-            return
-        elif has_help and help_command == 'new':
-            show_new_help()
-            return
-        elif has_help:
-            # General help request
-            show_main_help()
-            return
-        
-        # Create argument parser without built-in help
-        parser = argparse.ArgumentParser(
-            description="MDL (Minecraft Datapack Language) CLI",
-            add_help=False
-        )
-        
-        # Add subcommands
-        subparsers = parser.add_subparsers(dest='command', help='Available commands')
-        
-        # Build command
-        build_parser = subparsers.add_parser('build', add_help=False)
-        build_parser.add_argument('--mdl', '-m', required=True, help='Input MDL file or directory')
-        build_parser.add_argument('-o', '--output', required=True, help='Output directory')
-        build_parser.add_argument('--verbose', '-v', action='store_true', help='Verbose output')
-        build_parser.add_argument('--pack-format', type=int, help='Pack format override')
-        build_parser.add_argument('--wrapper', help='Create zip file with specified name')
-        build_parser.add_argument('--ignore-warnings', action='store_true', help='Suppress warning messages during build')
-        
-        # Check command
-        check_parser = subparsers.add_parser('check', add_help=False)
-        check_parser.add_argument('input', help='Input MDL file or directory')
-        check_parser.add_argument('--verbose', '-v', action='store_true', help='Verbose output')
-        check_parser.add_argument('--ignore-warnings', action='store_true', help='Suppress warning messages during check')
-        
-        # New command
-        new_parser = subparsers.add_parser('new', add_help=False)
-        new_parser.add_argument('project_name', help='Name for the new project')
-        new_parser.add_argument('--pack-name', help='Custom pack name')
-        new_parser.add_argument('--pack-format', type=int, default=82, help='Pack format number')
-        
-        try:
-            args = parser.parse_args()
-        except SystemExit:
-            # Invalid arguments - show help
-            show_main_help()
-            return
-        
-        # Process commands
-        if args.command == "build":
-            try:
-                build_mdl(
-                    args.mdl, 
-                    args.output, 
-                    verbose=args.verbose,
-                    pack_format_override=args.pack_format,
-                    wrapper=args.wrapper,
-                    ignore_warnings=args.ignore_warnings
-                )
-            except Exception as e:
-                error_collector.add_error(create_error(
-                    MDLConfigurationError,
-                    f"Build command failed: {str(e)}",
-                    suggestion="Check your arguments and try again."
-                ))
-        
-        elif args.command == "check":
-            try:
-                input_path = Path(args.input)
-                if input_path.is_file():
-                    lint_mdl_file_wrapper(args.input, args.verbose, args.ignore_warnings)
-                else:
-                    lint_mdl_directory_wrapper(args.input, args.verbose, args.ignore_warnings)
-            except Exception as e:
-                error_collector.add_error(create_error(
-                    MDLConfigurationError,
-                    f"Check command failed: {str(e)}",
-                    suggestion="Check your arguments and try again."
-                ))
-        
-        elif args.command == "new":
-            try:
-                create_new_project(
-                    args.project_name,
-                    pack_name=args.pack_name,
-                    pack_format=args.pack_format
-                )
-            except Exception as e:
-                error_collector.add_error(create_error(
-                    MDLConfigurationError,
-                    f"New command failed: {str(e)}",
-                    suggestion="Check your arguments and try again."
-                ))
-        
-        elif args.command is None:
-            # No command specified - show help
-            show_main_help()
-            return
-        else:
-            # Unknown command
-            error_collector.add_error(create_error(
-                MDLConfigurationError,
-                f"Unknown command: {args.command}",
-                suggestion="Use 'mdl --help' to see available commands."
-            ))
-        
-        # Print any errors and exit
-        error_collector.print_errors(verbose=True, ignore_warnings=False)
-        error_collector.raise_if_errors()
-    
-    except Exception as e:
-        error_collector.add_error(create_error(
-            MDLConfigurationError,
-            f"Unexpected error: {str(e)}",
-            suggestion="If this error persists, please report it as a bug."
-        ))
-        error_collector.print_errors(verbose=True, ignore_warnings=False)
-        error_collector.raise_if_errors()
-
-
-if __name__ == "__main__":
-    main()