Stdlib

20 pages.

The standard library — and where each call runs

The pure standard library, and the one fact about it that changes how your app feels: 271 of its 396 methods run in the BROWSER, with no round trip…

App.BaseUrl — the address your app is known by, for links in mail and background work

`App.BaseUrl` is the scheme and host your app answers at, with no trailing slash — what you put in front of a path to make a link that works outside…

App.Version — which version of your app is running, on which platform release

`App.Version` is the version of your app that is answering ("1.0.8") and `App.PlatformVersion` the platform release serving it ("0.17.3"). Both are…

Culture formatting — ToString(format, culture)

Format numbers, currency, percentages and dates for a declared culture — `total.ToString("C", "sv-SE")` → `1 234,56 kr`. A per-call culture…

Encoding — Base64, hex, text encodings, URL, HTML

Encode and decode text — Base64, URL percent-encoding, and HTML escaping — with the C#-faithful spellings. `Convert.ToBase64String` /…

Environment — the app's own variables

C#'s `System.Environment`, answering with the APP's values and never the host's: `GetEnvironmentVariable(name)` reads the app's own `app.Config`…

Guid.* — the empty id, a fresh id, and reading one out of a string

A `Guid` is the type an entity's `Id` has, and the type a reference to a row has. `Guid.NewGuid()` mints a fresh one, `Guid.Empty` is the all-zero…

Host — the computer a local app runs on

`use Osysharp.Host` gives an app the computer it runs on: run a program (`Host.Process`), read and write files in folders (`Host.File`…

Host.File and Host.Directory — files and folders on the computer

Read, write and list real files on the computer a local app runs on, with C#'s `System.IO` names under `Host`: `Host.File.ReadAllText(path)`…

Host.Process — run a program on the computer

Run a program on the computer a local app runs on. `Host.Process.Run("git", ["--version"])` waits for it and answers a `ProcessResult` (`ExitCode`…

Mail on the wire — Mime.Parse, Mime.Build, Imap.Fetch, Smtp.Send

The four calls a mail kit is built from. `Mime.Parse` reads a whole RFC 5322 message — headers, text and HTML bodies, attachments, and a bounce's…

Path — the text of a file path

C#'s `System.IO.Path`: build and take apart file paths as text — `Path.Combine`, `GetFileName`, `GetFileNameWithoutExtension`, `GetExtension`…

Random.* — an ordinary random number

A random integer for ordinary work — picking a row, jittering a retry, shuffling. `Random.Next(10)` answers 0..9. It WORKS INSIDE A LINQ QUERY and…

Records — what any record is called, where it opens, who may read it

`Records.*` answers facts about a row of ANY type from what the app declared — what it is called (`[Title]`), where it opens (the page that `[Opens]`…

Regex

Match, replace, split and CAPTURE with regular expressions — the C#-faithful System.Text.RegularExpressions spelling. `Regex.IsMatch(s, "\\d+")`…

Security.* — hashing, verifying, tickets, random ids

The calls an authentication flow needs: `HashPassword` (salted, one-way), `VerifyPassword` (constant-work comparison against a stored hash, and a…

Time zones — TimeZoneInfo

Store and use civil time zones with C#'s `TimeZoneInfo`. A zone holds an IANA id (`"Europe/Stockholm"`), and C#'s members — `ConvertTimeFromUtc`…

Uri

Parse a URL into its parts with the C#-faithful `new Uri(url)` handle. Construct it from a URL string, then read `.Scheme`, `.Host`, `.Port`…

Uri and WebUtility escaping

Percent-encodes a string for a URL, and escapes a string for safe insertion into HTML. Escaping is exact and identical in the browser and on the…

Zip.List — what an archive holds

`Zip.List(bytes)` answers the names a ZIP archive holds, in archive order — read from its central directory only, so nothing is decompressed and an…