Reorganize tools/cmdline sub scripts (#3247)

Reorganize tools/cmdline: move scripts to plugins/, register as axmol subcommands

- Move 13 utility files from tools/cmdline/ to tools/cmdline/plugins/
- Keep only entry points (axmol, axmol.bat, axmol.ps1) and README.md
- Update  paths for AX_ROOT calculation (+1 level deep)
- Register 5 new subcommands: source-lint, clang-format, genbindings, build-docs, publish
- Update CI workflow and doc references to use plugins/ paths
- Remove stale make-pkg.ps1 references from CI paths-ignore

Author: halx99

.github/workflows/build.yml

@@ -12,7 +12,6 @@ on:
       - '.github/workflows/publish.yml'
       - '.github/workflows/debian.yml'
       - '.github/workflows/source-tidy.yml'
-      - 'tools/cmdline/make-pkg.ps1'
   pull_request:
     types: [opened, synchronize, reopened]
     paths-ignore:

.github/workflows/genbindings.yml

@@ -10,7 +10,6 @@ on:
       - '**/*.md.in'
       - 'docs/**'
       - '.github/workflows/publish.yml'
-      - 'tools/cmdline/make-pkg.ps1'
       - '.github/workflows/debian.yml'
 
   workflow_dispatch:
@@ -27,7 +26,7 @@ jobs:
         python-version: '3.12.10' # python-3.12 is last release that support axmol traditional binding generator
 
     - name: Genbindings
-      run: tools\cmdline\genbindings.ps1
+      run: tools\cmdline\plugins\genbindings.ps1
 
     - name: Create pull request
       if: ${{ env.BINDING_NO_CHANGES != 'true' }}

.github/workflows/publish.yml

@@ -54,7 +54,7 @@ jobs:
         axmol -xc '-DAX_WITH_LZ4=ON,-DAX_WITH_CARES=ON,-DAX_WITH_YAML_CPP=ON,-DAX_WITH_KCP=ON' -c
         $input_commitish = "${{ github.event.inputs.commitish }}"
         if (!$input_commitish) { $input_commitish = $(git -C $AX_ROOT branch --show-current) }
-        ./tools/cmdline/publish.ps1 -version "${{ steps.check_ver.outputs.release_ver }}" -commitish $input_commitish
+        ./tools/cmdline/plugins/publish.ps1 -version "${{ steps.check_ver.outputs.release_ver }}" -commitish $input_commitish
         echo "commitish=$input_commitish" >> ${env:GITHUB_OUTPUT}
 
     - name: Publish to github release page

.github/workflows/source-tidy.yml

@@ -146,7 +146,7 @@ jobs:
     - name: Lint Axmol source files (UTF-8 BOM & cstd headers)
       if: ${{ steps.pp.outputs.should_run == 'true' }}
       shell: pwsh
-      run: ./tools/cmdline/source-lint.ps1
+      run: ./tools/cmdline/plugins/source-lint.ps1
 
     - name: Install llvm clang-format
       if: ${{ steps.pp.outputs.should_run == 'true' }}
@@ -159,7 +159,7 @@ jobs:
       if: ${{ steps.pp.outputs.should_run == 'true' }}
       shell: pwsh
       run: |
-        ./tools/cmdline/clang-format.ps1 -ver $env:LLVM_VER
+        ./tools/cmdline/plugins/clang-format.ps1 -ver $env:LLVM_VER
 
     # check_only mode
     - name: Check for uncommitted changes

tools/cmdline/axmol.ps1

@@ -50,6 +50,11 @@ Available commands:
         build        Compile projects to binary.
         deploy       Compile and deploy a project to a device/simulator.
         run          Compiles, deploy and run project on the target.
+        source-lint  Lint axmol source files (UTF-8 BOM & cstd headers).
+        clang-format Format source files using clang-format.
+        genbindings  Generate Lua bindings for axmol engine.
+        build-docs   Build axmol documentation.
+        publish      Publish axmol release.
 
 Available arguments:
         -h           Show this help information.
@@ -83,7 +88,7 @@ if ($IsMacOS) {
 function axmol_build() {
     $sub_args = $args
     println $sub_args
-    $build_script = Join-Path $PSScriptRoot 'build.ps1'
+    $build_script = Join-Path $PSScriptRoot 'plugins/build.ps1'
     if ("$args".Contains('-d')) {
         # have proj dir
         . $build_script @sub_args
@@ -250,7 +255,7 @@ function axmol_run() {
 
 $builtinPlugins = @{
     new    = @{
-        proc  = (Join-Path $PSScriptRoot 'axmol_new.ps1');
+        proc  = (Join-Path $PSScriptRoot 'plugins/axmol_new.ps1');
         usage = @"
 usage: axmol new -p dev.axmol.hellocpp -d path/to/project -l cpp --portrait <ProjectName>
 Creates a new project.
@@ -352,6 +357,63 @@ options:
   -c: no build, only generate native project files (vs .sln, xcodeproj)
   -d: specify project dir to compile, i.e. -d /path/your/project/
   -f: force generate native project files. Useful if no changes are detected, such as with resource updates.
+"@
+    };
+    'source-lint' = @{
+        proc  = (Join-Path $PSScriptRoot 'plugins/source-lint.ps1');
+        usage = @"
+usage: axmol source-lint
+
+Lint axmol source files (UTF-8 BOM & cstd headers).
+
+options:
+  -h    Show this help message.
+"@
+    };
+    'clang-format' = @{
+        proc  = (Join-Path $PSScriptRoot 'plugins/clang-format.ps1');
+        usage = @"
+usage: axmol clang-format -ver <llvm-version>
+
+Format source files using clang-format.
+
+options:
+  -h          Show this help message.
+  -ver        LLVM/clang-format version to use.
+"@
+    };
+    genbindings = @{
+        proc  = (Join-Path $PSScriptRoot 'plugins/genbindings.ps1');
+        usage = @"
+usage: axmol genbindings
+
+Generate Lua bindings for axmol engine.
+
+options:
+  -h    Show this help message.
+"@
+    };
+    'build-docs' = @{
+        proc  = (Join-Path $PSScriptRoot 'plugins/build-docs.ps1');
+        usage = @"
+usage: axmol build-docs
+
+Build axmol documentation.
+
+options:
+  -h    Show this help message.
+"@
+    };
+    publish = @{
+        proc  = (Join-Path $PSScriptRoot 'plugins/publish.ps1');
+        usage = @"
+usage: axmol publish -version <ver>
+
+Publish axmol release.
+
+options:
+  -h          Show this help message.
+  -version    Release version to publish.
 "@
     }
 }

tools/cmdline/axmol-ci.jks tools/cmdline/plugins/axmol-ci.jkstools/cmdline/axmol-ci.jks renamed to tools/cmdline/plugins/axmol-ci.jks

@@ -11,7 +11,7 @@ $isWin = $IsWindows -or ("$env:OS" -eq 'Windows_NT')
 
 $pwsh_ver = $PSVersionTable.PSVersion.ToString()
 
-$AX_ROOT = (Resolve-Path $PSScriptRoot/../..)
+$AX_ROOT = (Resolve-Path $PSScriptRoot/../../..)
 
 $git_prog = (Get-Command 'git' -ErrorAction SilentlyContinue).Source
 if (!$git_prog) {