PSCumulus

0.6.1

tests/Public/Get-CloudFunction.Tests.ps1

BeforeAll {
    Import-Module (Resolve-Path (Join-Path $PSScriptRoot '..\..\PSCumulus.psd1')).Path -Force
    . (Join-Path $PSScriptRoot 'TestHelpers.ps1')
}

Describe 'Get-CloudFunction' {

    Context 'parameter validation' {
        It 'makes Provider optional in every parameter set' {
            foreach ($parameterSet in 'Azure', 'AWS', 'GCP') {
                Should-HaveOptionalParameter `
                    -CommandName 'Get-CloudFunction' `
                    -ParameterSetName $parameterSet `
                    -ParameterName 'Provider'
            }
        }

        It 'requires -ResourceGroup in the Azure parameter set' {
            Should-HaveMandatoryParameter `
                -CommandName 'Get-CloudFunction' `
                -ParameterSetName 'Azure' `
                -ParameterName 'ResourceGroup'
        }

        It 'requires -Region in the AWS parameter set' {
            Should-HaveMandatoryParameter `
                -CommandName 'Get-CloudFunction' `
                -ParameterSetName 'AWS' `
                -ParameterName 'Region'
        }

        It 'requires -Project in the GCP parameter set' {
            Should-HaveMandatoryParameter `
                -CommandName 'Get-CloudFunction' `
                -ParameterSetName 'GCP' `
                -ParameterName 'Project'
        }

        It 'rejects an invalid provider name' {
            { Get-CloudFunction -Provider Oracle -ResourceGroup 'rg' } | Should -Throw
        }
    }

    Context 'Azure routing' {
        It 'calls Get-AzureFunctionData for Azure provider' {
            InModuleScope PSCumulus {
                Mock Get-AzureFunctionData {
                    [AzureFunctionRecord]@{ Name = 'prod-func-app'; Provider = 'Azure'; Region = 'eastus' }
                }

                Get-CloudFunction -Provider Azure -ResourceGroup 'prod-rg'

                Should -Invoke Get-AzureFunctionData -Times 1
            }
        }

        It 'passes ResourceGroup to the Azure backend' {
            InModuleScope PSCumulus {
                Mock Get-AzureFunctionData {
                    param([string]$ResourceGroup)
                    [AzureFunctionRecord]@{ Name = 'prod-func-app'; Provider = 'Azure'; Metadata = @{ RG = $ResourceGroup } }
                }

                $result = Get-CloudFunction -Provider Azure -ResourceGroup 'my-rg'
                $result.Metadata.RG | Should -Be 'my-rg'
            }
        }

        It 'returns CloudRecord objects' {
            InModuleScope PSCumulus {
                Mock Get-AzureFunctionData {
                    [AzureFunctionRecord]@{ Name = 'prod-func-app'; Provider = 'Azure'; Region = 'eastus'; Size = 'dotnet' }
                }

                $result = Get-CloudFunction -Provider Azure -ResourceGroup 'rg'
                $result.PSObject.TypeNames | Should -Contain 'PSCumulus.CloudRecord'
            }
        }
    }

    Context 'AWS routing' {
        It 'calls Get-AWSFunctionData for AWS provider' {
            InModuleScope PSCumulus {
                Mock Get-AWSFunctionData {
                    [AWSFunctionRecord]@{ Name = 'my-lambda'; Provider = 'AWS'; Region = 'us-east-1' }
                }

                Get-CloudFunction -Provider AWS -Region 'us-east-1'

                Should -Invoke Get-AWSFunctionData -Times 1
            }
        }

        It 'passes Region to the AWS backend' {
            InModuleScope PSCumulus {
                Mock Get-AWSFunctionData {
                    param([string]$Region)
                    [AWSFunctionRecord]@{ Name = 'my-lambda'; Provider = 'AWS'; Region = $Region }
                }

                $result = Get-CloudFunction -Provider AWS -Region 'eu-west-1'
                $result.Region | Should -Be 'eu-west-1'
            }
        }
    }

    Context 'GCP routing' {
        It 'calls Get-GCPFunctionData for GCP provider' {
            InModuleScope PSCumulus {
                Mock Get-GCPFunctionData {
                    [GCPFunctionRecord]@{ Name = 'hello-world'; Provider = 'GCP'; Region = 'us-central1' }
                }

                Get-CloudFunction -Provider GCP -Project 'my-project'

                Should -Invoke Get-GCPFunctionData -Times 1
            }
        }

        It 'passes Project to the GCP backend' {
            InModuleScope PSCumulus {
                Mock Get-GCPFunctionData {
                    param([string]$Project)
                    [GCPFunctionRecord]@{ Name = 'hello-world'; Provider = 'GCP'; Metadata = @{ Proj = $Project } }
                }

                $result = Get-CloudFunction -Provider GCP -Project 'prod-gcp'
                $result.Metadata.Proj | Should -Be 'prod-gcp'
            }
        }
    }

    Context '-All parameter' {
        BeforeEach {
            InModuleScope PSCumulus {
                $script:PSCumulusContext.Providers = @{ Azure = $null; AWS = $null; GCP = $null }
            }
        }

        It 'calls all backend functions when providers are connected' {
            InModuleScope PSCumulus {
                $script:PSCumulusContext.Providers['Azure'] = @{ Region = $null; Scope = 'prod-rg' }
                $script:PSCumulusContext.Providers['AWS']   = @{ Region = 'us-east-1'; Scope = $null }
                $script:PSCumulusContext.Providers['GCP']   = @{ Region = 'us-central1'; Scope = 'my-project' }

                Mock Get-AzureFunctionData { [AzureFunctionRecord]@{ Name = 'az-func'; Provider = 'Azure' } }
                Mock Get-AWSFunctionData   { [AWSFunctionRecord]@{ Name = 'aws-func'; Provider = 'AWS' } }
                Mock Get-GCPFunctionData   { [GCPFunctionRecord]@{ Name = 'gcp-func'; Provider = 'GCP' } }

                $null = Get-CloudFunction -All

                Should -Invoke Get-AzureFunctionData -Times 1
                Should -Invoke Get-AWSFunctionData   -Times 1
                Should -Invoke Get-GCPFunctionData   -Times 1
            }
        }

        It 'returns CloudRecord objects from all connected providers' {
            InModuleScope PSCumulus {
                $script:PSCumulusContext.Providers['Azure'] = @{ Region = $null; Scope = 'prod-rg' }
                $script:PSCumulusContext.Providers['AWS']   = @{ Region = 'us-east-1'; Scope = $null }
                $script:PSCumulusContext.Providers['GCP']   = @{ Region = 'us-central1'; Scope = 'my-project' }

                Mock Get-AzureFunctionData { [AzureFunctionRecord]@{ Name = 'az-func';  Provider = 'Azure' } }
                Mock Get-AWSFunctionData   { [AWSFunctionRecord]@{ Name = 'aws-func'; Provider = 'AWS' } }
                Mock Get-GCPFunctionData   { [GCPFunctionRecord]@{ Name = 'gcp-func'; Provider = 'GCP' } }

                $results = @(Get-CloudFunction -All)
                $results.Count | Should -Be 3
            }
        }
    }
}