Merge pull request #11 from michaeltlombardi/maint/main/fix-tstoy-install

(MAINT) Fix and update tstoy install info

Author: sdwheeler

.gitattributes

@@ -1,3 +1,5 @@
 * text eol=lf
-*.png binary
-*.gif binary
+*.png    binary
+*.gif    binary
+*.zip    binary
+*.tar.gz binary

.site/assets/styles/_custom.scss

@@ -0,0 +1,8 @@
+sl-tab-group.shell-completion {
+    sl-tab {
+        &::part(base) {
+            padding-top: 0.5rem;
+            padding-bottom: 0.5rem;
+        }
+    }
+}

docs/tstoy/about.md

@@ -15,9 +15,29 @@ manage the configuration files.
 
 ## Installing TSToy
 
-[Download the latest release][01] for your operating system. After you download the release
-archive, you need to expand the archive and add it to your PATH. You'll need the application while
-following any of the tutorials in this section.
+```````````tabs
+---
+id:        install-instructions
+placement: start
+---
+``````tab { name="From Archive" }
+[Download the latest release][t1] for your operating system. After you download
+the release archive, you need to expand the archive and add it to your `PATH`.
+You'll need the application while following any of the tutorials in this
+section.
+
+[t1]: https://github.com/PowerShell/DSC-Samples/tree/main/tstoy/latest
+``````
+
+``````tab { name="With Go" }
+If you have Go installed on your system, you can use `go install` to get the
+latest version of the application and install it to your `GOPATH`.
+
+```sh
+go install github.com/PowerShell/DSC-Samples/tstoy@latest
+```
+``````
+```````````
 
 <!-- Add tabbed examples for doing so -->
 
@@ -30,29 +50,44 @@ tstoy
 
 You can enable shell completions for the application to make interacting with it easier.
 
+```````````tabs
+---
+id: enable-shell-completions
+placement: start
+class: shell-completion
+---
+``````tab { name="Bash" }
 ```bash
 # bash
 tstoy completion bash --help
 source <(tstoy completion bash)
 ```
+``````
 
-```sh
+``````tab { name="fish" }
+```fish
 # fish
 tstoy completion fish --help
 tstoy completion fish | source
 ```
+``````
 
+``````tab { name="PowerShell" }
 ```powershell
 # PowerShell
 tstoy completion powershell --help
 tstoy completion powershell | Out-String | Invoke-Expression
 ```
+``````
 
+``````tab { name="ZSH" }
 ```zsh
 # zsh
 tstoy completion zsh --help
 source <(tstoy completion zsh)
 ```
+``````
+```````````
 
 ## TSToy configuration
 
@@ -106,7 +141,10 @@ tstoy show path machine
 tstoy show path user
 ```
 
-``````tabs { #command-output}
+``````tabs
+---
+id: command-output
+---
 ````tab { name="On Windows" }
 ```powershell
 tstoy show path
@@ -188,6 +226,3 @@ tstoy show --only machine,user
 Machine configuration: {}
 User configuration: {}
 ```
-
-<!-- Fictional URL -->
-[01]: https://github.com/MicrosoftDocs/DSC-Examples/releases/tag/app%2Fv1.0.0

go.work

@@ -1,6 +1,6 @@
 go 1.19
 
 use (
-	./app
+	./tstoy
 	./samples/go/resources/first
 )

netlify.toml

@@ -2,7 +2,7 @@
 base = ".site/"
 publish = "public"
 command = "../netlify.sh"
-ignore = "git diff --quiet $CACHED_COMMIT_REF $COMMIT_REF . ./docs ./samples ./app"
+ignore = "git diff --quiet $CACHED_COMMIT_REF $COMMIT_REF . ./docs ./samples ./tstoy"
 
 [context.production.environment]
 HUGO_VERSION = "0.116.1"

app/.gitignore renamed to tstoy/.gitignore

@@ -16,9 +16,9 @@ builds:
       - darwin
     ldflags:
       - -s -w
-      - -X github.com/PowerShell/DSC-Samples/app/cmd.version={{.Version}}
-      - -X github.com/PowerShell/DSC-Samples/app/cmd.commit={{.ShortCommit}}
-      - -X github.com/PowerShell/DSC-Samples/app/cmd.date={{.CommitDate}}
+      - -X github.com/PowerShell/DSC-Samples/tstoy/cmd.version={{.Version}}
+      - -X github.com/PowerShell/DSC-Samples/tstoy/cmd.commit={{.ShortCommit}}
+      - -X github.com/PowerShell/DSC-Samples/tstoy/cmd.date={{.CommitDate}}
 
 archives:
   - format: tar.gz
@@ -44,7 +44,6 @@ changelog:
     exclude:
       - '^docs:'
       - '^test:'
-
 # The lines beneath this are called `modelines`. See `:help modeline`
 # Feel free to remove those if you don't want/use them.
 # yaml-language-server: $schema=https://goreleaser.com/static/schema.json

app/.goreleaser.yaml renamed to tstoy/.goreleaser.yaml

@@ -16,12 +16,43 @@ function Build-Project {
     param(
         [switch]$All
     )
-    if ($All) {
-        goreleaser release --skip-publish --skip-announce --skip-validate --clean --release-notes ./RELEASE_NOTES.md
-    } else {
-        goreleaser build --snapshot --clean --single-target
+
+    begin {
+        [string[]]$Arguments = @(
+            '--clean'
+            '--snapshot'
+        )
+        $DistFolder   = "$PSScriptRoot/dist"
+        $LatestFolder = "$PSScriptRoot/latest"
     }
-    Get-Command "./dist/tstoy*/tstoy*" -ErrorAction Stop
+    process {
+        if ($All) {
+            $Arguments += @(
+                '--skip-publish'
+                '--skip-announce'
+                '--skip-validate'
+            )
+            goreleaser release @Arguments
+            
+            if (Test-Path $LatestFolder) {
+                Remove-Item -Path $LatestFolder/* -Force -Recurse
+            } else {
+                mkdir $LatestFolder
+            }
+
+            Get-ChildItem -Path $DistFolder -File
+            | Where-Object -FilterScript { $_.Name -match '\.(txt|tar\.gz|zip)'}
+            | Move-Item -Destination $LatestFolder
+        } else {
+            $Arguments += @(
+                '--single-target'
+            )
+            goreleaser build @Arguments
+            Get-Command "./dist/tstoy*/tstoy*" -ErrorAction Stop
+        }
+    }
+
+    end { }
 }
 
 switch ($Target) {