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

minecraft_datapack_language-15.4.30.dist-info/METADATA

@@ -0,0 +1,266 @@
+Metadata-Version: 2.4
+Name: minecraft-datapack-language
+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
+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.30.dist-info/RECORD

@@ -0,0 +1,17 @@
+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
+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.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,,