refactor: build scripts

Author: hamed-shirbandi

src/4-Build/README.md

@@ -0,0 +1,99 @@
+# Build Scripts
+
+This directory contains build scripts organized by functionality in the `scripts` folder:
+
+```
+scripts/
+├── compile/          # Compilation scripts
+├── lint/            # Code linting scripts
+├── packages/        # Package management scripts
+└── tests/           # Test runner scripts
+```
+
+Each directory contains scripts in multiple formats for cross-platform compatibility:
+- `.bat` - Windows batch files
+- `.ps1` - PowerShell scripts (cross-platform)
+- `.sh` - Shell scripts (Unix-based systems)
+
+## Running Scripts on Windows
+
+### Batch Files (.bat)
+- Simply double-click the `.bat` file in the appropriate directory
+- Or run from command prompt: `scripts\category\ScriptName.bat`
+  Example: `scripts\compile\Compile.bat`
+
+### PowerShell Scripts (.ps1)
+1. Right-click method:
+   - Right-click on the `.ps1` file in the appropriate directory
+   - Select "Run with PowerShell"
+
+2. Command line method:
+   - Open PowerShell
+   - Navigate to this directory
+   - Run: `.\scripts\category\ScriptName.ps1`
+   Example: `.\scripts\compile\Compile.ps1`
+
+   If you get a security error, you may need to allow script execution:
+   ```powershell
+   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
+   ```
+
+### Shell Scripts (.sh)
+To run `.sh` files on Windows, you need one of these installed:
+1. Git Bash (recommended, comes with Git for Windows):
+   ```bash
+   ./scripts/category/ScriptName.sh
+   ```
+   Example: `./scripts/compile/Compile.sh`
+
+2. Windows Subsystem for Linux (WSL):
+   ```bash
+   bash scripts/category/ScriptName.sh
+   ```
+
+## Running Scripts on macOS/Linux
+
+### Shell Scripts (.sh)
+1. Open terminal
+2. Navigate to this directory
+3. Make scripts executable (one-time setup):
+   ```bash
+   chmod +x scripts/**/*.sh
+   ```
+4. Run the script:
+   ```bash
+   ./scripts/category/ScriptName.sh
+   ```
+   Example: `./scripts/compile/Compile.sh`
+
+### PowerShell Scripts (.ps1)
+1. Install PowerShell if not already installed
+2. Open terminal
+3. Navigate to this directory
+4. Run:
+   ```bash
+   pwsh scripts/category/ScriptName.ps1
+   ```
+   Example: `pwsh scripts/compile/Compile.ps1`
+
+## Available Scripts
+
+### Compile
+- Location: `scripts/compile/`
+- Purpose: Compiles the project
+- Files: `Compile.bat`, `Compile.ps1`, `Compile.sh`
+
+### Lint
+- Location: `scripts/lint/`
+- Purpose: Runs code linting
+- Files: `Lint.bat`, `Lint.ps1`, `Lint.sh`
+
+### Tests
+- Location: `scripts/tests/`
+- Purpose: Runs unit tests
+- Files: `RunUnitTests.bat`, `RunUnitTests.ps1`, `RunUnitTests.sh`
+
+### Packages
+- Location: `scripts/packages/`
+- Purpose: Updates CodeBlock.DevKit NuGet packages
+- Files: `UpdateDevKitPackages.bat`, `UpdateDevKitPackages.ps1`, `UpdateDevKitPackages.sh` 

src/4-Build/UpdateDevKitPackages.bat

@@ -1,7 +1,7 @@
 @echo off
-cd /d "%~dp0"
+cd /d "%~dp0..\.."
 
 echo Running: nuke Compile
 nuke Compile
 
-pause
+pause 

src/4-Build/Compile.bat src/4-Build/scripts/compile/Compile.batsrc/4-Build/Compile.bat renamed to src/4-Build/scripts/compile/Compile.bat

@@ -0,0 +1,9 @@
+Set-Location -Path (Split-Path -Parent (Split-Path -Parent $PSScriptRoot))
+
+Write-Host "Running: nuke Compile"
+nuke Compile
+
+if ($Host.Name -eq "ConsoleHost") {
+    Write-Host "Press any key to continue..."
+    $Host.UI.RawUI.ReadKey("NoEcho,IncludeKeyUp") > $null
+} 

src/4-Build/scripts/compile/Compile.ps1

@@ -0,0 +1,5 @@
+#!/bin/bash
+cd "$(dirname "$(dirname "$(dirname "$0")")")"
+
+echo "Running: nuke Compile"
+nuke Compile 

src/4-Build/scripts/compile/Compile.sh

@@ -1,7 +1,7 @@
 @echo off
-cd /d "%~dp0"
+cd /d "%~dp0..\.."
 
 echo Running: nuke Lint
 nuke Lint
 
-pause
+pause 

src/4-Build/Lint.bat src/4-Build/scripts/lint/Lint.batsrc/4-Build/Lint.bat renamed to src/4-Build/scripts/lint/Lint.bat

@@ -0,0 +1,9 @@
+Set-Location -Path (Split-Path -Parent (Split-Path -Parent $PSScriptRoot))
+
+Write-Host "Running: nuke Lint"
+nuke Lint
+
+if ($Host.Name -eq "ConsoleHost") {
+    Write-Host "Press any key to continue..."
+    $Host.UI.RawUI.ReadKey("NoEcho,IncludeKeyUp") > $null
+} 

src/4-Build/scripts/lint/Lint.ps1

@@ -0,0 +1,5 @@
+#!/bin/bash
+cd "$(dirname "$(dirname "$(dirname "$0")")")"
+
+echo "Running: nuke Lint"
+nuke Lint 

src/4-Build/scripts/lint/Lint.sh

@@ -1,7 +1,7 @@
 @echo off
-cd /d "%~dp0"
+cd /d "%~dp0..\.."
 
 echo Running: nuke RunUnitTests
 nuke RunUnitTests
 
-pause
+pause 

src/4-Build/RunUnitTests.bat …c/4-Build/scripts/tests/RunUnitTests.batsrc/4-Build/RunUnitTests.bat renamed to src/4-Build/scripts/tests/RunUnitTests.bat src/4-Build/RunUnitTests.bat renamed to src/4-Build/scripts/tests/RunUnitTests.bat

@@ -0,0 +1,9 @@
+Set-Location -Path (Split-Path -Parent (Split-Path -Parent $PSScriptRoot))
+
+Write-Host "Running: nuke RunUnitTests"
+nuke RunUnitTests
+
+if ($Host.Name -eq "ConsoleHost") {
+    Write-Host "Press any key to continue..."
+    $Host.UI.RawUI.ReadKey("NoEcho,IncludeKeyUp") > $null
+}