# Sifr

## Docs

- [sifr build and sifr run: Compile and Execute Sifr Programs](https://docs.sifr.sh/cli/build-run.md): Use sifr run to compile and execute in one step, or sifr build to produce a standalone native binary — with full flag reference and mode examples.
- [sifr check and sifr emit: Type-Check and Inspect Sifr Code](https://docs.sifr.sh/cli/check-emit.md): Run sifr check for fast type-check feedback without producing a binary, and sifr emit to inspect the Rust code that Sifr generates from your source.
- [sifr fmt and sifr lint: Format and Lint Sifr Source Files](https://docs.sifr.sh/cli/fmt-lint.md): Keep Sifr code consistently styled with sifr fmt and catch policy violations with sifr lint — with configuration, suppression, and auto-fix references.
- [sifr lsp: Language Server Protocol Support for Sifr](https://docs.sifr.sh/cli/lsp.md): Start the Sifr language server with sifr lsp --stdio for diagnostics, completions, hover, go-to-definition, formatting, and code actions in any LSP editor.
- [Sifr CLI Reference: Commands, Flags, and Exit Codes](https://docs.sifr.sh/cli/overview.md): A complete reference for every Sifr CLI command, global flags, exit codes, and the rules that determine single-file vs project mode.
- [sifr test: Discover and Run Tests in Sifr Projects](https://docs.sifr.sh/cli/test.md): Use sifr test to discover and run test functions in your project — including how to write tests, how discovery works, and how to read results.
- [Sifr Diagnostic Code Reference for All Error Families](https://docs.sifr.sh/diagnostics/error-codes.md): A complete reference of all 24 Sifr diagnostic code families, with every active code, its severity, and a concise description of what it means.
- [Understanding Sifr Diagnostics and Error Reporting](https://docs.sifr.sh/diagnostics/overview.md): Learn how Sifr reports errors and warnings, interpret severity levels, choose output formats, and suppress lint rules safely in your Sifr projects.
- [Install the Sifr Compiler on macOS or Linux — Quick Start](https://docs.sifr.sh/installation.md): Install the Sifr compiler on macOS or Linux using the official installer script, with options for channels, version pinning, and custom directories.
- [Introduction to Sifr: What It Is and Why It Exists](https://docs.sifr.sh/introduction.md): Discover what makes Sifr different — Python syntax that compiles to Rust, with compile-time ownership, union types, and zero runtime crashes.
- [Sifr Classes: Typed Fields, Methods, and Inheritance](https://docs.sifr.sh/language/classes.md): Define classes with typed fields, methods, and union narrowing in Sifr. Learn how classes integrate with isinstance checks and the Error base class.
- [Sifr Concurrency: Async Tasks and Structured Scopes](https://docs.sifr.sh/language/concurrency.md): Write concurrent Sifr programs with sifr.task, sifr.sync, and sifr.parallel. Structured scopes, typed channels, and parallel maps — all ownership-safe.
- [Sifr Error Handling: Result Types and Custom Errors](https://docs.sifr.sh/language/error-handling.md): Learn how Sifr replaces exceptions with Result[T, E] return types, compiler-enforced error handling, and custom Error classes — no runtime surprises.
- [Sifr Ownership: Borrow by Default and the own Keyword](https://docs.sifr.sh/language/ownership.md): Learn Sifr's borrow-by-default model: args borrow automatically, own transfers ownership, and the compiler catches use-after-move. No lifetime annotations.
- [Sifr Pattern Matching: match/case Expressions Explained](https://docs.sifr.sh/language/pattern-matching.md): Use Sifr's match statement for exhaustive pattern matching on literals, unions, class fields, and tuples — all verified at compile time, no missed cases.
- [Sifr Type System: Unions, Narrowing, and Generics Guide](https://docs.sifr.sh/language/type-system.md): Explore Sifr's static type system: union types, None-safety, isinstance narrowing, literal types, and TypeVar generics — all enforced at compile time.
- [Adding and Managing Dependencies in Your Sifr Package](https://docs.sifr.sh/packages/dependencies.md): Manage Sifr package dependencies with Cargo-backed resolution, lock modes, sifr fetch, sifr tree, and trust policy for backend Rust crates.
- [Configuring a Sifr Package with the sifr.toml Manifest](https://docs.sifr.sh/packages/manifest.md): A complete reference for sifr.toml — the Sifr manifest that controls compiler semantics, source layout, edition, scripts, and native trust policy.
- [Sifr Package Management: Libraries, Apps, and Init](https://docs.sifr.sh/packages/overview.md): Learn how Sifr packages work — from single-file scripts to full library and app projects — and how sifr.toml and Cargo.toml divide responsibilities.
- [How to Package, Publish, and Vendor Sifr Libraries](https://docs.sifr.sh/packages/publishing.md): Package, validate, and publish Sifr libraries with sifr package, sifr publish, and sifr vendor — including dry-run, include/exclude rules, and vendoring.
- [Quickstart: Write, Run, and Build Your First Sifr Program](https://docs.sifr.sh/quickstart.md): Build a complete Sifr program using union types and error handling, then run, type-check, and compile it to a native binary in minutes.
- [Collections and Data Structures in the Sifr Stdlib](https://docs.sifr.sh/stdlib/collections.md): Use sifr.collections for Counter, deque, and set helpers. Safe indexing returns Option instead of crashing, with full iteration and comprehension support.
- [Concurrency Primitives: Tasks, Channels, and Parallelism](https://docs.sifr.sh/stdlib/concurrency.md): Concurrency API reference for Sifr: structured tasks, typed channels, CPU parallelism, subprocesses, runtime diagnostics, and cleanup helpers.
- [File I/O and Filesystem Operations in the Sifr Stdlib](https://docs.sifr.sh/stdlib/io-filesystem.md): Read and write files in Sifr with sifr.io explicit encodings. Covers sifr.pathlib, sifr.os, binary I/O, and why open() without encoding= is unsupported.
- [HTTP, TCP, TLS, and URL Networking in the Sifr Stdlib](https://docs.sifr.sh/stdlib/networking.md): Build async TCP clients and servers, handle HTTP protocol primitives, add Rustls TLS, and parse URLs using sifr.net, sifr.http, sifr.tls, and sifr.url.
- [Sifr Standard Library: Built-in Modules Overview Guide](https://docs.sifr.sh/stdlib/overview.md): A complete reference to the sifr.* standard library namespace: how to import modules, why bare CPython names are rejected, and what every module provides.
- [Text Processing, Unicode, and Encoding in the Sifr Stdlib](https://docs.sifr.sh/stdlib/text-encoding.md): Convert bytes to text with sifr.encoding, normalize Unicode 17.0.0 data with sifr.unicode, and format locale-aware output with sifr.i18n and .mo bundles.