minecraft-datapack-language 17.0.11__py3-none-any.whl → 17.0.13__py3-none-any.whl

minecraft_datapack_language/_embedded/docs/_data/version.yml

@@ -1,3 +1,3 @@
-current: "17.0.9"
-tag: "v17.0.9"
-updated_at: "2025-09-10T08:38:33Z"
+current: "17.0.11"
+tag: "v17.0.11"
+updated_at: "2025-09-11T00:02:50Z"

minecraft_datapack_language/_embedded/docs/_docs/cli-reference.md

@@ -124,16 +124,24 @@ mdl new adventure_map
 mdl new projects/survival_plus
 ```
 
-**What it creates:**
-The new command generates a minimal project structure with:
+**What it creates (by default):**
+The new command generates a project structure with:
 - `README.md` - Quick start with build instructions
 - `main.mdl` - Hello world (pack, namespace, simple function, on_load)
+- `docs/` - A literal copy of the MDL documentation for offline/local browsing
+- `serve_docs.sh` and `serve_docs.ps1` - Convenience scripts to serve docs locally
 
-**Generated project structure:**
+**Generated project structure (default):**
 ```
 my_awesome_pack/
 ├── README.md
-└── main.mdl
+├── main.mdl
+├── docs/
+│   ├── index.md
+│   ├── _config.yml
+│   └── ...
+├── serve_docs.sh
+└── serve_docs.ps1
 ```
 
 **Template content includes:**
@@ -167,6 +175,46 @@ my_awesome_pack/
 | Option | Description | Example |
 |--------|-------------|---------|
 | `<project_name>` | Name of the new project to create | `mdl new my_pack` |
+| `--pack-name <name>` | Override datapack name used in `pack.mcmeta` | `--pack-name Adventure` |
+| `--pack-format <num>` | Pack format number (defaults to modern value) | `--pack-format 82` |
+| `--output <dir>` | Directory to create the project in | `--output ./projects` |
+| `--exclude-local-docs` | Do not copy the MDL docs into `docs/` | `--exclude-local-docs` |
+
+By default, `mdl new` includes a full `docs/` folder in your project so new users have local docs offline. Use `--exclude-local-docs` to skip this step.
+
+Serve the docs quickly with the generated scripts:
+
+```bash
+# Bash/Git Bash
+./serve_docs.sh
+
+# PowerShell
+./serve_docs.ps1
+```
+
+Both scripts prefer Jekyll (if `bundle` and a `Gemfile` are present), otherwise they fall back to a simple Python web server.
+
+You can also serve docs via the CLI:
+
+```bash
+mdl docs serve --dir docs --port 8000
+```
+
+This starts a local web server for the `docs/` directory.
+
+## Completion Command
+
+Install shell autocompletion so you can type `mdl bui<Tab>` and get `build`:
+
+```bash
+mdl completion install           # auto-detects your shell
+mdl completion install bash      # explicit shell
+mdl completion uninstall zsh     # remove
+mdl completion print fish        # print script for manual use/CI
+mdl completion doctor            # basic diagnostics
+```
+
+Supported shells: Bash (incl. Git Bash), Zsh, Fish, and PowerShell.
 
 ## Error Handling
 

minecraft_datapack_language/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '17.0.11'
-__version_tuple__ = version_tuple = (17, 0, 11)
+__version__ = version = '17.0.13'
+__version_tuple__ = version_tuple = (17, 0, 13)
 
 __commit_id__ = commit_id = None

minecraft_datapack_language/cli.py

@@ -92,11 +92,11 @@ Examples:
         return 0
 
     if not args.command:
+        parser.print_help()
+        print("")
         print("Tip: Create a new project with: mdl new <project_name>")
         print("     After creating a project, you can serve local docs with: mdl docs serve --dir docs")
         print("     Or run the generated scripts: ./serve_docs.sh (bash) or ./serve_docs.ps1 (PowerShell)")
-        print("")
-        parser.print_help()
         return 0
     
     try:
@@ -366,6 +366,7 @@ def copy_packaged_docs_into(project_dir: Path) -> bool:
     Raises FileExistsError if destination exists.
     """
     embedded_root = importlib_resources_files("minecraft_datapack_language").joinpath("_embedded", "docs")
+    embedded_site = importlib_resources_files("minecraft_datapack_language").joinpath("_embedded", "docs_site")
     try:
         # Some importlib.resources implementations require as_file for files; for dirs, check existence
         if not Path(str(embedded_root)).exists():
@@ -373,10 +374,19 @@ def copy_packaged_docs_into(project_dir: Path) -> bool:
     except Exception:
         return False
 
+    # Copy raw docs
     dest = project_dir / "docs"
     if dest.exists():
         raise FileExistsError("docs directory already exists")
     shutil.copytree(str(embedded_root), str(dest))
+    # Copy prebuilt HTML site if available
+    try:
+        if Path(str(embedded_site)).exists():
+            site_dest = project_dir / "docs_site"
+            if not site_dest.exists():
+                shutil.copytree(str(embedded_site), str(site_dest))
+    except Exception:
+        pass
     return True
 
 
@@ -386,7 +396,10 @@ def create_docs_serve_scripts(project_dir: Path) -> None:
     bash_script.write_text("""#!/usr/bin/env bash
 set -e
 PORT=${PORT:-8000}
-DIR=${1:-docs}
+DIR=${1:-}
+if [ -z "$DIR" ]; then
+  if [ -d docs_site ]; then DIR=docs_site; else DIR=docs; fi
+fi
 if [ ! -d "$DIR" ]; then
   echo "Error: docs directory '$DIR' not found"; exit 1
 fi
@@ -406,8 +419,9 @@ fi
     ps1_script.write_text("""
 param(
   [int]$Port = 8000,
-  [string]$Dir = "docs"
+  [string]$Dir = ""
 )
+if (-not $Dir) { if (Test-Path 'docs_site') { $Dir = 'docs_site' } else { $Dir = 'docs' } }
 if (-not (Test-Path $Dir)) { Write-Host "Error: docs directory '$Dir' not found"; exit 1 }
 # Prefer Jekyll if available and Gemfile exists
 $gemfile = (Test-Path (Join-Path $Dir 'Gemfile')) -or (Test-Path 'Gemfile')

{minecraft_datapack_language-17.0.11.dist-info → minecraft_datapack_language-17.0.13.dist-info}/METADATA

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

@@ -1,7 +1,7 @@
 minecraft_datapack_language/__init__.py,sha256=0KVXBE4ScRaRUrf83aA2tVB-y8A_jplyaxVvtHH6Uw0,1199
-minecraft_datapack_language/_version.py,sha256=8ckCnInAFi-5Xj8S-SCDDxMtN9E-SVkv2R6UOjGlqfA,708
+minecraft_datapack_language/_version.py,sha256=GPSstnQDn_-Sa-bWyjdBVUBYrZ2l-Pj6XNIJ0_QZ0KA,708
 minecraft_datapack_language/ast_nodes.py,sha256=L5izavSeXDr766vsfRvJrcnflXNJyXcy0WSfyJPq2ZA,4484
-minecraft_datapack_language/cli.py,sha256=S5Lbv7c5U3osy1S-pYoRH8J5fu2KaTTWCoo2YcKhDaI,22610
+minecraft_datapack_language/cli.py,sha256=PY_89LAZVpYWOZb7HGfkpKWNM1-LqpYRcuosRRL-Y_k,23203
 minecraft_datapack_language/dir_map.py,sha256=HmxFkuvWGkzHF8o_GFb4BpuMCRc6QMw8UbmcAI8JVdY,1788
 minecraft_datapack_language/mdl_compiler.py,sha256=Cs3fXtIAG4_Johp7h3BeYOs9RNUogkvYsR8Dvt7Ek1E,70720
 minecraft_datapack_language/mdl_errors.py,sha256=r0Gu3KhoX1YLPAVW_iO7Q_fPgaf_Dv9tOGSOdKNSzmw,16114
@@ -17,8 +17,8 @@ minecraft_datapack_language/_embedded/docs/_config.yml,sha256=wx1F7KonP5t0fvF8ow
 minecraft_datapack_language/_embedded/docs/docs.md,sha256=odOG-EryTrvQFaAEbcqEbtqmPVR1xzQQf5Yc0S0zwFY,4042
 minecraft_datapack_language/_embedded/docs/downloads.md,sha256=Lp4ShcqCuDoGypswm5sGYORCOYVwGDmVLEz-5NyKndQ,10250
 minecraft_datapack_language/_embedded/docs/index.md,sha256=lyUqzvaeQhTZdir_6lpEMExWBUFlLcti7KoJVzQ_57Q,9855
-minecraft_datapack_language/_embedded/docs/_data/version.yml,sha256=a9WxWdWcGBQW-to67rk2Jcp4u38YMoIrWEI067b2HOI,68
-minecraft_datapack_language/_embedded/docs/_docs/cli-reference.md,sha256=BX-4klR7eBWpVa2du1OHJo4XzZffRl7e1ROOQJ8JobE,10230
+minecraft_datapack_language/_embedded/docs/_data/version.yml,sha256=BR5CMdoU-1_4u_Sz5hoFLflEucNupYJoLRn0mb7zZ28,70
+minecraft_datapack_language/_embedded/docs/_docs/cli-reference.md,sha256=yrZW8pp6T124XCUKuG-59S5YDY0WevaIQ7SwfXQ_Irw,11922
 minecraft_datapack_language/_embedded/docs/_docs/contributing.md,sha256=Qs-AHky6G9P4L0siMg3l9dAO8I8AzSGW-htEaM_C-Gg,9434
 minecraft_datapack_language/_embedded/docs/_docs/docs-hub.md,sha256=b0oyaoYkEeKOjG2bRWm4MUnrd03tznKPcECIkhS1sUw,7464
 minecraft_datapack_language/_embedded/docs/_docs/documentation.md,sha256=zVpFf5X-fLAd7QDOK5x4Nk546vgJr7dw5XGyXCrUw5w,4074
@@ -48,9 +48,9 @@ minecraft_datapack_language/completions/mdl.bash,sha256=mlRdQ1PwoFwl7Fw5j7u0mhsN
 minecraft_datapack_language/completions/mdl.fish,sha256=ReWjaqUwjQni-hUZfVQG2CsI5fE7uJpoywiKrQhtcFw,1923
 minecraft_datapack_language/completions/mdl.ps1,sha256=b2A1sFCtY23sv1-LILhPu0lphnZqzVjl__AtvCUMWtU,1744
 minecraft_datapack_language/completions/mdl.zsh,sha256=Pdx6yuSFaK2-UIsriVoJJacuWnw2f9DOWrVhPJLBAwo,633
-minecraft_datapack_language-17.0.11.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-minecraft_datapack_language-17.0.11.dist-info/METADATA,sha256=YUKQ2ZRJQ8Juh1DTJHUe6UYjDFaFSbofTOBW6v7Ehko,8418
-minecraft_datapack_language-17.0.11.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-minecraft_datapack_language-17.0.11.dist-info/entry_points.txt,sha256=c6vjBeCiyQflvPHBRyBk2nJCSfYt3Oc7Sc9V87ySi_U,108
-minecraft_datapack_language-17.0.11.dist-info/top_level.txt,sha256=ADtFI476tbKLLxEAA-aJQAfg53MA3k_DOb0KTFiggfw,28
-minecraft_datapack_language-17.0.11.dist-info/RECORD,,
+minecraft_datapack_language-17.0.13.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+minecraft_datapack_language-17.0.13.dist-info/METADATA,sha256=OziLRMkb_tobvTT69PSWoD5PdB4HTBQBWLJwtkhM9yM,8418
+minecraft_datapack_language-17.0.13.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+minecraft_datapack_language-17.0.13.dist-info/entry_points.txt,sha256=c6vjBeCiyQflvPHBRyBk2nJCSfYt3Oc7Sc9V87ySi_U,108
+minecraft_datapack_language-17.0.13.dist-info/top_level.txt,sha256=ADtFI476tbKLLxEAA-aJQAfg53MA3k_DOb0KTFiggfw,28
+minecraft_datapack_language-17.0.13.dist-info/RECORD,,