RaiUtilsCore 3.4.0

RaiUtils

Random, Email, ParameterDictionary, JSON conversion helpers, and lightweight search expressions.

formerly RaiUtilsCore

3.3.0

• Targets net10.0 and packages as RaiUtilsCore.
• Documents the shared osconfig.json convention used with OsLib and JsonPit.
• Provides utility helpers for:
  • Email syntax validation (Email)
  • JSON token conversion to plain dictionaries/arrays (JsonConversionExtensions)
  • Lowercase key filtering for incoming name-value parameters (ParameterDictionary)
  • Randomization extensions for enumerable/list sources (RandomExtensions)
  • Wildcard-and expression matching against object properties (SearchExpression)

namespace

RaiUtils

classes

<details> <summary>Email: Validates an email address string using regex.</summary>

• Email: Valid, Invalid, ToString </details>

<details> <summary>JsonConversionExtensions: Converts JObject and JArray to plain .NET dictionary/array trees.</summary>

• JsonConversionExtensions: ToDictionary, ToArray </details>

<details> <summary>ParameterDictionary: StringDictionary filtered to lowercase keys from NameValueCollection.</summary>

• ParameterDictionary: constructor with lowercase-key import behavior </details>

<details> <summary>RandomExtensions: Random element selection and shuffle helpers for IEnumerable and IList.</summary>

• RandomExtensions: Random, Shuffle, TakeAny </details>

<details> <summary>SearchExpression: Parses text search patterns and evaluates matches against object properties.</summary>

• SearchExpression: ConditionsAsString, IsMatch(object) </details>

dependencies

• NuGet package dependency: Newtonsoft.Json.
• No direct code dependency on OsLib types is present in current RaiUtils source.

cross-package cloud root convention

RaiUtils does not resolve cloud roots itself, but it is intended to stay compatible with the same machine-local configuration contract used by OsLib and JsonPit.

Recommended shared contract across .NET and upcoming Python packages:

• Use osconfig.json for explicit cloud roots.
• Rely on ~/.config/RAIkeep/osconfig.json on macOS/Linux or %APPDATA%\RAIkeep\osconfig.json on Windows.
• Reuse the same cloud keys: dropbox, onedrive, googledrive, icloud.
• Prefer explicit Ubuntu Google Drive configuration over probe-only assumptions when packages are used together in development or deployment tooling.

nuget

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

diagram

• Source: RaiUtils-ClassDiagram.puml
• Rendered SVG: RaiUtils-ClassDiagram.svg
• CLI render (if PlantUML is installed): plantuml RaiUtils-ClassDiagram.puml
• VS Code: open the .puml file and use a PlantUML preview/render extension.

detailed api

• Foldable class and method-level documentation: API.md

release notes

• Current release notes: RELEASE_NOTES_3.3.0.md

unit tests

• Local unit tests are in tests/RaiUtils.Tests.
• Run from RaiUtils root: dotnet test RaiUtils.slnx

solution format

• Upgraded solution format is available as RaiUtils.slnx (generated with dotnet solution migrate).