Redis or Garnet as cache storage using FarNet.Redis module

[nightroman]

The custom storage technique is explained in docs Caching / Custom Storage.
This section also provides the complete example of using Redis with redis-cli.

Here is the similar Redis cache storage using the PowerShell module FarNet.Redis
(note that it requires PowerShell Core 7.4+)

# Sets Redis or Garnet as the default cache storage using FarNet.Redis module.
# This demo uses $env:FARNET_REDIS_CONFIGURATION as Redis configuration string.
function Set-RedisCacheStorage {
    # make the module available
    Export-PodeModule FarNet.Redis

    # define required scripts
    $params = @{
        Set = {
            param($key, $value, $ttl)
            Set-RedisString $key $value -TimeToLive ([timespan]::FromSeconds($ttl))
        }
        Get = {
            param($key, $metadata)
            $result = Get-RedisString $key
            if ($null -eq $result) {
                return
            }
            if ($metadata) {
                [int]$ttl = (Get-RedisKey $key -TimeToLive)?.TotalSeconds
                $result = @{
                    Value = $result
                    Ttl = $ttl
                    Expiry = [datetime]::UtcNow.AddSeconds($ttl)
                }
            }
            $result
        }
        Test = {
            param($key)
            [bool](Test-RedisKey $key)
        }
        Remove = {
            param($key)
            Remove-RedisKey $key
        }
        Clear = {}
    }

    # set the default cache storage
    Add-PodeCacheStorage -Name Redis -Default @params
}

How to use / test

Start-PodeServer {
    ...

    Set-RedisCacheStorage

    Add-PodeRoute -Method Get -Path /cache-demo -ScriptBlock {
        $r = Get-PodeCache -Key temp:pode:q1
        if ($r) {
            Write-PodeTextResponse "found $r"
        }
        else {
            $r = (Get-Date).ToString()
            $r | Set-PodeCache -Key temp:pode:q1 -Ttl 12
            Write-PodeTextResponse "created $r"
        }
    }

    Add-PodeRoute -Method Get -Path /cache-test -ScriptBlock {
        $r1 = Test-PodeCache -Key temp:pode:q1
        Remove-PodeCache -Key temp:pode:q1
        $r2 = Test-PodeCache -Key temp:pode:q1
        Write-PodeTextResponse "tested $r1 $r2"
    }
}