OsLib

Handling of files and system calls.

formerly OsLibCore

3.0.0

• Adds ImageFile and ImageTreeFile as first-class OsLib types for image-oriented naming and tree-based storage paths.
• Uses ItemId terminology for image identity in the new image file model.
• This major version marks an architectural expansion: OsLib now includes structured media path semantics, not only generic OS/file helpers.

namespace

OsLib

classes

RaiSystem: Run external processes with optional output capture.

• RaiSystem: Exec, Start

RaiNetDrive: Windows network drive mount helper.

• RaiNetDrive: Mount, Unmount

EscapeMode: Defines escape modes for path and parameter handling.

• EscapeMode

OsType: Identifies the OS type (UNIX or Windows).

• OsType

Os: Platform helpers for paths, escaping, and cloud storage root discovery.

• Os: CloudStorageRoot, HomeDir, TempDir, Escape, NormSeperator

RaiFile: File and directory utility with path parsing and cloud-aware behaviors.

• RaiFile: Exists, rm, mv, cp, mkdir, rmdir, Zip, backup

RaiFileExtensions: Convenience extensions for string and CSV handling.

• RaiFileExtensions: MakePolicyCompliant, Singularize, CreateDictionariesFromCsvLines

RaiPath: Represents a directory path and enforces a trailing directory separator.

• RaiPath: Path, / operator, mkdir

CanonicalPath: RaiPath convention where folder name equals file stem.

• CanonicalPath: RootPath, FileStem, Apply

ItemTreePath: RaiPath convention with partition folders from ItemId prefixes.

• ItemTreePath: RootPath, ItemId, Topdir, Subdir, Apply

PathConventionType and IPathConventionFile: Shared path-convention contract for convention-aware files.

• PathConventionType: CanonicalByName, ItemIdTree
• IPathConventionFile: ConventionName, ApplyPathConvention

TextFile: Text file with cached line operations and save support.

• TextFile: Read, Save, Append, Delete

CsvFile: Tab-delimited CSV reader with object conversion.

• CsvFile: Read, Objects, ToJsonFile

TmpFile: Temporary file wrapper.

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

CanonicalFile: Enforces canonical file-in-folder convention.

• CanonicalFile

ColorInfo: Lightweight image color descriptor.

• ColorInfo: Code, Name, Count

ImageFile: Image-oriented filename parser and composer.

• ImageFile: ItemId, NameExt, ImageNumber, TileTemplate, TileNumber, ExtendToFirstExistingFile

ImageTreeFile: ImageFile with tree-based storage path conventions.

• ImageTreeFile: Topdir, Subdir, tree-aware Path

ShellHelper: Helpers for running shell commands.

• ShellHelper: Bash

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

unit tests

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

nuget publish automation

• GitHub Actions workflow: .github/workflows/publish-nuget.yml
• Trigger: push a version tag in format v* (example: v3.0.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.0.0 -m "v3.0.0" && git push origin v3.0.0