# Tulpar Language

> As easy as Python, as fast as C. A statically-typed, AOT-compiled language with an LLVM 18 backend and a batteries-included HTTP / JSON / SQLite / OpenAPI stack — no framework required.

Tulpar compiles ahead-of-time via LLVM (no bytecode VM, no REPL) and ships HTTP, JSON, SQLite, an ORM and OpenAPI generation built into the runtime. Source files use the `.tpr` extension.

## Introduction
- [Getting Started](https://tulparlang.dev/intro/getting-started/): Write and run your first Tulpar program in under a minute.
- [Installation](https://tulparlang.dev/intro/installation/): Install Tulpar in seconds with the one-line installer, or grab a prebuilt binary by hand. No compiler required.

## FAQ
- [FAQ](https://tulparlang.dev/faq/): Frequently asked questions about the Tulpar programming language — what it is, how fast it is, whether it has a VM, and if it's production-ready.

## Language Guide
- [Arrays & JSON](https://tulparlang.dev/guide/arrays-json/): Learn about arrays and JSON support in Tulpar.
- [Async / Await](https://tulparlang.dev/guide/async/): Cooperative concurrency in Tulpar with async functions, await, sleep_async, gather, and the non-blocking HTTP client.
- [Concurrency (Threads & Mutexes)](https://tulparlang.dev/guide/concurrency/): Run work in parallel with thread_create and protect shared state with mutex_lock / mutex_unlock.
- [Control Flow](https://tulparlang.dev/guide/control-flow/): Learn about control flow statements in Tulpar.
- [Error Handling](https://tulparlang.dev/guide/error-handling/): Throw, catch, and clean up exceptions in Tulpar with try / catch / finally.
- [Functions](https://tulparlang.dev/guide/functions/): Learn how to define and use functions in Tulpar.
- [Modules & Imports](https://tulparlang.dev/guide/modules/): Learn how to organize your Tulpar code with modules and imports.
- [Structs](https://tulparlang.dev/guide/structs/): Learn how to define and use custom types (structs) in Tulpar.
- [Syntax & Variables](https://tulparlang.dev/guide/syntax/): Learn about Tulpar's syntax, data types, and variables.
- [Tulpar vs C Language](https://tulparlang.dev/guide/tulpar-vs-c/): Compare the Tulpar language with C side by side using practical examples.
- [Tulpar vs Go](https://tulparlang.dev/guide/tulpar-vs-go/): Compare the Tulpar language with Go side by side — syntax, arrays, strings, and building an HTTP API without reaching for third-party modules.
- [Tulpar vs Rust](https://tulparlang.dev/guide/tulpar-vs-rust/): Compare the Tulpar language with Rust side by side — syntax, arrays, strings, and building an HTTP API without reaching for third-party crates.

## Standard Library
- [Built-in Functions](https://tulparlang.dev/stdlib/builtins/): Reference for Tulpar's built-in functions.
- [Database (SQLite)](https://tulparlang.dev/stdlib/database/): Learn how to use SQLite databases in Tulpar.
- [Date & Time](https://tulparlang.dev/stdlib/datetime/): Built-in time functions — timestamps, ISO 8601 strings, monotonic clocks, and sleep.
- [File I/O](https://tulparlang.dev/stdlib/file-io/): Learn how to read and write files in Tulpar.
- [Math Functions](https://tulparlang.dev/stdlib/math/): Reference for Tulpar's math library.
- [Network (Sockets)](https://tulparlang.dev/stdlib/network/): Learn how to create network applications with Tulpar.
- [String Functions](https://tulparlang.dev/stdlib/string/): Reference for Tulpar's string manipulation library.
- [Testing (lib/test)](https://tulparlang.dev/stdlib/testing/): Jest-style assertion framework that ships with Tulpar — assert, assert_eq_int, assert_throws, and a suite runner.

## Ecosystem & Tooling
- [Benchmarks](https://tulparlang.dev/ecosystem/benchmarks/): How Tulpar performs against C / Go / Node.js / FastAPI on CPU and HTTP workloads.
- [Debugger](https://tulparlang.dev/ecosystem/debugger/): Step through Tulpar code with breakpoints, stack frames, and variable inspection — straight from VS Code or any DAP-aware client.
- [HTTP Client](https://tulparlang.dev/ecosystem/http-client/): Outbound HTTP/HTTPS requests via http_get, http_post, and friends. Built-in JSON convenience wrappers.
- [HTTP Server (Wings)](https://tulparlang.dev/ecosystem/http-server/): Wings is Tulpar's batteries-included HTTP framework — keep-alive connections, /healthz, /metrics, OpenAPI auto-gen, multi-threaded request handling, structured logging.
- [ORM (lib/orm)](https://tulparlang.dev/ecosystem/orm/): Active-Record style helpers over the embedded SQLite. orm_open / define_model / orm_create / orm_find / orm_all / orm_where / orm_update / orm_delete.
- [Package Manager](https://tulparlang.dev/ecosystem/package-manager/): tulpar pkg, tulpar.toml manifest format, tulpar.lock lockfile, and the path / url / registry version specs.
- [Tooling — LSP, Formatter, VS Code](https://tulparlang.dev/ecosystem/tooling/): tulpar --lsp language server, tulpar fmt formatter, and the official VS Code extension.
- [TulparAPI (lib/tulpar_api)](https://tulparlang.dev/ecosystem/tulpar-api/): A FastAPI-style micro-framework for building JSON APIs in Tulpar — decorators, middleware, response helpers.
- [Wings Cookbook](https://tulparlang.dev/ecosystem/wings-cookbook/): Task-oriented Wings recipes — CRUD APIs, auth middleware, dependency injection, JWT authentication, validation, pagination, file uploads, static files, route groups, response models, caching, file downloads, and SQLite-backed APIs.
- [Wings Tutorial — From Zero to a Real App](https://tulparlang.dev/ecosystem/wings-tutorial/): A guided, three-stage walkthrough that builds real Wings applications — a REST Todo API, a token-auth API with dependency injection, and a SQLite-backed persistent API. Each stage is a complete program you can run.

## Reference
- [CLI Reference](https://tulparlang.dev/reference/cli/): Every tulpar command and flag — run, build, fmt, pkg, lsp, version, update, help.
- [Language Reference](https://tulparlang.dev/reference/language/): A condensed single-page reference for Tulpar's syntax, types, operators, control flow, and module system. Skim or Ctrl-F.

## Examples
- [Advanced Examples](https://tulparlang.dev/examples/advanced/): Advanced Tulpar examples covering networking, file I/O, and databases.
- [Basic Examples](https://tulparlang.dev/examples/basic/): Learn from example programs written in Tulpar.
- [Games in the Browser](https://tulparlang.dev/examples/games/): Ten small games written in TulparLang, compiled to WebAssembly, with source you can read in both English and Turkish.

## Optional
- [Full documentation](https://tulparlang.dev/llms-full.txt): every page above concatenated as plain text, for agents that want the whole language reference in one fetch.
- [GitHub repository](https://github.com/hamer1818/TulparLang): compiler source, issues, releases.