README.md
Rama main · réplica de lectura del repositorio original.
## Introduction
> **What is Dorpn?**
Dorpn is a statically-typed inference compiled programming language designed for developers who value both performance and productivity. It combines Python-like readability with C-level execution speed — clean syntax on the surface, native binary underneath.
---
> **Philosophy**
Dorpn is built around three principles:
1. **Simplicity First** — Clean, readable syntax that's easy to learn and write.
2. **Performance by Default** — Compiled to native code, no interpreter in the way.
3. **Safety** — Static typing and semantic analysis catch errors before your program ever runs.
---
> **Key Features**
- **Clean Syntax** — Python-inspired, minimal boilerplate, indentation-based structure
- **Multi-Target Compilation** — Compile to native binary (via C) or JavaScript with `-js` or `--Javs` **v0.4.0+**
- **Static Type Inference** — Types are inferred automatically, no need to annotate everything
- **No Runtime Overhead** — No VM, no garbage collector, no JIT warm-up delay
- **ANSI Color Support** — Terminal color output via escape sequences, works out of the box
- **Fast JS Output** — JavaScript target compiles in milliseconds for quick iteration **(v0.4.0+)**
---
## Basic Syntax
<img width="1080" height="1298" alt="Screenshot_2026-09-28-12-16-01-35_eaaf3677660ea7bb87b91dca63eade31" src="https://github.com/user-attachments/assets/fcd0e749-6db7-469e-bf44-a06190277b52" />
---
> **Source Code**
The compiler source will be released once Dorpn reaches v1.0 or becomes self-hosted. Compiled binaries are available on the [Releases page](https://github.com/Dorpn-hub/dorpn/releases).
---
> **Performance**
Dorpn compiles to C and then to a native binary via GCC, which means execution performance is close to hand-written C. The JavaScript target trades some runtime speed for near-instant compilation.
| Metric | Result |
|--------|--------|
| JS compilation time | ~0.002s |
| Native (C) compilation time | ~0.452s |
| Cold startup | ~0.7ms |
| Base memory (small programs) | 2–4 MB |
| Base memory (larger programs) | 20–50 MB |
**Where Dorpn does well:**
- Instant cold start — no VM initialization
- Predictable performance — no GC pauses, no JIT variance
- Lean memory footprint — ideal for CLI tools and constrained environments
- Fast math and I/O — running close to the metal
**Current trade-offs:**
- Native compilation (~0.4s) adds a small overhead to the dev loop — use the JS target for quick testing
- String-heavy workloads will see further improvements in upcoming releases
*Benchmarks are approximate and will shift as the compiler matures.*
---
## In v0.4.0+
> **Multi-Target Compilation**
Starting from v0.4.0, Dorpn supports multiple compilation targets:
```sh
# Compile to native binary (default)
dorpn program.dpn
# Compile to JavaScript and shows compilation time
dorpn program.dpn -js -t
# Compile and run immediately (JS target)
dorpn program.dpn -js -r
```
The JavaScript target is useful for rapid testing — compilation finishes in milliseconds compared to the full C pipeline.
---
Terminal Color Output
Starting from v0.4.0, Dorpn includes printOut() — a built-in that writes to stdout without a newline, making ANSI color output easy to compose:
```nim
Const fgGreen = "\033[92m"
Const fgRed = "\033[91m"
Const fgReset = "\033[0m"
func main():
printOut(fgGreen)
printOut("SUCCESS")
printOut(fgReset)
print(" - Dorpn is working!")
```
---
Support
- Open an **issue** in this repository
- Join the [Discord community](https://discord.gg/9J2qabs3gu) server