Release 1.284.2025

Author: genXdev

Functions/GenXdev.FileSystem/EnsurePester.ps1

@@ -2,7 +2,7 @@
 Part of PowerShell module : GenXdev.FileSystem
 Original cmdlet filename  : EnsurePester.ps1
 Original author           : René Vaessen / GenXdev
-Version                   : 1.280.2025
+Version                   : 1.284.2025
 ################################################################################
 MIT License
 

Functions/GenXdev.FileSystem/Expand-Path.ps1

@@ -2,7 +2,7 @@
 Part of PowerShell module : GenXdev.FileSystem
 Original cmdlet filename  : Expand-Path.ps1
 Original author           : René Vaessen / GenXdev
-Version                   : 1.280.2025
+Version                   : 1.284.2025
 ################################################################################
 MIT License
 

Functions/GenXdev.FileSystem/Find-DuplicateFiles.ps1

@@ -2,7 +2,7 @@
 Part of PowerShell module : GenXdev.FileSystem
 Original cmdlet filename  : Find-DuplicateFiles.ps1
 Original author           : René Vaessen / GenXdev
-Version                   : 1.280.2025
+Version                   : 1.284.2025
 ################################################################################
 MIT License
 

Functions/GenXdev.FileSystem/Find-Item.Cmdlet.cs

@@ -2,7 +2,7 @@
 // Part of PowerShell module : GenXdev.FileSystem
 // Original cmdlet filename  : Find-Item.Cmdlet.cs
 // Original author           : René Vaessen / GenXdev
-// Version                   : 1.280.2025
+// Version                   : 1.284.2025
 // ################################################################################
 // MIT License
 //
@@ -47,7 +47,7 @@ namespace GenXdev.FileSystem
     /// <para type="description">
     /// -Name &lt;String[]&gt;<br/>
     /// File name or pattern to search for. Default is '*'.<br/>
-    /// - <b>Aliases</b>: like, l, Path, Query, SearchMask<br/>
+    /// - <b>Aliases</b>: like, l, Path, LiteralPath, Query, SearchMask, Include<br/>
     /// - <b>Position</b>: 0<br/>
     /// - <b>Default</b>: "*"<br/>
     /// - <b>Features</b>:<br/>
@@ -71,7 +71,7 @@ namespace GenXdev.FileSystem
     /// </para>
 
     /// <para type="description">
-    /// -Content &lt;String&gt;<br/>
+    /// -Content &lt;String[]&gt;<br/>
     /// Regular expression pattern to search within file contents<br/>
     /// - <b>Aliases</b>: mc, matchcontent, regex, Pattern<br/>
     /// - <b>Position</b>: 1<br/>
@@ -274,6 +274,15 @@ namespace GenXdev.FileSystem
     /// Only the first instance of matching text is returned from each input file. This is the most efficient way to retrieve a list of files that have contents matching the regular expression.<br/>
     /// </para>
 
+    /// <para type="description">
+    /// -NoEmphasis &lt;SwitchParameter&gt;<br/>
+    /// Disables highlighting of matching strings in output. By default, matching patterns are highlighted using negative colors based on your PowerShell theme.<br/>
+    /// - <b>Features</b>:<br/>
+    ///   - Disables highlighting of pattern matches<br/>
+    ///   - Uses negative colors based on PowerShell background and text colors<br/>
+    ///   - Example: Black background with white text becomes white background with black text<br/>
+    /// </para>
+
     /// <para type="description">
     /// -NotMatch &lt;SwitchParameter&gt;<br/>
     /// The NotMatch parameter finds text that doesn't match the specified pattern.<br/>
@@ -581,7 +590,7 @@ public partial class FindItem : PSCmdlet
         /// <para type="description">File name or pattern to search for. Supports wildcards (*,?). Default is '*'</para>
         /// </summary>
         [Parameter(Position = 0, Mandatory = false, HelpMessage = "File name or pattern to search for. Default is '*'")]
-        [Alias("like", "l", "Path", "Query", "SearchMask")]
+        [Alias("like", "l", "Path", "LiteralPath", "Query", "SearchMask", "Include")]
         [ValidateNotNullOrEmpty()]
         [SupportsWildcards()]
         public string[] Name { get; set; }
@@ -601,7 +610,7 @@ public partial class FindItem : PSCmdlet
         [Alias("mc", "matchcontent", "regex", "Pattern")]
         [ValidateNotNull()]
         [SupportsWildcards()]
-        public string Content { get; set; } = ".*";
+        public string[] Content { get; set; } = new string[1] { ".*" };
 
         /// <summary>
         /// <para type="description">Base path for resolving relative paths in output</para>
@@ -864,6 +873,19 @@ public partial class FindItem : PSCmdlet
         [Parameter(Mandatory = false, ParameterSetName = "WithPattern", HelpMessage = "Only the first instance of matching text is returned from each input file. This is the most efficient way to retrieve a list of files that have contents matching the regular expression.")]
         public SwitchParameter List { get; set; }
 
+        /// <summary>
+        /// <para type="description">
+        /// By default, Select-String highlights the string that matches the pattern you
+        /// searched for with the Pattern parameter. The NoEmphasis parameter disables
+        /// the highlighting. The emphasis uses negative colors based on your PowerShell
+        /// background and text colors. For example, if your PowerShell colors are a
+        /// black background with white text, the emphasis is a white background with
+        /// black text.
+        /// </para>
+        /// </summary>
+        [Parameter(Mandatory = false, ParameterSetName = "WithPattern", HelpMessage = "Disables highlighting of matching strings in output.")]
+        public SwitchParameter NoEmphasis { get; set; }
+
         /// <summary>
         /// <para type="description">The NotMatch parameter finds text that doesn't match the specified pattern.</para>
         /// </summary>
@@ -895,6 +917,9 @@ protected override void BeginProcessing()
             // set up verbose logging based on user preference
             InitializeVerboseOutput();
 
+            // configure buffering for large file processing
+            InitializeBufferingConfiguration();
+
             // set up parallelism based on user input or defaults
             InitializeParallelismConfiguration();
 
@@ -916,9 +941,6 @@ protected override void BeginProcessing()
             // resolve base path for relative output
             InitializeRelativeBaseDir();
 
-            // configure buffering for large file processing
-            InitializeBufferingConfiguration();
-
             // set up cancellation with optional timeout
             InitializeCancellationToken();
 
@@ -966,8 +988,7 @@ protected override void EndProcessing()
 
             // clear all queues
             EmptyQueues();
-            MatchContentProcessor p;
-            while (MatchContentProcessors.TryDequeue(out p)) ;
+            MatchContentProcessor p; while (MatchContentProcessors.TryDequeue(out p)) ;
             GC.Collect();
 
             // create completion progress record

Functions/GenXdev.FileSystem/Find-Item.Fields.cs

@@ -2,7 +2,7 @@
 // Part of PowerShell module : GenXdev.FileSystem
 // Original cmdlet filename  : Find-Item.Fields.cs
 // Original author           : René Vaessen / GenXdev
-// Version                   : 1.280.2025
+// Version                   : 1.284.2025
 // ################################################################################
 // MIT License
 //
@@ -32,6 +32,7 @@
 using System.Collections.Concurrent;
 using System.Management.Automation;
 using System.Runtime.InteropServices;
+using System.Text;
 using System.Text.RegularExpressions;
 
 namespace GenXdev.FileSystem
@@ -181,9 +182,11 @@ public partial class FindItem : PSCmdlet
         protected readonly ConcurrentQueue<string> VerboseQueue = new();
         protected readonly ConcurrentQueue<FileInfo> FileContentMatchQueue = new();
         private readonly ConcurrentQueue<MatchContentProcessor> MatchContentProcessors = new();
-       
+
         protected readonly List<Task> Workers = new List<Task>();
         protected readonly object WorkersLock = new object();
+        protected readonly StringBuilder statusBuilder = new StringBuilder(256);
+
 
         // Cancellation source to handle timeouts and user interruptions gracefully
         protected CancellationTokenSource cts;
@@ -203,6 +206,18 @@ public partial class FindItem : PSCmdlet
         protected long matchesQueued;
         protected long dirsCompleted;
 
+        // Throughput measurement fields for adaptive scaling (thread-safe)
+        protected long lastThroughputMeasurement = DateTime.UtcNow.Ticks;
+        protected long lastDirsCompleted = 0;
+        protected long lastMatchesCompleted = 0;
+        protected long lastOutputCount = 0;
+        protected long currentDirThroughputx100 = 0;    // directories/second * 100 (for precision)
+        protected long currentMatchThroughputx100 = 0;  // matches/second * 100 (for precision)
+        protected long currentOutputThroughputx100 = 0; // outputs/second * 100 (for precision)
+        protected long recommendedDirectoryWorkers = 0;
+        protected long recommendedMatchWorkers = 0;
+        protected readonly object throughputLock = new object(); // Lock for measurement updates
+
         // Store original thread pool settings to restore after cmdlet execution
         protected int oldMaxWorkerThread;
         protected int oldMaxCompletionPorts;
@@ -216,8 +231,8 @@ public partial class FindItem : PSCmdlet
 
         protected int oldMaxWorkerThreads;
         protected bool isStarted;
-        protected bool usingSelectString;
-        
+        protected bool matchingFileContent;
+
         /// <summary>
         /// Flag for enabling verbose output based on user preferences
         /// </summary>