Softanza
DémarrerEnglish
Softanza
DémarrerEnglish
Référence · Systèmes et exécution

Programmation système

76 fonctions dans 35 classes, groupées par ce qu'elles font, chacune avec l'explication que la bibliothèque donne d'elle-même.

Le récit de ce domaine, pour un lecteur général : ce qu'un artisan en fait, un exemple exécuté et ses couloirs notés, est sur sa page de la Plateforme.

Les fonctions, par ce qu'elles font

Tester et vérifier

  • IsDeclared A declared profile is any scope that is NOT the live machine. dans stzSystemProfile
  • IsAndroid os family checks dans stzOperatingSystem
  • IsDesktop os family checks dans stzOperatingSystem
  • IsUnixLike os family checks dans stzOperatingSystem
  • IsMicrosoft os family checks dans stzOperatingSystem
  • HasSecretAuth the site holds a secret (directly, or by name in a store) rather than a ref. dans stzDeploymentSite
  • HasChild TRUE if this object is managing a spawned child. dans stzProcess
  • IsBigEndian is the single source) dans stzProcess
  • IsLittleEndian 0 = little-endian, 1 = big-endian. dans stzProcess
  • Can Does the actor hold this capability kind? dans stzSystemActor
  • IsEffectful The one that decides whether a plan may cross: can this actor cause effects at all? dans stzSystemActor
  • HasVar TRUE if the variable is set (even to an empty string is reported as unset by the OS get, which returns "" for both -- so Has means "get returns a non-empty value"). dans stzEnvironment

Compter et mesurer

Remplacer et modifier

  • SetReturnType return type control dans stzSystemCall
  • SetWorld == 1. GENERATION ======================================================== SET the world this platform envelopes -- by HARVESTING its declarations into the platform's own records, right now. It does NOT hold the world: Haro copies an object into an attribute, so a held stzApp would be a dead snapshot the moment the caller touched it (see the aliasing note in the header). Call this AFTER the world is declared. The world is ASKED through its own accessors -- a platform never reaches into another object's attributes. (A constellation ADDs many worlds; a platform SETs its one.) dans stzPlatform
  • SetProfile A stzPlatformProfile DESCRIBES the solution -- its constituents (a server, a superapp, an app, ...) and their target systems. The platform OWNS one and drives its lifecycle: Build() the platform and its constituents, THEN Deploy() them -- two separate, ordered operations. (SetProfile snapshots the profile, so configure it fully first -- the aliasing doctrine.) dans stzPlatform
  • SetKdfRounds Tune the KDF cost. Default 100k; lower ONLY in tests. Must be set before RegisterIdentity (a stored hash is bound to the rounds used). dans stzPlatform
  • SetKind the access config (Q-fluent: chainable via the ...Q suffix) dans stzDeploymentSite
  • SetAuthRef auth is EITHER a plain reference string (e.g. "env/DEPLOY_KEY", back-compat) OR a stzSecret. When it is a secret, the site stores the OBJECT and displays only its redacted descriptor -- the key never lands in Config/ConfigJson. dans stzDeploymentSite
  • SetCapacity what the host PROVIDES (its capacity). For a real host it is discovered via the provider API; for a fixed host it is declared here. dans stzDeploymentSite
  • SetProvider name a provisioning provider -> this host can be CREATED/resized to meet a requirement (IaC-style), not just deployed to. dans stzDeploymentSite
  • SetAuthFromStore reference the auth secret BY NAME from a central stzSecretStore. The site holds NO key and NO store object -- only the name (Haro copies objects on assignment, so a held store would be a private copy whose audit no one sees). The reveal is done through the SHARED store, passed by reference at reveal time (ResolveAuthVia), so the store's gate applies AND the store audits it. This is how a project keeps ONE complete audit trail across every reveal. dans stzDeploymentSite
  • SetTarget Set the build target -- a stzSystemProfile (a deployment system), a friendly name (:LinuxServer, :ESP32), or a raw Zig triple ("x86_64-linux-gnu"). dans stzBuilder
  • SetRingRoot Haro parts: lower to C, then compile through Zig dans stzBuilder
  • SetActor the executing actor -- governs whether Deploy(:Production) COMMITS or only rehearses (only an effectful actor may cross the governed bridge to reality). dans stzDelivery

et 13 autres dans la référence

Ajouter

  • PushWorld == 5. REGISTRY + ENFORCEMENT =========================================== dans stzPlatform
  • AddCapability Request a capability for the attached world: oPlat.AddCapabilityQ(:camera).SetPurposes([ :scan-dish-photo ]) dans stzPlatform
  • AddSource the declarative spec (fluent) dans stzBuilder
  • AddApp the apps dans stzPlatformProfile
  • AddDevice a firmware part's DEVICE model (pins + an automation rule) ------- pins: [ [ pinNo, label, role, value ], ... ] role = "sensor" | "actuator". dans stzAppTopology
  • AddDataset define the model (Q-fluent) ------------------------------------- a named dataset -- the solution's real domain data. A menu dataset is [ [ name, desc, price ], ... ]; an orders dataset is [ [ dish, qty ], ... ]. dans stzAppTopology
  • AddWasm Add a wasm part -- a prebuilt .wasm path, or a stzBuilder (which is built). dans stzWebBundle

Découper et extraire

  • Parts delegating reads into the owned profile dans stzPlatform
  • PartNames every part that has been given a role, in declaration order (the remote backend serialises these so a hosting PROCESS can rebuild the model). dans stzAppTopology

Convertir

  • FromString Parse .stzsystem text into this profile. Defaults the role to deployment (a declared target) unless the text says otherwise, and fills class-default capabilities when no capabilities line is present. dans stzSystemProfile
  • ToStzSystem the .stzsystem format (Law 1: a domain has a format) dans stzSystemProfile
  • ParseOutputAsLines "string" type needs no conversion dans stzSystemCall
  • ConvertOutputByType return type control dans stzSystemCall
  • ParseOutputAsNumber return type control dans stzSystemCall
  • ToCommand The full command line, as one string (rehearsable -- see it before you run it, the way the twin shows a plan before it commits). dans stzBuilder
  • AsRuleGraph Project parts AND services into one graph, so a rule can ask the question neither side can answer alone: does a part that is BOUND TO A SITE (i.e. destined for production) depend on a service that is still a fake? See stzServiceRuleSet. dans stzDelivery
  • ToStzPlatform the .stzplatform format dans stzPlatformProfile
  • To Declare the deployment target (a friendly token or a stzSystemProfile). dans stzAppProfile
  • ToBytes ToBytes: hex-decode the 32 hex chars (sans hyphens) into a list of 16 byte values. Pure Haro -- no engine call needed. dans stzUUID

Afficher, dessiner et mettre en forme

  • Show system info dans stzOperatingSystem
  • Print system info dans stzOperatingSystem

Lire et écrire

  • LoadFrom Read a .stzsystem file INTO this profile (the mirror of Save). dans stzSystemProfile
  • OpenFile utilities dans stzSystemCall
  • OpenSession Returns a session token, or "" (Why() explains) on refusal. The secret is verified by re-deriving with the stored salt + rounds and a CONSTANT-TIME compare (StzEngineCryptoConstEqual). dans stzPlatform
  • OpenCommonsOn == 3. THE COMMONS RUNTIME ============================================== Identity / sessions / messaging / stores over an OPEN stzDatabase. (The stored object shares the engine handle -- live; keep the original open while the platform runs.) dans stzPlatform
  • ReadError wait / kill) dans stzProcess
  • ReadOutput Reads the next available chunk of the child's stdout. Blocks until at least one byte arrives, or returns "" at end of stream. This is the STREAMING read -- call it in a loop. dans stzProcess
  • ReadErrorAll wait / kill) dans stzProcess
  • ReadOutputAll Reads the child's stdout to the end, returning all of it. dans stzProcess

Parcourir et appliquer

  • Run main execution dans stzSystemCall
  • Execute main execution dans stzSystemCall
  • RunSilent silent execution dans stzSystemCall
  • RunSilently silent execution dans stzSystemCall
  • RunEngineSilent silent execution dans stzSystemCall
  • RunAfter order the plan: pcPart runs AFTER pcDependsOn is verified (a plan-DAG edge). Simple deployments declare none; complex ones (a frontend after its backend) do. dans stzDeployment
  • Apply The domain hook the generic twin calls to rehearse an operation. dans stzEnvironmentState
  • ExecuteStepByStep Same commit, printing each step as it crosses. dans stzUpdatePlan
  • ExecuteOperation Rehearse ONE operation: mutate the in-memory twin and record it. Touches nothing real (P1). dans stzVirtualSystem

Les explications sont celles que la bibliothèque donne d'elle-même, en anglais, lues dans ses commentaires de documentation le 2026-10-01 04:14, from the library at commit 0e72e2e2c, by the library's own stzSelfDoc over 635 class sources.

Les classes de ce domaine

Les narrations sur ce domaine