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

minecraft_datapack_language/_embedded/docs/_data/version.yml

@@ -1,3 +1,3 @@
-current: "17.0.11"
-tag: "v17.0.11"
-updated_at: "2025-09-11T00:02:50Z"
+current: "17.0.13"
+tag: "v17.0.13"
+updated_at: "2025-09-11T00:09:19Z"

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

@@ -194,13 +194,25 @@ Serve the docs quickly with the generated scripts:
 
 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:
+You can open the docs site in your browser via the CLI:
 
 ```bash
-mdl docs serve --dir docs --port 8000
+mdl docs            # opens Getting Started in your default browser
+mdl docs open       # same as above
+mdl docs serve --dir docs --port 8000   # optional: serve local docs (if you prefer)
 ```
 
-This starts a local web server for the `docs/` directory.
+When running `mdl new`, the output will list all generated files:
+
+```
+my_awesome_pack/
+├── README.md
+├── main.mdl
+├── docs/
+├── docs_site/          # present when packaged HTML is available
+├── serve_docs.sh
+└── serve_docs.ps1
+```
 
 ## Completion Command
 

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.13'
-__version_tuple__ = version_tuple = (17, 0, 13)
+__version__ = version = '17.0.15'
+__version_tuple__ = version_tuple = (17, 0, 15)
 
 __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)')
@@ -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")
@@ -605,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.13.dist-info → minecraft_datapack_language-17.0.15.dist-info}/METADATA

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

@@ -1,7 +1,7 @@
 minecraft_datapack_language/__init__.py,sha256=0KVXBE4ScRaRUrf83aA2tVB-y8A_jplyaxVvtHH6Uw0,1199
-minecraft_datapack_language/_version.py,sha256=GPSstnQDn_-Sa-bWyjdBVUBYrZ2l-Pj6XNIJ0_QZ0KA,708
+minecraft_datapack_language/_version.py,sha256=tHN1fFqPv9XNMsggJrXhKBILeLrHqMo9ckFmJjl3jCQ,708
 minecraft_datapack_language/ast_nodes.py,sha256=L5izavSeXDr766vsfRvJrcnflXNJyXcy0WSfyJPq2ZA,4484
-minecraft_datapack_language/cli.py,sha256=PY_89LAZVpYWOZb7HGfkpKWNM1-LqpYRcuosRRL-Y_k,23203
+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,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=BR5CMdoU-1_4u_Sz5hoFLflEucNupYJoLRn0mb7zZ28,70
-minecraft_datapack_language/_embedded/docs/_docs/cli-reference.md,sha256=yrZW8pp6T124XCUKuG-59S5YDY0WevaIQ7SwfXQ_Irw,11922
+minecraft_datapack_language/_embedded/docs/_data/version.yml,sha256=k3LWDGTTJ36dYbhkGKJkTrO4jO7dyWkw3-U8qFlLxXM,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
@@ -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.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,,
+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.15.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+minecraft_datapack_language-17.0.15.dist-info/METADATA,sha256=OqtrKpbIGbW3ki9fegJvCGH6pS9eZTxclZQUBBW1ZOQ,8418
+minecraft_datapack_language-17.0.15.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+minecraft_datapack_language-17.0.15.dist-info/entry_points.txt,sha256=c6vjBeCiyQflvPHBRyBk2nJCSfYt3Oc7Sc9V87ySi_U,108
+minecraft_datapack_language-17.0.15.dist-info/top_level.txt,sha256=ADtFI476tbKLLxEAA-aJQAfg53MA3k_DOb0KTFiggfw,28
+minecraft_datapack_language-17.0.15.dist-info/RECORD,,