minecraft-datapack-language 17.0.17__py3-none-any.whl → 17.0.19__py3-none-any.whl

minecraft_datapack_language/_embedded/docs/_data/version.yml

@@ -1,3 +1,3 @@
-current: "17.0.15"
-tag: "v17.0.15"
-updated_at: "2025-09-11T00:25:52Z"
+current: "17.0.17"
+tag: "v17.0.17"
+updated_at: "2025-09-11T00:46:17Z"

minecraft_datapack_language/_embedded/docs/_docs/getting-started.md

@@ -6,6 +6,8 @@ permalink: /docs/getting-started/
 
 MDL (Minecraft Datapack Language) is a simple language that compiles to Minecraft datapack `.mcfunction` files.
 
+Quick link: [Language Reference](https://www.mcmdl.com/docs/language-reference/)
+
 ## Installation
 
 Install MDL using pipx:

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.17'
-__version_tuple__ = version_tuple = (17, 0, 17)
+__version__ = version = '17.0.19'
+__version_tuple__ = version_tuple = (17, 0, 19)
 
 __commit_id__ = commit_id = None

minecraft_datapack_language/completions/mdl.bash

@@ -1,33 +1,63 @@
 _mdl_complete() {
   local cur prev words cword
-  _init_completion -n : || {
-    COMPREPLY=()
-    return
-  }
+  cur="${COMP_WORDS[COMP_CWORD]}"
+  prev="${COMP_WORDS[COMP_CWORD-1]}"
+  words=("${COMP_WORDS[@]}")
+  cword=${COMP_CWORD}
 
   local subcommands="build check new completion docs"
   if [[ ${cword} -eq 1 ]]; then
-    COMPREPLY=( $(compgen -W "${subcommands}" -- "$cur") )
+    if [[ "$cur" == -* ]]; then
+      COMPREPLY=( $(compgen -W "-h --help --version" -- "$cur") )
+    else
+      COMPREPLY=( $(compgen -W "${subcommands}" -- "$cur") )
+    fi
+    return
+  fi
+
+  # Global options available anywhere
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "-h --help --version" -- "$cur") )
     return
   fi
 
   case "${words[1]}" in
     build)
-      COMPREPLY=( $(compgen -W "--mdl -o --output --verbose --wrapper --no-zip" -- "$cur") )
+      COMPREPLY=( $(compgen -W "--mdl -o --output --verbose --wrapper --no-zip -h --help" -- "$cur") )
+      [[ "$prev" == "--mdl" ]] && { COMPREPLY=( $(compgen -f -d -- "$cur") ); return; }
+      [[ "$prev" == "-o" || "$prev" == "--output" ]] && { COMPREPLY=( $(compgen -d -- "$cur") ); return; }
       [[ ${cur} == -* ]] || COMPREPLY+=( $(compgen -f -d -- "$cur") )
       ;;
     check)
-      COMPREPLY=( $(compgen -W "--verbose" -- "$cur") )
+      COMPREPLY=( $(compgen -W "--verbose -h --help" -- "$cur") )
       [[ ${cur} == -* ]] || COMPREPLY+=( $(compgen -f -d -- "$cur") )
       ;;
     new)
-      COMPREPLY=( $(compgen -W "--pack-name --pack-format --output --exclude-local-docs" -- "$cur") )
+      COMPREPLY=( $(compgen -W "--pack-name --pack-format --output --exclude-local-docs -h --help" -- "$cur") )
+      [[ "$prev" == "--output" ]] && { COMPREPLY=( $(compgen -d -- "$cur") ); return; }
       ;;
     completion)
-      COMPREPLY=( $(compgen -W "print install uninstall doctor" -- "$cur") )
+      # Suggest subcommands or shells for 3rd arg
+      if [[ ${cword} -eq 2 ]]; then
+        COMPREPLY=( $(compgen -W "print install uninstall doctor -h --help" -- "$cur") )
+      else
+        case "${words[2]}" in
+          print|install|uninstall)
+            COMPREPLY=( $(compgen -W "bash zsh fish powershell" -- "$cur") )
+            ;;
+          *) ;;
+        esac
+      fi
       ;;
     docs)
-      COMPREPLY=( $(compgen -W "open serve" -- "$cur") )
+      if [[ ${cword} -eq 2 ]]; then
+        COMPREPLY=( $(compgen -W "open serve -h --help" -- "$cur") )
+      else
+        if [[ "${words[2]}" == "serve" ]]; then
+          COMPREPLY=( $(compgen -W "--port --dir -h --help" -- "$cur") )
+          [[ ${cur} == -* ]] || COMPREPLY+=( $(compgen -d -- "$cur") )
+        fi
+      fi
       ;;
   esac
 }

minecraft_datapack_language/completions/mdl.fish

@@ -4,29 +4,40 @@ complete -c mdl -n "__fish_use_subcommand" -a "new" -d "Create a new MDL project
 complete -c mdl -n "__fish_use_subcommand" -a "completion" -d "Shell completion utilities"
 complete -c mdl -n "__fish_use_subcommand" -a "docs" -d "Docs utilities"
 
+# global options
+complete -c mdl -s h -l help -d "Show help"
+complete -c mdl -l version -d "Show version"
+
 # build options
 complete -c mdl -n "__fish_seen_subcommand_from build" -l mdl -d "MDL file or directory" -r -F
 complete -c mdl -n "__fish_seen_subcommand_from build" -s o -l output -d "Output directory" -r -F
 complete -c mdl -n "__fish_seen_subcommand_from build" -l verbose -d "Verbose output"
 complete -c mdl -n "__fish_seen_subcommand_from build" -l wrapper -d "Wrapper directory" -r
 complete -c mdl -n "__fish_seen_subcommand_from build" -l no-zip -d "Do not zip"
+complete -c mdl -n "__fish_seen_subcommand_from build" -s h -l help -d "Help"
 
 # check options
 complete -c mdl -n "__fish_seen_subcommand_from check" -l verbose -d "Verbose output"
+complete -c mdl -n "__fish_seen_subcommand_from check" -s h -l help -d "Help"
 
 # new options
 complete -c mdl -n "__fish_seen_subcommand_from new" -l pack-name -d "Custom datapack name" -r
 complete -c mdl -n "__fish_seen_subcommand_from new" -l pack-format -d "Pack format number" -r
 complete -c mdl -n "__fish_seen_subcommand_from new" -l output -d "Project directory" -r -F
 complete -c mdl -n "__fish_seen_subcommand_from new" -l exclude-local-docs -d "Skip copying docs"
+complete -c mdl -n "__fish_seen_subcommand_from new" -s h -l help -d "Help"
 
 # completion subcommands
 complete -c mdl -n "__fish_seen_subcommand_from completion" -a "print" -d "Print completion script"
 complete -c mdl -n "__fish_seen_subcommand_from completion" -a "install" -d "Install completion"
 complete -c mdl -n "__fish_seen_subcommand_from completion" -a "uninstall" -d "Uninstall completion"
 complete -c mdl -n "__fish_seen_subcommand_from completion" -a "doctor" -d "Diagnose setup"
+complete -c mdl -n "__fish_seen_subcommand_from completion" -a "bash zsh fish powershell" -d "Shell"
 
 # docs subcommands
 complete -c mdl -n "__fish_seen_subcommand_from docs" -a "open" -d "Open docs website"
 complete -c mdl -n "__fish_seen_subcommand_from docs" -a "serve" -d "Serve docs locally"
+complete -c mdl -n "__fish_seen_subcommand_from docs" -l port -d "Port" -r
+complete -c mdl -n "__fish_seen_subcommand_from docs" -l dir -d "Docs directory" -r -F
+complete -c mdl -n "__fish_seen_subcommand_from docs" -s h -l help -d "Help"
 

minecraft_datapack_language/completions/mdl.ps1

@@ -3,24 +3,24 @@ Register-ArgumentCompleter -Native -CommandName mdl -ScriptBlock {
     $line = $commandAst.ToString()
     $parts = [System.Management.Automation.PSParser]::Tokenize($line, [ref]$null) | Where-Object { $_.Type -eq 'CommandArgument' } | ForEach-Object { $_.Content }
     if ($parts.Count -lt 1) {
-        'build','check','new','completion','docs' | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
+        'build','check','new','completion','docs','--help','-h','--version' | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
         return
     }
     switch ($parts[0]) {
         'build' {
-            '--mdl','-o','--output','--verbose','--wrapper','--no-zip' | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterName', $_) }
+            '--mdl','-o','--output','--verbose','--wrapper','--no-zip','--help','-h' | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterName', $_) }
         }
         'check' {
-            '--verbose' | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterName', $_) }
+            '--verbose','--help','-h' | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterName', $_) }
         }
         'new' {
-            '--pack-name','--pack-format','--output','--exclude-local-docs' | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterName', $_) }
+            '--pack-name','--pack-format','--output','--exclude-local-docs','--help','-h' | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterName', $_) }
         }
         'completion' {
-            'print','install','uninstall','doctor' | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
+            'print','install','uninstall','doctor','--help','-h' | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
         }
         'docs' {
-            'open','serve' | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
+            'open','serve','--help','-h','--port','--dir' | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
         }
     }
 }

minecraft_datapack_language/completions/mdl.zsh

@@ -3,24 +3,31 @@ _mdl() {
   local -a subcmds
   subcmds=(build check new completion docs)
   if (( CURRENT == 2 )); then
+    _arguments '-h[Show help]' '--help[Show help]' '--version[Show version]'
     _describe 'command' subcmds
     return
   fi
   case $words[2] in
     build)
-      _arguments '*:file:_files' '--mdl' '-o' '--output' '--verbose' '--wrapper' '--no-zip'
+      _arguments '-h[Help]' '--help[Help]' '*:file:_files' '--mdl[MDL file or dir]:file:_files' '-o[Output dir]:dir:_files -/' '--output[Output dir]:dir:_files -/' '--verbose[Verbose]' '--wrapper[Wrapper name]' '--no-zip[No zip]'
       ;;
     check)
-      _arguments '*:file:_files' '--verbose'
+      _arguments '-h[Help]' '--help[Help]' '*:file:_files' '--verbose[Verbose]'
       ;;
     new)
-      _arguments '--pack-name' '--pack-format' '--output' '--exclude-local-docs'
+      _arguments '-h[Help]' '--help[Help]' '--pack-name[Datapack name]:name:' '--pack-format[Pack format]:number:' '--output[Project dir]:dir:_files -/' '--exclude-local-docs[Skip docs]'
       ;;
     completion)
       _values 'subcommands' 'print' 'install' 'uninstall' 'doctor'
+      if (( CURRENT == 3 )); then
+        _values 'shells' 'bash' 'zsh' 'fish' 'powershell'
+      fi
       ;;
     docs)
       _values 'subcommands' 'open' 'serve'
+      if [[ $words[3] == 'serve' ]]; then
+        _arguments '-h[Help]' '--help[Help]' '--port[Port]:port:' '--dir[Docs directory]:dir:_files -/'
+      fi
       ;;
   esac
 }

{minecraft_datapack_language-17.0.17.dist-info → minecraft_datapack_language-17.0.19.dist-info}/METADATA

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

@@ -1,5 +1,5 @@
 minecraft_datapack_language/__init__.py,sha256=0KVXBE4ScRaRUrf83aA2tVB-y8A_jplyaxVvtHH6Uw0,1199
-minecraft_datapack_language/_version.py,sha256=F982JyudZUgKLb_l8E824STl3OfuPRv1vynXujKi1ko,708
+minecraft_datapack_language/_version.py,sha256=Gua8b2JeyO4z8omwdoLMdGROUlZevbXl66stvCu_xq4,708
 minecraft_datapack_language/ast_nodes.py,sha256=L5izavSeXDr766vsfRvJrcnflXNJyXcy0WSfyJPq2ZA,4484
 minecraft_datapack_language/cli.py,sha256=XQ1MgPnP2gKQeYe29Z9w-AAcaRDHX-lTV9SiKp-rmzg,23800
 minecraft_datapack_language/dir_map.py,sha256=HmxFkuvWGkzHF8o_GFb4BpuMCRc6QMw8UbmcAI8JVdY,1788
@@ -17,13 +17,13 @@ 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=x75thz8uwcErSuSs31vn3yUIyvRmRDTiArNXYZ4IetY,70
+minecraft_datapack_language/_embedded/docs/_data/version.yml,sha256=pFJQH25-nh4lW5lzg4ae8G65ZjsfErZdiq1Z0s9-HZE,70
 minecraft_datapack_language/_embedded/docs/_docs/cli-reference.md,sha256=S10YRQcYicRGq4LL_x4VTsxrd4fp9fNy_HcEKKy6bjM,12302
 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
 minecraft_datapack_language/_embedded/docs/_docs/examples.md,sha256=06KnM7EmB9vIhYgNpKWdkgeo517HxDeYol__Hyxfcpo,3920
-minecraft_datapack_language/_embedded/docs/_docs/getting-started.md,sha256=l7wt57Eqe1qrrBzCpYQiCsGiPg453DA0E3VG_6Clex8,4854
+minecraft_datapack_language/_embedded/docs/_docs/getting-started.md,sha256=f4DWeJeOB8Xzk0LpcQZKZZRcQWQ_gYHSnHKIGhOJESs,4936
 minecraft_datapack_language/_embedded/docs/_docs/language-reference.md,sha256=lSUyLN4N1JgF6VXRUMQNWFEHPWCUvIsmH26_Fmdx6pc,50671
 minecraft_datapack_language/_embedded/docs/_docs/multi-file-projects.md,sha256=DYVAbQxaJyT2DyGzfpYn6HWHa29Ji3sAamRzOqQ75hU,4260
 minecraft_datapack_language/_embedded/docs/_docs/python-bindings.md,sha256=wV91MPzLw-YGZOkufMwg1zCBxL0C6NhpU2H2F7h5xpc,12094
@@ -44,13 +44,13 @@ minecraft_datapack_language/_embedded/docs/icons/icon-128.png,sha256=8qLrcvJstu_
 minecraft_datapack_language/_embedded/docs/icons/icon-256.png,sha256=xGBlOusbqOz9IK4y00mdTOwnmBodUhW3hYVwPMTDaP0,73748
 minecraft_datapack_language/_embedded/docs/icons/icon-512.png,sha256=gnvZTDfMAWlIvQ5t9Vi1Kixr8_IVjqXD55iAbhmPmGI,351088
 minecraft_datapack_language/_embedded/docs/icons/icon-64.png,sha256=FlYhdwjQ6U9-AvREJ0Ic3jZ6LLpWlEBl1fRvgZ3AdPI,6403
-minecraft_datapack_language/completions/mdl.bash,sha256=CclfMEuE2w6fqLEcIsTncyFg-XdJjwvp1zCF87jBhBc,962
-minecraft_datapack_language/completions/mdl.fish,sha256=iZOFQKMiPyQ5Tqaw1SQYK3b1Rc17DnEJEXc2pTdEIPc,2010
-minecraft_datapack_language/completions/mdl.ps1,sha256=mPK3zWI5JFhGKmvhgpGeiUdqNJDaGXoZufOaPNlJUxQ,1751
-minecraft_datapack_language/completions/mdl.zsh,sha256=wLiAhrL9iVqUiAUzkjtDZZcDLHDGPpNBYkZQcuWoWNg,640
-minecraft_datapack_language-17.0.17.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-minecraft_datapack_language-17.0.17.dist-info/METADATA,sha256=9WsWFOcoBOQk1Rso-0f0jIog8q4A757JO4hnbs1qjyk,8418
-minecraft_datapack_language-17.0.17.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-minecraft_datapack_language-17.0.17.dist-info/entry_points.txt,sha256=c6vjBeCiyQflvPHBRyBk2nJCSfYt3Oc7Sc9V87ySi_U,108
-minecraft_datapack_language-17.0.17.dist-info/top_level.txt,sha256=ADtFI476tbKLLxEAA-aJQAfg53MA3k_DOb0KTFiggfw,28
-minecraft_datapack_language-17.0.17.dist-info/RECORD,,
+minecraft_datapack_language/completions/mdl.bash,sha256=WNGcSaVJo092o5ScR6h0sRZ4r9NzcunGAhcNkWCh2xM,2176
+minecraft_datapack_language/completions/mdl.fish,sha256=wPBywK1qTJmkB_06UltkuzjwfNz_SDoZamvwLQCXxBI,2689
+minecraft_datapack_language/completions/mdl.ps1,sha256=fSsNNps9-4h-RS-M--iBySbyLG0Dv52kTBGb4k1qNkQ,1864
+minecraft_datapack_language/completions/mdl.zsh,sha256=xiuNPasD-Thi9rc5T2j_GqHQOYOVG36LE_jI74IQuoQ,1252
+minecraft_datapack_language-17.0.19.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+minecraft_datapack_language-17.0.19.dist-info/METADATA,sha256=qT6F37C5fjHWJ5nIy-FTtv873zyrx95x1OZ8KNBLImk,8418
+minecraft_datapack_language-17.0.19.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+minecraft_datapack_language-17.0.19.dist-info/entry_points.txt,sha256=c6vjBeCiyQflvPHBRyBk2nJCSfYt3Oc7Sc9V87ySi_U,108
+minecraft_datapack_language-17.0.19.dist-info/top_level.txt,sha256=ADtFI476tbKLLxEAA-aJQAfg53MA3k_DOb0KTFiggfw,28
+minecraft_datapack_language-17.0.19.dist-info/RECORD,,