# Tangu Programming Language

> A language for humans and machines. Tangu (v0.32.0) is a fast, general-purpose homoiconic s-expression programming language that unifies application code (`.tan`), structured data manifests (`.data.tan`), and composable UI & database DSLs (`#shtml`, `#css`, `#svg`, `#sql`) across a bytecode VM, Cranelift JIT, native AOT binaries, and Rust/JavaScript transpilers.

## Quick Links

- [Overview & Architecture](https://tangu.dev/): Language overview, execution targets, and built-in CLI toolchain (`tangu run`, `test`, `check`, `lint`, `fmt`, `doc`, `bench`).
- [Complete Single-File Reference (`llms-full.txt`)](https://tangu.dev/llms-full.txt): Full Tangu language tutorial, idiomatic agent rules, prelude built-ins, and all 70+ standard library module references in one Markdown file.
- [Official Installer (`install.sh`)](https://tangu.dev/install.sh): Install `tangu`, `tangu-lsp`, `tangu-format`, and `@standard` libraries (`curl -fsSL https://tangu.dev/install.sh | sh`).
- [GitHub Organization](https://github.com/tangu-dev): Official source repositories and issue tracker.

## Documentation & Standard Library Reference

- [Language tutorial](https://tangu.dev/tutorial/): Progressive step-by-step guide from installation and s-expressions to structs, traits, pattern matching, and modules.
- [Prelude & core built-ins](https://tangu.dev/stdlib-prelude/): Special forms, universal sequence accessors, core types, arithmetic/bitwise operators, and derivable traits.
- [Collections & iteration](https://tangu.dev/stdlib-collections/): Lazy iterator combinators (/iter), sets (/set), sorted and unordered maps, vectors (/vec), and ring buffers.
- [Text, strings & localization](https://tangu.dev/stdlib-text/): String manipulation (/string), regular expressions (/regex), CommonMark (/text/cmark), HTML escaping, and ICU4X (/i18n).
- [System, filesystem & I/O](https://tangu.dev/stdlib-system/): Filesystem operations (/fs), buffered I/O (/io), path manipulation (/path), processes (/process), OS threads (/thread), and async coroutines (/coro).
- [Data, codecs & validation](https://tangu.dev/stdlib-data/): JSON encoding/decoding (/codec/json), URI encoding (/codec/uri), CSV tables (/csv), Base64 (/base64), and struct validation.
- [Time, date & scheduling](https://tangu.dev/stdlib-time/): High-precision clocks, civil dates, time zones, durations (/chrono), Gregorian calendars (/calendar/gregorian), and cron schedules (/cron).
- [Web, HTTP & CLI](https://tangu.dev/stdlib-web/): HTTP client/server (/http/*), full-stack web apps (/web/app/*), WebSockets, SHTML/CSS representation, and CLI argument parsing (/cli).
- [PostgreSQL & SQLite databases](https://tangu.dev/stdlib-database/): Connection pools, read/write replica routing, strong vs eventual consistency queries (/postgres/client), and embedded SQLite (/sqlite/client).
- [Security, hashing & cryptography](https://tangu.dev/stdlib-security/): SHA-256 and HMAC (/crypto), CSPRNG tokens, fast non-cryptographic hashes (/hash), JWT signing/verification (/jwt), and UUIDs (/uuid).
- [Mathematics, SIMD & image codecs](https://tangu.dev/stdlib-math-media/): Transcendental math (/math), statistics, 4x4 matrices (/mat), portable SIMD vectors (/simd), PRNGs (/rng), and AVIF/JPEG/PNG/WebP codecs.