initial checkin

Author: kormic911

.github/workflows/release.yaml

@@ -0,0 +1,39 @@
+name: Publish release
+
+on:
+  push:
+    branches:
+      - main # Trigger on pushes to the main branch
+
+jobs:
+  publish_release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Create Version
+        uses: dexwritescode/release-on-merge-action@v1 # Or another suitable action
+        id: version_tracker
+        with:
+          version-increment-strategy: patch
+          dry-run: true
+          initial-version: '1.0.0'
+
+      - name: Modify the file
+        run: |
+          perl -pi -e 's/0\.0\.0/${{ steps.version_tracker.outputs.version }}' DevSetup.psd1
+
+      - name: Commit and push changes
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "Automated Release Tagging for ${{ steps.version_tracker.outputs.version }} in DevSetup.psd1"
+          branch: main
+
+      - name: Create Tagged Release
+        uses: dexwritescode/release-on-merge-action@v1 # Or another suitable action
+        with:
+          version-increment-strategy: patch                  

README.md

@@ -0,0 +1,2 @@
+# devsetup
+A tool used to setup dev environments

coverage.xml

@@ -0,0 +1,136 @@
+#
+# Module manifest for module 'DevSetup'
+#
+# Generated by: Joshua Wilson
+#
+# Generated on: 7/31/2025
+#
+
+@{
+
+# Script module or binary module file associated with this manifest.
+RootModule = 'DevSetup.psm1'
+
+# Version number of this module.
+ModuleVersion = '0.0.0'
+
+# Supported PSEditions
+# CompatiblePSEditions = @()
+
+# ID used to uniquely identify this module
+GUID = '316f7319-7063-492b-a5d3-dc32c616f157'
+
+# Author of this module
+Author = 'Joshua Wilson'
+
+# Company or vendor of this module
+CompanyName = 'PwshDevs'
+
+# Copyright statement for this module
+Copyright = '(c) 2025 PwshDevs. All rights reserved.'
+
+# Description of the functionality provided by this module
+Description = ''
+
+# Minimum version of the PowerShell engine required by this module
+PowerShellVersion = '5.1'
+
+# Name of the PowerShell host required by this module
+# PowerShellHostName = ''
+
+# Minimum version of the PowerShell host required by this module
+# PowerShellHostVersion = ''
+
+# Minimum version of Microsoft .NET Framework required by this module. This prerequisite is valid for the PowerShell Desktop edition only.
+# DotNetFrameworkVersion = ''
+
+# Minimum version of the common language runtime (CLR) required by this module. This prerequisite is valid for the PowerShell Desktop edition only.
+# ClrVersion = ''
+
+# Processor architecture (None, X86, Amd64) required by this module
+# ProcessorArchitecture = ''
+
+# Modules that must be imported into the global environment prior to importing this module
+RequiredModules = @('powershell-yaml', 'VSSetup', 'PowerShellForGitHub', 'EZlog')
+
+# Assemblies that must be loaded prior to importing this module
+# RequiredAssemblies = @()
+
+# Script files (.ps1) that are run in the caller's environment prior to importing this module.
+# ScriptsToProcess = @()
+
+# Type files (.ps1xml) to be loaded when importing this module
+# TypesToProcess = @()
+
+# Format files (.ps1xml) to be loaded when importing this module
+# FormatsToProcess = @()
+
+# Modules to import as nested modules of the module specified in RootModule/ModuleToProcess
+# NestedModules = @()
+
+# Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export.
+FunctionsToExport = @(
+    'Use-DevSetup'
+)
+
+# Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export.
+CmdletsToExport = @()
+
+# Variables to export from this module
+VariablesToExport = @()
+
+# Aliases to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no aliases to export.
+AliasesToExport = @('devsetup')
+
+# DSC resources to export from this module
+# DscResourcesToExport = @()
+
+# List of all modules packaged with this module
+# ModuleList = @()
+
+# List of all files packaged with this module
+# FileList = @()
+
+# Private data to pass to the module specified in RootModule/ModuleToProcess. This may also contain a PSData hashtable with additional module metadata used by PowerShell.
+PrivateData = @{
+
+    PSData = @{
+
+        # Tags applied to this module. These help with module discovery in online galleries.
+        Tags = @('BuildTools', 'Toolchain', 'Build', 'Automation', 'Package', 'Management', 'CMake', 'MSBuild', 'NMake', 'B2', 'Chocolatey', 'MySQL', 'Development')
+
+        # A URL to the license for this module.
+        # LicenseUri = ''
+
+        # A URL to the main website for this project.
+        ProjectUri = 'https://github.com/pwshdevs/devsetup'
+
+        # A URL to the main environments website for this project.
+        EnvironmentsProjectUri = 'https://github.com/pwshdevs/devsetup.environments'
+
+        # A URL to an icon representing this module.
+        # IconUri = ''
+
+        # ReleaseNotes of this module
+        ReleaseNotes = ''
+
+        # Prerelease string of this module
+        # Prerelease = ''
+
+        # Flag to indicate whether the module requires explicit user acceptance for install/update/save
+        # RequireLicenseAcceptance = $false
+
+        # External dependent modules of this module
+        # ExternalModuleDependencies = @()
+
+    } # End of PSData hashtable
+
+} # End of PrivateData hashtable
+
+# HelpInfo URI of this module
+# HelpInfoURI = ''
+
+# Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.
+# DefaultCommandPrefix = ''
+
+}

devsetup/DevSetup.psd1

@@ -0,0 +1,48 @@
+# DevSetup PowerShell Module
+
+# Get the current module path
+$ModulePath = $PSScriptRoot
+
+# Get all function files from both Private and Public directories, excluding test files
+$PrivateFunctions = Get-ChildItem -Path (Join-Path $ModulePath "Private") -Filter "*.ps1" -Recurse -ErrorAction SilentlyContinue | Where-Object { $_.Name -notlike "*Tests.ps1" }
+$PrivateUtilsFunctions = Get-ChildItem -Path (Join-Path $ModulePath "Private\Utils") -Filter "*.ps1" -Recurse -ErrorAction SilentlyContinue | Where-Object { $_.Name -notlike "*Tests.ps1" }
+$PrivateProvidersFunctions = Get-ChildItem -Path (Join-Path $ModulePath "Private\Providers") -Filter "*.ps1" -Recurse -ErrorAction SilentlyContinue | Where-Object { $_.Name -notlike "*Tests.ps1" }
+$PrivateCommandsFunctions = Get-ChildItem -Path (Join-Path $ModulePath "Private\Commands") -Filter "*.ps1" -Recurse -ErrorAction SilentlyContinue | Where-Object { $_.Name -notlike "*Tests.ps1" }
+$Private3rdpartyFunctions = Get-ChildItem -Path (Join-Path $ModulePath "Private\3rdparty") -Filter "*.ps1" -Recurse -ErrorAction SilentlyContinue | Where-Object { $_.Name -notlike "*Tests.ps1" }
+$PrivateEnumsFunctions = Get-ChildItem -Path (Join-Path $ModulePath "Private\Enums") -Filter "*.ps1" -Recurse -ErrorAction SilentlyContinue | Where-Object { $_.Name -notlike "*Tests.ps1" }
+$PublicFunctions = Get-ChildItem -Path (Join-Path $ModulePath "Public") -Filter "*.ps1" -Recurse -ErrorAction SilentlyContinue | Where-Object { $_.Name -notlike "*Tests.ps1" }
+
+# Combine all function files
+$AllFunctions = @()
+if ($PrivateFunctions) { $AllFunctions += $PrivateFunctions }
+if ($PrivateUtilsFunctions) { $AllFunctions += $PrivateUtilsFunctions }
+if ($PrivateProvidersFunctions) { $AllFunctions += $PrivateProvidersFunctions }
+if ($PrivateCommandsFunctions) { $AllFunctions += $PrivateCommandsFunctions }
+if ($Private3rdpartyFunctions) { $AllFunctions += $Private3rdpartyFunctions }
+if ($PrivateEnumsFunctions) { $AllFunctions += $PrivateEnumsFunctions }
+if ($PublicFunctions) { $AllFunctions += $PublicFunctions }
+
+# Import all functions
+foreach ($FunctionFile in $AllFunctions) {
+    try {
+        . $FunctionFile.FullName
+        Write-Verbose "Imported function from: $($FunctionFile.Name)"
+    }
+    catch {
+        Write-Error "Failed to import function from $($FunctionFile.Name): $_"
+    }
+}
+
+# Initialize global variables
+if (-not $global:InstalledPackages) {
+    $global:InstalledPackages = @()
+}
+
+if (-not $global:InstalledPackagesFile) {
+    $global:InstalledPackagesFile = $null
+}
+
+New-Alias -Name devsetup -Value Use-DevSetup
+
+# Export module members (functions will be exported via the manifest)
+Write-Verbose "DevSetup module loaded successfully. $($AllFunctions.Count) functions imported ($($PrivateFunctions.Count) private, $($PrivateUtilsFunctions.Count) utils, $($PrivateProvidersFunctions.Count) providers, $($PrivateCommandsFunctions.Count) commands, $($Private3rdpartyFunctions.Count) 3rdparty, $($PublicFunctions.Count) public)."

devsetup/DevSetup.psm1

@@ -0,0 +1,50 @@
+BeforeAll {
+    . $PSScriptRoot\ConvertFrom-3rdPartyInstall.ps1
+    . $PSScriptRoot\..\..\..\DevSetup\Private\3rdParty\VisualStudio\ConvertFrom-VisualStudioInstall.ps1
+    . $PSScriptRoot\..\..\..\DevSetup\Private\3rdParty\VisualStudioCode\ConvertFrom-VisualStudioCodeInstall.ps1
+    Mock Write-Host { }
+    Mock Write-Warning { }
+    Mock ConvertFrom-VisualStudioInstall { $true }
+    Mock ConvertFrom-VisualStudioCodeInstall { $true }
+}
+
+Describe "ConvertFrom-3rdPartyInstall" {
+
+    Context "When both conversions succeed" {
+        It "Should not write any warnings" {
+            $result = ConvertFrom-3rdPartyInstall -Config "test"
+            Assert-MockCalled Write-Warning -Exactly 0 -Scope It
+            Assert-MockCalled Write-Host -Exactly 2 -Scope It
+        }
+    }
+
+    Context "When Visual Studio conversion fails" {
+        It "Should write a warning for Visual Studio" {
+            Mock ConvertFrom-VisualStudioInstall { $false }
+            Mock ConvertFrom-VisualStudioCodeInstall { $true }
+            $result = ConvertFrom-3rdPartyInstall -Config "test"
+            Assert-MockCalled Write-Warning -Exactly 1 -Scope It -ParameterFilter { $Message -match "Visual Studio installations" }
+            Assert-MockCalled Write-Host -Exactly 2 -Scope It
+        }
+    }
+
+    Context "When Visual Studio Code conversion fails" {
+        It "Should write a warning for Visual Studio Code" {
+            Mock ConvertFrom-VisualStudioInstall { $true }
+            Mock ConvertFrom-VisualStudioCodeInstall { $false }
+            $result = ConvertFrom-3rdPartyInstall -Config "test"
+            Assert-MockCalled Write-Warning -Exactly 1 -Scope It -ParameterFilter { $Message -match "Visual Studio Code installation" }
+            Assert-MockCalled Write-Host -Exactly 2 -Scope It
+        }
+    }
+
+    Context "When both conversions fail" {
+        It "Should write warnings for both" {
+            Mock ConvertFrom-VisualStudioInstall { $false }
+            Mock ConvertFrom-VisualStudioCodeInstall { $false }
+            $result = ConvertFrom-3rdPartyInstall -Config "test"
+            Assert-MockCalled Write-Warning -Exactly 2 -Scope It
+            Assert-MockCalled Write-Host -Exactly 2 -Scope It
+        }
+    }
+}

devsetup/Private/3rdParty/ConvertFrom-3rdPartyInstall.Tests.ps1

@@ -0,0 +1,17 @@
+Function ConvertFrom-3rdPartyInstall {
+    Param(
+        [string]$Config
+    )
+
+    # Convert from Visual Studio installations
+    Write-Host "`nScanning Visual Studio installations..." -ForegroundColor Cyan
+    if (-not (ConvertFrom-VisualStudioInstall -Config $Config)) {
+        Write-Warning "Failed to convert Visual Studio installations, but continuing..."
+    }
+    
+    # Convert from Visual Studio Code installations
+    Write-Host "`nScanning Visual Studio Code installation..." -ForegroundColor Cyan
+    if (-not (ConvertFrom-VisualStudioCodeInstall -Config $Config)) {
+        Write-Warning "Failed to convert Visual Studio Code installation, but continuing..."
+    }
+}