minecraft-datapack-language 17.0.12__py3-none-any.whl → 17.0.14__py3-none-any.whl

minecraft_datapack_language/_embedded/docs/_data/version.yml

@@ -1,3 +1,3 @@
-current: "17.0.10"
-tag: "v17.0.10"
-updated_at: "2025-09-10T23:56:34Z"
+current: "17.0.12"
+tag: "v17.0.12"
+updated_at: "2025-09-11T00:04:18Z"

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

minecraft_datapack_language/cli.py

@@ -74,8 +74,9 @@ Examples:
     completion_sub.add_parser('doctor', help='Diagnose completion install status')
 
     # Docs command
-    docs_parser = subparsers.add_parser('docs', help='Docs utilities')
+    docs_parser = subparsers.add_parser('docs', help='Open or serve docs')
     docs_sub = docs_parser.add_subparsers(dest='docs_cmd', help='Docs subcommands')
+    docs_sub.add_parser('open', help='Open the MDL Getting Started docs in your browser')
     docs_serve = docs_sub.add_parser('serve', help='Serve project docs locally')
     docs_serve.add_argument('--port', type=int, default=8000, help='Port to serve on (default: 8000)')
     docs_serve.add_argument('--dir', default='docs', help='Docs directory to serve (default: docs)')
@@ -92,11 +93,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:
@@ -352,6 +353,11 @@ A Minecraft datapack created with MDL (Minecraft Datapack Language).
     print(f"Created new MDL project: {project_dir}/")
     print(f"  - {mdl_file}")
     print(f"  - {readme_file}")
+    if (project_dir / 'docs').exists():
+        print("  - docs/ (local docs)")
+    if (project_dir / 'docs_site').exists():
+        print("  - docs_site/ (prebuilt HTML docs)")
+    print("  - serve_docs.sh, serve_docs.ps1")
     print(f"\nNext steps:")
     print(f"  1. cd {project_name}")
     print(f"  2. mdl build --mdl {project_name}.mdl -o dist")
@@ -366,6 +372,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 +380,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 +402,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 +425,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')
@@ -591,6 +611,16 @@ def _remove_line_from_file(path: Path, line: str) -> None:
 
 def docs_command(args) -> int:
     cmd = args.docs_cmd
+    # Default action: open website getting started page
+    if cmd is None or cmd == 'open':
+        try:
+            import webbrowser
+            webbrowser.open('https://www.mcmdl.com/docs/getting-started/')
+            print("Opened MDL Getting Started in your default browser.")
+            return 0
+        except Exception as e:
+            print(f"Failed to open browser: {e}")
+            return 1
     if cmd == 'serve':
         port = getattr(args, 'port', 8000)
         directory = getattr(args, 'dir', 'docs')

minecraft_datapack_language/completions/mdl.bash

@@ -27,7 +27,7 @@ _mdl_complete() {
       COMPREPLY=( $(compgen -W "print install uninstall doctor" -- "$cur") )
       ;;
     docs)
-      COMPREPLY=( $(compgen -W "serve" -- "$cur") )
+      COMPREPLY=( $(compgen -W "open serve" -- "$cur") )
       ;;
   esac
 }

minecraft_datapack_language/completions/mdl.fish

@@ -27,5 +27,6 @@ complete -c mdl -n "__fish_seen_subcommand_from completion" -a "uninstall" -d "U
 complete -c mdl -n "__fish_seen_subcommand_from completion" -a "doctor" -d "Diagnose setup"
 
 # 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"
 

minecraft_datapack_language/completions/mdl.ps1

@@ -20,7 +20,7 @@ Register-ArgumentCompleter -Native -CommandName mdl -ScriptBlock {
             'print','install','uninstall','doctor' | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
         }
         'docs' {
-            'serve' | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
+            'open','serve' | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
         }
     }
 }

minecraft_datapack_language/completions/mdl.zsh

@@ -20,7 +20,7 @@ _mdl() {
       _values 'subcommands' 'print' 'install' 'uninstall' 'doctor'
       ;;
     docs)
-      _values 'subcommands' 'serve'
+      _values 'subcommands' 'open' 'serve'
       ;;
   esac
 }

{minecraft_datapack_language-17.0.12.dist-info → minecraft_datapack_language-17.0.14.dist-info}/METADATA

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

@@ -1,7 +1,7 @@
 minecraft_datapack_language/__init__.py,sha256=0KVXBE4ScRaRUrf83aA2tVB-y8A_jplyaxVvtHH6Uw0,1199
-minecraft_datapack_language/_version.py,sha256=Na0c13EH4pNVBGzO7cGMn_hnIJYj2hp5GRQbBpTRUYk,708
+minecraft_datapack_language/_version.py,sha256=_XHqeKIfR4bcto9-z-EiMmSKIyboSjBra3o8Gv49fkQ,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=tT5jXsqOCrsJ-nmh4JwSjRT0ECwA1ycjt4q9ZreXdno,23929
 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,7 +17,7 @@ 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=DDmR8TgMb5RDCkwdjH2XPY8qWBnLIz7xICCVa6XviW0,70
+minecraft_datapack_language/_embedded/docs/_data/version.yml,sha256=7RkbL2QrWI5Dy0VECkPlo02A-ph5Zfd33xNV0X4yQwA,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
@@ -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=mlRdQ1PwoFwl7Fw5j7u0mhsNdxfbLSfkz1FMiI4DuWc,957
-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.12.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-minecraft_datapack_language-17.0.12.dist-info/METADATA,sha256=PhapTzt91Pa30EkUz0SYKIrU8xq3O1oPk6tT4mCN1is,8418
-minecraft_datapack_language-17.0.12.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-minecraft_datapack_language-17.0.12.dist-info/entry_points.txt,sha256=c6vjBeCiyQflvPHBRyBk2nJCSfYt3Oc7Sc9V87ySi_U,108
-minecraft_datapack_language-17.0.12.dist-info/top_level.txt,sha256=ADtFI476tbKLLxEAA-aJQAfg53MA3k_DOb0KTFiggfw,28
-minecraft_datapack_language-17.0.12.dist-info/RECORD,,
+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.14.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+minecraft_datapack_language-17.0.14.dist-info/METADATA,sha256=f3_Bqtyc6rCqYnuBEnyCgrsrW1w55Il9IJCzuw9MwzQ,8418
+minecraft_datapack_language-17.0.14.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+minecraft_datapack_language-17.0.14.dist-info/entry_points.txt,sha256=c6vjBeCiyQflvPHBRyBk2nJCSfYt3Oc7Sc9V87ySi_U,108
+minecraft_datapack_language-17.0.14.dist-info/top_level.txt,sha256=ADtFI476tbKLLxEAA-aJQAfg53MA3k_DOb0KTFiggfw,28
+minecraft_datapack_language-17.0.14.dist-info/RECORD,,