Initial release including Get-OZODirectorySummary; v1.0.0

* save commit

* Initial release including Get-OZODirectorySummary; v1.0.0

---------

Co-authored-by: Andy Lievertz <alievertz@onezeroone.dev>

Author: alievertz

CHANGELOG.md

@@ -0,0 +1,5 @@
+# OZOFiles PowerShell Module Change Log
+
+|Date|Version|Comment|
+|----|-------|-------|
+|2025-May-19|1.0.0|Initial release including `Get-OZODirectorySummary`.|

Documentation/Get-OZOChildWriteTime.md

@@ -0,0 +1,34 @@
+# Get-OZOChildWriteTime
+This function is part of the [OZOFiles PowerShell Module](../README.md).
+
+## Description
+Returns the newest or oldest write time for all files within a given path. Returns the newest write time when executed with no parameters.
+
+## Syntax
+```
+Get-OZOChildWriteTime
+    -Oldest
+    -Path   <String>
+```
+## Parameters
+|Parameter|Description|
+|---------|-----------|
+|`Oldest`|Return the oldest date time.|
+|`Path`|The path to inspect. Defaults to the current directory. If Path is invalid or inaccessible, the script returns a datetime object representing 1970-01-01 00:00:00.|
+
+## Examples
+
+### Example 1
+```powershell
+Get-OZOChildWriteTime -Path (Join-Path -Path $Env:USERPROFILE -ChildPath "Git")
+Saturday, February 15, 2025 17:44:45
+```
+
+### Example 2
+```powershell
+Get-OZOChildWriteTime -Path (Join-Path -Path $Env:USERPROFILE -ChildPath "Git") -Oldest
+Friday, February 9, 2024 18:03:56
+```
+
+## Outputs
+`System.DateTime`

Documentation/Get-OZODirectorySummary.md

@@ -0,0 +1,35 @@
+# Get-OZODirectorySummary
+This function is part of the [OZOFiles PowerShell Module](../README.md).
+
+## Description
+Returns an OZODirectorySummary object.
+
+## Syntax
+```
+Get-OZODirectorySummary
+    -Path <String>
+```
+## Parameters
+|Parameter|Description|
+|---------|-----------|
+|`Path`|The path to inspect.|
+
+## Examples
+```powershell
+Get-OZODirectorySummary -Path (Join-Path -Path $Env:USERPROFILE -ChildPath "Downloads")
+
+Validates            : True
+newestChildWriteTime : 5/19/2025 13:43:51
+longLength           : 256
+totalSizeBytes       : 4280832613
+Path                 : C:\Users\aliev\Downloads
+longPaths            : {}
+problemPaths         : {}
+objectSIDs           : {S-1-5-18, S-1-5-32-544, S-1-5-21-1004336348-1177238915-682003330-1191}
+```
+
+## Outputs
+`PSCustomOBject`
+
+## Notes
+For more information, please see the [`OZODirectorySummary` class definition](OZODirectorySummary.md)

Documentation/Get-OZOFileToBase64.md

@@ -0,0 +1,25 @@
+# Get-OZOFileToBase64
+This function is part of the [OZOFiles PowerShell Module](../README.md).
+
+## Description
+Returns a Base-64 string representing a valid file, or "File not found" if the file does not exist or cannot be read.
+
+## Syntax
+```
+Get-OZOFileToBase64
+    -Path <String>
+```
+
+## Parameters
+|Parameter|Description|
+|---------|-----------|
+|`Path`|The path to the file to convert to a base-64 string.|
+
+## Examples
+```powershell
+Get-OZOFileToBase64 -Path ".\README.md"
+IyBPWk8gUG93ZXJTaGVsbCBNb2R1bGUgSW5zdGFsbGF... <snip>
+```
+
+## Outputs
+`System.String`

Documentation/OZODirectorySummary.md

@@ -0,0 +1,18 @@
+# OZODirectorySummary Class
+This class is part of the [OZOFiles PowerShell Module](../README.md). Calling the `Get-OZODirectorySummary` function returns an object of the `OZODirectorySummary` class.
+
+```
++ $Validates:Boolean             = $true
++ $newestChildWriteTime:DateTime = (Get-Date -Year 1970 -Month 01 -Day 01 -Hour 00 -Minute 00 -Second 00)
++ $longLength:Int32              = 0
++ $totalSizeBytes:Int64          = 0
++ $Path:String                   = $null
++ $objectSIDs:System.Collections.Generic.List[String]                     = @()
++ $longPaths:System.Collections.Generic.List[System.IO.FileSystemInfo]    = @()
++ $problemPaths:System.Collections.Generic.List[System.IO.FileSystemInfo] = @()
+```
+---
+```
++ OZODirectorySummary($LongLength,$Path):void
+- ValidateEnvironment():Boolean
+- GetDirectorySummary():Boolean

Documentation/Set-OZOBase64ToFile.md

@@ -0,0 +1,24 @@
+# Set-OZOBase64ToFile
+This function is part of the [OZOFiles PowerShell Module](../README.md).
+
+## Description
+Writes a base-64 string to disk as a file. Returns TRUE on success and FALSE on failure.
+
+## Syntax
+```
+Set-OZOBase64ToFile
+    -Base64 <String>
+    -Path   <String>
+```
+
+## Parameters
+|Parameter|Description|
+|---------|-----------|
+|`Base64`|The base-64 string to convert.|
+|`Path`|The output file path. If the file exists, it will be overwritten.|
+
+## Examples
+```powershell
+Set-OZOBase64ToFile -Base64 "IyBPWk8gUG93ZXJTaGVsbCBNb2R1bGUgSW5zdGFsbGF..." -Path ".\README.md"
+True
+```

Documentation/Test-OZOPath.md

@@ -0,0 +1,26 @@
+# Test-OZOPath
+This function is part of the [OZOFiles PowerShell Module](../README.md).
+
+## Description
+Determines if a path exists and is readable. Optionally tests if the path is writable.
+
+## Syntax
+```
+Test-OZOPath
+    -Path <String>
+```
+
+## Parameters
+|Parameter|Description|
+|---------|-----------|
+|`Path`|The path to test. Returns TRUE if the path exists and is readable and otherwise returns FALSE.|
+|`Writable`|Determines if the path is writable. Returns TRUE if the path is writable and otherwise returns FALSE.|
+
+## Examples
+```powershell
+Test-OZOPath -Path ".\README.md"
+True
+```
+
+## Outputs
+`System.Boolean`