PSFirebird

0.2.0

Types/FirebirdEnvironment.ps1

class FirebirdEnvironment {
    # Class properties
    [string] $Path
    [version]$Version

    # Default constructor
    FirebirdEnvironment() {
        $this.Init(@{})
    }

    # String constructor for implicit type conversion
    FirebirdEnvironment([string]$Path) {
        $this.Init(@{ Path = $Path })
    }

    # Convenience constructor from hashtable
    FirebirdEnvironment([hashtable]$Properties) { 
        $this.Init($Properties) 
    }

    # Shared initializer method
    [void] Init([hashtable]$Properties) {
        foreach ($Property in $Properties.Keys) {
            $this.$Property = $Properties.$Property
        }
    }

    # Return a string representation of the class
    [string] ToString() {
        return "Firebird $($this.Version) at $($this.Path)"
    }

    # Return isql location
    [System.Management.Automation.PathInfo] GetIsqlPath() { 
        $isqlPath = if ($global:IsWindows) { 
            Join-Path $this.Path 'isql.exe'
        } else {
            Join-Path $this.Path 'bin/isql'
        }

        return Resolve-Path $isqlPath
    }

    # Return gstat location
    [System.Management.Automation.PathInfo] GetGstatPath() { 
        $gstatPath = if ($global:IsWindows) { 
            Join-Path $this.Path 'gstat.exe'
        } else {
            Join-Path $this.Path 'bin/gstat'
        }

        return Resolve-Path $gstatPath
    }

    # Return gbak location
    [System.Management.Automation.PathInfo] GetGbakPath() { 
        $gbakPath = if ($global:IsWindows) { 
            Join-Path $this.Path 'gbak.exe'
        } else {
            Join-Path $this.Path 'bin/gbak'
        }

        return Resolve-Path $gbakPath
    }

    # Return the current context environment (set by Use-FirebirdEnvironment). Used as a default value for parameters.
    static [FirebirdEnvironment] default() {
        # Do not use Verbose messages here.
        $scope = 1
        while ($true) {
            try {
                $contextEnvironment = Get-Variable -Name 'FirebirdEnvironment' -Scope $scope -ValueOnly -ErrorAction SilentlyContinue
                if ($contextEnvironment) {
                    # Found a FirebirdEnvironment in the current scope
                    return $contextEnvironment
                }
                $scope++
            } catch [System.Management.Automation.PSArgumentOutOfRangeException] {
                # Get-Variable raises this exception when the scope exceeds the maximum.
                # This occurs during the argument processing phase of the cmdlet. -ErrorVariable does not catch it.
                Write-Verbose "No FirebirdEnvironment found up to scope $($scope). Error: $($_.Exception.Message)"
                break;
            }
        }

        # If no environment found, throw an error
        throw 'No Firebird environment available. Use -Environment parameter or Use-FirebirdEnvironment to set one.'
    }
}