Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

The Minimalist Doctrine

In classical aerospace and mechanical engineering, the highest reliability is achieved not by complicating safety redundancies, but by engineering unnecessary valves and moving parts out of the machine entirely.

AzLang brings this functional minimalist mindset to software engineering:

┌───────────────────────────────────────────────────────────────────────────────────┐
│ AZLANG FIELD DOCTRINE                                                             │
│                                                                                   │
│  [Source Code] ──► [fasm Assembly Emission] ──► [180-Byte Bare-Metal Binary]      │
│                                                                                   │
│  • Self-contained toolchain with zero runtime dependencies.                       │
│  • Executes anywhere, compiles in microseconds, leaves zero operational footprint.│
└───────────────────────────────────────────────────────────────────────────────────┘

1. Field Reliability vs. Heavy Infrastructure

Traditional compiler architectures often assume an infinite logistical tail:

  • Background daemons continuously running in memory.
  • Gigabytes of backend frameworks (like giant LLVM installation footprints).
  • Multi-megabyte runtime libraries and dynamic linker dependencies.

AzLang rejects this assumption.

AzLang is designed as a self-contained, field-deployable compiler:

  • No background daemons: Compiles directly in one shot.
  • Direct AST Lowering: AST nodes lower straight into readable fasm assembly without requiring gigabytes of compiler caches.
  • Microsecond compilation: The compiler executable can be dropped onto an environment, parse code, validate semantics, emit assembly, and link a binary in milliseconds.

2. Kinetic Thrust: Direct Execution Paths

Rather than performing multi-pass combinatorial saturations that bloat compile times, AzLang focuses on kinetic thrust:

  • Short, deterministic execution paths.
  • Lean native assembly generated directly for target architectures.
  • High thrust-to-weight ratio in generated code: no dead code bloat, no virtual dispatch tables unless explicitly constructed.
MetricAzLang Engineering ModelHeavy Industrial Toolchains
Compilation LatencyMicroseconds to millisecondsSeconds to minutes
Output Binary SizeHello world: 180 bytes; ~2 KB for multi-module programs5 MB – 50 MB
Runtime DependenciesNone (Direct Kernel Syscalls)libc, libm, libpthread, dynamic runtimes
Hardware TargetsBare metal, microcontrollers, embedded, microservicesCloud servers, heavy multi-core desktops

3. Developer Ergonomics: The Helmet Sight

Soviet fighter aircraft pioneered Helmet-Mounted Cueing Systems (such as the Shchel-3UM) paired with clean, uncluttered analog cockpits. The pilot simply looks at a target and engages; the instruments stay out of the way.

AzLang adopts this philosophy for Developer Experience (DX):

  • Readable indentation-based syntax akin to Python.
  • Clear explicit boundary typing: Types are inferred automatically where obvious, and explicitly declared at structural boundaries (enum, object, parameter signatures).
  • The language frontend stays clear and readable while the backend quietly outputs a lethal, high-speed native binary.