public/Set-CdExtrasOption.ps1

<#
.SYNOPSIS
Update cd-extras option ('AUTO_CD', 'CD_PATH', ...etc).
 
.PARAMETER Option
The option to update.
 
.PARAMETER Value
The new value.
 
.EXAMPLE
PS C:\> Set-CdExtrasOption AUTO_CD
Enables flag AUTO_CD
 
.EXAMPLE
PS C:\> Set-CdExtrasOption AUTO_CD $false
Disables flag AUTO_CD
 
.EXAMPLE
PS C:\> Set-CdExtrasOption -Option CD_PATH -Value @('/temp')
Set the search paths to the single directory '/temp'
#>

function Set-CdExtrasOption {

  [OutputType([void])]
  [CmdletBinding()]
  param (
    [Parameter(Mandatory)]
    [ValidateSet(
      'AUTO_CD',
      'CD_PATH',
      'NOARG_CD',
      'CDABLE_VARS',
      'MenuCompletion',
      'DirCompletions',
      'FileCompletions',
      'PathCompletions',
      'ColorCompletion',
      'MaxCompletions')]
    $Option,
    $Value
  )

  $flags = @(
    'AUTO_CD',
    'CDABLE_VARS'
    'ColorCompletion'
    'MenuCompletion'
  )

  if ($null -eq $Value -and $Option -in $flags) {
    $Value = $true
  }

  $Global:cde.$option = $value

  $isUnderTest = { $Global:__cdeUnderTest -and !($Global:__cdeUnderTest = $false) }

  RegisterCompletions @('Step-Up') 'n' { CompleteAncestors @args }
  RegisterCompletions @('Undo-Location', 'Redo-Location') 'n' { CompleteStack @args }

  if ($cde.DirCompletions) {
    RegisterCompletions $cde.DirCompletions 'Path' { CompletePaths -dirsOnly @args }
  }
  if ($cde.FileCompletions) {
    RegisterCompletions $cde.FileCompletions 'Path' { CompletePaths -filesOnly @args }
  }
  if ($cde.PathCompletions) {
    RegisterCompletions $cde.PathCompletions 'Path' { CompletePaths @args }
  }

  if ($cde.AUTO_CD) {
    CommandNotFound @(AutoCd) $isUnderTest
  }
  else {
    CommandNotFound @() $isUnderTest
  }
}