Functions/GenXdev.Queries.Text/Get-NextAffirmation.ps1
|
############################################################################### <# .SYNOPSIS Returns a random affirmation text from affirmations.dev API. .DESCRIPTION Retrieves an affirmation from the affirmations.dev API and optionally speaks it using text-to-speech. .PARAMETER Speak When specified, uses text-to-speech to speak the affirmation out loud. .EXAMPLE Get-NextAffirmation .EXAMPLE WhatAboutIt -Speak #> function Get-NextAffirmation { [CmdletBinding()] [Alias('WhatAboutIt')] param( ####################################################################### [Parameter( Mandatory = $false, Position = 0, HelpMessage = 'Use text-to-speech to speak the affirmation' )] [Switch] $Speak ####################################################################### ) begin { # initialize api endpoint $apiEndpoint = 'https://www.affirmations.dev/' Microsoft.PowerShell.Utility\Write-Verbose "Using API endpoint: $apiEndpoint" } process { try { # fetch affirmation from the api with timeout Microsoft.PowerShell.Utility\Write-Verbose 'Fetching affirmation from API...' $response = Microsoft.PowerShell.Utility\Invoke-RestMethod -Uri $apiEndpoint ` -TimeoutSec 2 # extract affirmation text $affirmation = $response.affirmation # if speak parameter is true, use text-to-speech if ($Speak) { Microsoft.PowerShell.Utility\Write-Verbose 'Speaking affirmation using text-to-speech' GenXdev.Console\Start-TextToSpeech $affirmation } # output the affirmation text Microsoft.PowerShell.Utility\Write-Output $affirmation } catch { Microsoft.PowerShell.Utility\Write-Error "Failed to retrieve affirmation: $_" } } end { } } |