OsLibCore 3.3.0

OsLib

Handling of files and system calls.

formerly OsLibCore

3.3.0

• Introduces Os.Config and osconfig.json as the reusable typed configuration model for OsLib.
• Moves cloud roots, backup policy, and configurable directories into a shared config contract while keeping provider probing and caching.

namespace

OsLib

classes

<details> <summary>RaiSystem: Run external processes with optional output capture.</summary>

• RaiSystem: Exec, Start </details>

<details> <summary>RaiNetDrive: Windows network drive mount helper.</summary>

• RaiNetDrive: Mount, Unmount </details>

<details> <summary>EscapeMode: Defines escape modes for path and parameter handling.</summary>

• EscapeMode </details>

<details> <summary>OsType: Identifies the OS type (UNIX or Windows).</summary>

• OsType </details>

<details> <summary>Os: Platform helpers for paths, escaping, provider-based cloud storage discovery, and local backup placement.</summary>

• Os: CloudStorageRoot, GetCloudStorageRoots, GetCloudStorageRoot, GetPreferredCloudStorageRoot, ResetCloudStorageCache, GetCloudDiscoveryReport, HomeDir, TempDir, LocalBackupDir, Escape, NormSeperator </details>

<details> <summary>RaiFile: File and directory utility with path parsing and cloud-aware behaviors.</summary>

• RaiFile: Exists, rm, mv, cp, mkdir, rmdir, Zip, backup </details>

<details> <summary>RaiFileExtensions: Convenience extensions for string and CSV handling.</summary>

• RaiFileExtensions: MakePolicyCompliant, Singularize, CreateDictionariesFromCsvLines </details>

<details> <summary>RaiPath: Represents a directory path and enforces a trailing directory separator.</summary>

• RaiPath: Path, / operator, mkdir </details>

<details> <summary>CanonicalPath: RaiPath convention where folder name equals file stem.</summary>

• CanonicalPath: RootPath, FileStem, Apply </details>

<details> <summary>PathConventionType and IPathConventionFile: Shared path-convention contract for convention-aware files.</summary>

• PathConventionType: CanonicalByName, ItemIdTree3x3, ItemIdTree8x2
• IPathConventionFile: ConventionName, ApplyPathConvention </details>

<details> <summary>TextFile: Text file with cached line operations and save support.</summary>

• TextFile: Read, Save, Append, Delete </details>

<details> <summary>CsvFile: Tab-delimited CSV reader with object conversion.</summary>

• CsvFile: Read, Objects, ToJsonFile </details>

<details> <summary>TmpFile: Temporary file wrapper.</summary>

• TmpFile: create (creates missing parent directories via TextFile.Save/RaiFile.mkdir) </details>

<details> <summary>CanonicalFile: Enforces canonical file-in-folder convention.</summary>

• CanonicalFile </details>

<details> <summary>ShellHelper: Helpers for running shell commands.</summary>

• ShellHelper: Bash </details>

<details> <summary>CliCommand and tool wrappers: executable discovery, install hints, and process execution.</summary>

• CliCommand: IsAvailable, TryResolveExecutable, Run, RunAsync, GetInstallCommand, GetUpdateCommand
• Built-in wrappers: CurlCommand, ZipCommand, SevenZipCommand, RCloneCommand </details>

nuget

https://www.nuget.org/packages/OsLibCore/

diagram

• Source: RaiFile-Hierarchy.puml
• CLI render (if PlantUML is installed): plantuml RaiFile-Hierarchy.puml
• VS Code: open the .puml file and use a PlantUML preview/render extension.

detailed api

• Foldable class and method-level documentation: API.md
• Cloud root discovery setup, provider precedence, and cloud-aware IO behavior: CLOUD_STORAGE_DISCOVERY.md
• CLI command hierarchy and external tool wrappers: ../CliCommand-Hierarchy.puml
• Local backup placement: Os.LocalBackupDir resolves an OS-local, non-cloud directory and can be configured in osconfig.json.
• Ubuntu/Mzansi guidance: prefer explicit cloud.* entries in osconfig.json over probe-only discovery for stable Google Drive roots across machines.

unit tests

• Local unit tests are in OsLib.Tests.
• Run from repository root: dotnet test
• Additional integration/usage tests still exist across JsonPitSolution.

release notes

• Current release notes: RELEASE_NOTES_3.3.0.md

nuget publish automation

• GitHub Actions workflow: .github/workflows/publish-nuget.yml
• Trigger: push a version tag in format v* (example: v3.3.0)
• Safety check: workflow validates tag version equals <Version> in OsLib.csproj
• Required GitHub repository secret: NUGET_API_KEY
• Typical release command:
  • git tag -a v3.3.0 -m "v3.3.0" && git push origin v3.3.0