PyPI - minecraft-datapack-language - Versions diffs - 17.0.13__tar.gz → 17.0.14__tar.gz - Mend

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: minecraft-datapack-language
-Version: 17.0.13
+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

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

@@ -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

@@ -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.14'
+__version_tuple__ = version_tuple = (17, 0, 14)
-__commit_id__ = commit_id = 'g39419c714'
+__commit_id__ = commit_id = 'g0fcb14187'

@@ -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')

@@ -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
 }

@@ -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"

@@ -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', $_) }
         }
     }
 }

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

@@ -86,6 +86,8 @@ rm -rf dist
 if command -v python >/dev/null 2>&1; then
   python -m pip install --upgrade pip >/dev/null 2>&1 || true
   python -m pip install build >/dev/null 2>&1 || true
+  # Avoid .post0 when building after tagging but with a dirty tree due to sync steps
+  export SETUPTOOLS_SCM_PRETEND_VERSION="${NEW_TAG#v}"
   python -m build || true
 fi

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

minecraft-datapack-language 17.0.13__tar.gz → 17.0.14__tar.gz

minecraft-datapack-language 17.0.13tar.gz → 17.0.14tar.gz