Release 1.208.2025

Author: genXdev

Functions/GenXdev.AI.DeepStack/README.md

@@ -6,6 +6,31 @@
 
 This module provides PowerShell functions to interact with DeepStack's face recognition API running in a Docker container. DeepStack offers powerful, privacy-focused AI capabilities including face detection, face recognition, object detection, and image enhancement.
 
+## MIT License
+
+```text
+MIT License
+
+Copyright (c) [year] [fullname]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+````
 
 ## Prerequisites
 

Functions/GenXdev.AI.Queries/Add-ImageDirectories.ps1

@@ -53,15 +53,16 @@ function Add-ImageDirectories {
     [Alias('addimgdir')]
 
     param(
-        #
+        ###############################################################################
         [Parameter(
             Mandatory = $true,
             Position = 0,
             ValueFromPipeline = $true,
             HelpMessage = 'Array of directory paths to add to image directories'
         )]
         [Alias('imagespath', 'directories', 'imgdirs', 'imagedirectory')]
-        [string[]] $ImageDirectories,        ################################################################################
+        [string[]] $ImageDirectories,
+        ################################################################################
         [Parameter(
             Mandatory = $false,
             HelpMessage = ('Use alternative settings stored in session for AI ' +
@@ -94,60 +95,56 @@ function Add-ImageDirectories {
     )
 
     begin {
+        try {
+            # retrieve current image directories configuration
+            $params = GenXdev.Helpers\Copy-IdenticalParamValues `
+                -BoundParameters $PSBoundParameters `
+                -FunctionName 'GenXdev.AI\Get-AIImageCollection' `
+                -DefaultValues (Microsoft.PowerShell.Utility\Get-Variable `
+                    -Scope Local `
+                    -ErrorAction SilentlyContinue)
 
-        # retrieve current image directories configuration
-        $params = GenXdev.Helpers\Copy-IdenticalParamValues `
-            -BoundParameters $PSBoundParameters `
-            -FunctionName 'GenXdev.AI\Get-AIImageCollection' `
-            -DefaultValues (Microsoft.PowerShell.Utility\Get-Variable `
-                -Scope Local `
-                -ErrorAction SilentlyContinue)
-
-        $currentConfig = Get-AIImageCollection @params
+            $currentConfig = Get-AIImageCollection @params
 
-        # initialize new collection to store all directories including existing ones
-        $newDirectories = [System.Collections.Generic.List[string]]::new()
+            # initialize new collection to store all directories including existing ones
+            $newDirectories = [System.Collections.Generic.List[string]]::new()
 
-        # populate collection with existing directories to preserve them
-        foreach ($dir in $currentConfig) {
+            # populate collection with existing directories to preserve them
+            foreach ($dir in $currentConfig) {
+                $newDirectories.Add($dir)
+            }
 
-            $newDirectories.Add($dir)
+            # output current configuration state for debugging purposes
+            Microsoft.PowerShell.Utility\Write-Verbose (
+                'Current image directories: ' +
+                "[$($currentConfig -join ', ')]"
+            )
+        } catch {
+            Write-Error "Failed to retrieve current image directories: $_"
+            return
         }
-
-        # output current configuration state for debugging purposes
-        Microsoft.PowerShell.Utility\Write-Verbose (
-            'Current image directories: ' +
-            "[$($currentConfig -join ', ')]"
-        )
     }
 
     process {
-
-        # iterate through each provided directory path for processing
         foreach ($directory in $ImageDirectories) {
-
-            # expand path to resolve relative paths and environment variables
-            $expandedPath = GenXdev.FileSystem\Expand-Path $directory
-
+            try {
+                # expand path to resolve relative paths and environment variables
+                $expandedPath = GenXdev.FileSystem\Expand-Path $directory
+            } catch {
+                Write-Error "Failed to expand path '$directory': $_"
+                continue
+            }
             # search for existing directory using case-insensitive comparison
             $existingDir = $newDirectories |
                 Microsoft.PowerShell.Core\Where-Object {
                     $_.ToLower() -eq $expandedPath.ToLower()
                 }
-
-            # add directory only if it doesn't already exist in collection
             if (-not $existingDir) {
-
                 $newDirectories.Add($expandedPath)
-
-                # output verbose message about successful addition
                 Microsoft.PowerShell.Utility\Write-Verbose (
                     "Adding directory: $expandedPath"
                 )
-            }
-            else {
-
-                # output verbose message about duplicate directory skip
+            } else {
                 Microsoft.PowerShell.Utility\Write-Verbose (
                     "Directory already exists: $expandedPath"
                 )