kickstart.ps1

#!/usr/bin/env pwsh

<#
.SYNOPSIS
    A script for setting up new projects and development environments.
#>
param (
    # The command to run
    # Supported commands:
    #   latex:  Manage LaTeX projects
    [ValidateNotNullOrEmpty()]
    [ValidateSet('latex')]
    [string] $command,
    # Install all supported tools
    [switch] $install = $false,
    # Uninstall all supported tools
    [switch] $uninstall = $false,
    # Show the Kickstart help message
    [switch] $help = $false
)

#===============================================================================
# Error handling
#===============================================================================
$ErrorActionPreference = 'Stop'
Set-StrictMode -v Latest

#===============================================================================
# Global variables
#===============================================================================
# A hashtable for storing Kickstart global variables
[hashtable]$KS = @{
    ROOT_DIR = $PSScriptRoot
}

#===============================================================================
# Load modules
#===============================================================================
# Load all configuration files and the log module
(Join-Path $KS.ROOT_DIR 'config/*.ps1') | ForEach-Object {
    . $_
}
. (Join-Path $KS.ROOT_DIR 'src/log.ps1')

#===============================================================================
# Functions
#===============================================================================

function ProcessArguments {
    <#
    .SYNOPSIS
        Execute the appropriate command for the provided arguments
    .OUTPUTS
        The output of the executed command.

        If no arguments are provided to the script, an unsupported operation or
        command is provided, or conflicting operations are provided, an error is
        displayed.
    #>
    [CmdletBinding()]
    param (
        # A hashtable of the bound parameters
        [hashtable]$KSParameters,
        # An array of arguments passed to the script
        [System.Object[]]$KSArgs
    )

    # Check for conflicting operations
    if ($install -and $uninstall) {
        Write-Error 'Conflicting operations provided: -install and -uninstall' `
            -Category InvalidArgument `
            -ErrorId 255 `
            -RecommendedAction 'Use either -install or -uninstall, not both.'
    }

    $KSParameters.Remove('command') | Out-Null
    switch ($command) {
        'latex' {
            . (Join-Path $KS.ROOT_DIR 'LaTeX\mod.ps1') @KSParameters @KSArgs
            exit $LASTEXITCODE
        }
    }
    # The below is only reached if the 'command' parameter is not set

    if ($help) {
        Get-Help $PSCommandPath -Detailed
        exit 0
    }

    if ($install) {
        Info 'Installing all supported tools…'

        . (Join-Path $KS.ROOT_DIR 'latex\mod.ps1') @KSParameters @KSArgs
        exit $LASTEXITCODE
    }

    if ($uninstall) {
        Info 'Uninstalling all supported tools…'

        . (Join-Path $KS.ROOT_DIR 'latex\mod.ps1') @KSParameters @KSArgs
        exit $LASTEXITCODE
    }

    if ($KSArgs.Count -eq 0) {
        Write-Error 'No operation or commands provided.'  `
            -Category InvalidArgument `
            -ErrorId 254 `
            -RecommendedAction `
            'Use `-help` to see the available operations, commands and options.'
    } else {
        Write-Error "Unsupported operation(s) or command(s): ${KSArgs})"  `
            -Category InvalidArgument `
            -ErrorId 253 `
            -RecommendedAction `
            'Use `-help` to see the available options and commands.'
    }
}

function Main {
    <#
    .SYNOPSIS
        Execute the appropriate command for the provided arguments, taking into
        account the specified level of verbosity.
    .OUTPUTS
        The output of the executed commands if the verbose flag is set.
        Otherwise, the output of non-progress messages is suppressed.
    #>
    [CmdletBinding()]
    param (
        # A hashtable of the bound parameters
        [hashtable]$KSParameters,
        # An array of arguments passed to the script
        [System.Object[]]$KSArgs
    )
    # TODO: Implement verbose output
    # if ($KSArgs.Contains('-verbose') -or $KSArgs.Contains('-v')) {
    #     ProcessArguments $KSParameters $KSArgs | Write-Verbose -Verbose
    # } else {
    #     ProcessArguments $KSParameters $KSArgs | Write-Verbose
    # }
    ProcessArguments $KSParameters $KSArgs
}

#===============================================================================
# Entry point
#===============================================================================
Main $PSBoundParameters $args