More updates

.github/workflows/check-code-snippets.yml

@@ -22,4 +22,4 @@ jobs:
           dotnet-version: "8.0.200"
 
       - name: Validate Code Snippets
-        run: pwsh ./check-code-snippets.ps1
+        run: pwsh ./bin/check-code-snippets.ps1

.github/workflows/test.yml

@@ -17,4 +17,4 @@ jobs:
       - uses: actions/setup-dotnet@6bd8b7f7774af54e05809fcc5431931b3eb1ddee
         with:
           dotnet-version: "8.0.200"
-      - run: pwsh ./test.ps1
+      - run: pwsh ./bin/test.ps1

add-practice-exercise.ps1 → bin/add-practice-exercise.ps1

@@ -11,7 +11,7 @@
     The difficulty of the exercise on a scale from 1 to 10 (optional, default: 1).
 .EXAMPLE
     The example below will add the "acronym" exercise
-    PS C:\> ./add-practice-exercise.ps1 acronym
+    PS C:\> bin/add-practice-exercise.ps1 acronym
 #>
 
 [CmdletBinding(SupportsShouldProcess)]

check-code-snippets.ps1 → bin/check-code-snippets.ps1

@@ -6,12 +6,8 @@
     - recursively search a list of directories for Markdown documentation
     - extract any F# code snippets
     - evaluate them to verify correct syntax (no type checking is performed)
-.PARAMETER SourceDirectories
-    A list of directories containing Markdown documentation (defaults to ["concepts","exercises"]).
-.PARAMETER Exclude
-    A list of directories to ignore (optional).
 .EXAMPLE
-    PS C:\> ./check-code-snippets.ps1
+    PS C:\> bin/check-code-snippets.ps1
     Verifies all *.md files under the `concepts` and `exercises` directories
 #>
 

test.ps1 → bin/test.ps1

@@ -11,10 +11,10 @@
     The slug of the exercise to verify (optional).
 .EXAMPLE
     The example below will verify the full solution
-    PS C:\> ./test.ps1
+    PS C:\> bin/test.ps1
 .EXAMPLE
     The example below will verify the "acronym" exercise
-    PS C:\> ./test.ps1 acronym
+    PS C:\> bin/test.ps1 acronym
 #>
 
 [CmdletBinding(SupportsShouldProcess)]

bin/update-exercise-tools.ps1

@@ -0,0 +1,15 @@
+<#
+.SYNOPSIS
+    Update exercise tools.
+.DESCRIPTION
+    Update the exercise tools for each exercise.
+.EXAMPLE
+    PS C:\> bin/update-exercise-tools.ps1
+#>
+
+$ErrorActionPreference = "Stop"
+$PSNativeCommandUseErrorActionPreference = $true
+
+Get-ChildItem -Path exercises -Filter dotnet-tools.json -Force -Recurse | ForEach-Object {
+    dotnet tool update fantomas-tool --tool-manifest $_.FullName
+}

bin/update-exercises.ps1

@@ -0,0 +1,32 @@
+<#
+.SYNOPSIS
+    Update the exercises.
+.DESCRIPTION
+    Update the exercises' docs, metadata, and tests.
+.PARAMETER Exercise
+    The slug of the exercise to update (optional).
+.EXAMPLE
+    The example below will update all exercises
+    PS C:\> bin/update-exercises.ps1
+.EXAMPLE
+    The example below will update the "acronym" exercise
+    PS C:\> bin/update-exercises.ps1 acronym
+#>
+
+[CmdletBinding(SupportsShouldProcess)]
+param (
+    [Parameter(Position = 0, Mandatory = $false)][string]$Exercise
+)
+
+$ErrorActionPreference = "Stop"
+$PSNativeCommandUseErrorActionPreference = $true
+
+& bin/fetch-configlet
+
+if ($Exercise) {
+    & configlet sync --docs --metadata --filepaths --update --yes --exercise $Exercise
+    & dotnet run --project generators --exercise $Exercise
+} else {
+    & configlet sync --docs --metadata --filepaths --update --yes
+    & dotnet run --project generators
+}