Linux commands and phases

Linux command grammar

These forms describe the published native ASPL 0.7.0 tool. Follow the installation page for verification and PATH setup.

aspl [COMMON_OPTIONS] check [--] SOURCE
aspl [COMMON_OPTIONS] run [--] SOURCE
aspl [COMMON_OPTIONS] build [-o OUTPUT | --output=OUTPUT] [--] SOURCE

Common options are --diagnostic-language=ar|en and --color=auto|always|never. They precede the command and each may appear once. Values are case-sensitive and use =. Build output options precede the source. -- permits a source path beginning with a dash. Source paths end in .aspl or .لبات; commands take one root source and load its explicit source-module imports. They do not accept source from stdin, multiple roots, public bytecode output or program arguments.

Use aspl --version, aspl --help or aspl build --help for information. Version is the language-independent line aspl 0.7.0. Help and diagnostics default to Arabic, regardless of source vocabulary or process locale. For English, use aspl --diagnostic-language=en --help.

Compiler and execution phases

All three commands read the source, resolve explicit source modules, compile and validate private bytecode. check then discards the result. run prepares native dependencies and executes in the same process. build packages and validates an ELF, writes a temporary in the destination directory and publishes it by atomic rename. It invokes no external compiler or linker. Checking and building never execute the program or load its foreign libraries.

Without an output option, build removes the final source suffix. Explicit output paths are used as supplied. Missing parent directories are not created. A destination that is the source is rejected. A failure before publication retains the old output; successful publication replaces it. Atomic visibility does not promise durability across power loss.

Status and streams

Successful check/build returns zero and is silent unless there are warnings. run and built programs return the entry function's normal integer result from 0 through 255. A result outside that range traps. Normal nonzero results can overlap failure statuses; inspect stderr for diagnostics. Warnings do not change success status.

Program output uses stdout; diagnostics and traps use stderr. run adds no success banner to program output. Use --color=never for plain diagnostics in a script. The tool inherits working directory, environment and standard streams. Foreign code has native process authority and can fail outside ASPL's runtime guarantees.

Built program controls

A built program accepts only --aspl-diagnostic-language=ar|en and --aspl-color=auto|always|never, each once with =. With no controls, diagnostics are Arabic and color is automatic. It accepts no ordinary arguments, --, --help or --version. For example, ./hello --aspl-diagnostic-language=en --aspl-color=never runs the program. See native input and standalone execution.