Blorp by Example

Where to Go Next

After the tour, choose the part of Blorp that matches the program you want to write.

Std Tour

Read the standard library modules for concrete APIs and doctested examples.

import-std.brp

import:
    json: parse_json
    csv: format_csv

Examples

Small programs are the best next step after syntax and data basics.

terminal

blorp run examples/hello.brp

Tests

The test suite shows how compiler behavior, runtime behavior, and std APIs are expected to work.

test.brp

func test_count_words() -> Bool:
    count_words("one two") == 2

Architecture Docs

The architecture docs explain the compiler pipeline, memory model, and runtime direction.

terminal

blorp compile --dump-core-after=lower file.brp

Contribution Paths

Good first routes are CLI apps, data parsers, numeric code, or a concurrent service.

routes.txt

CLI app -> args + files
Data parser -> JSON + Result
Numeric code -> tensors + profile

Example

choose-a-route.txt

CLI app: args, files, Result, tests
Data parser: JSON, CSV, validation, Result
Numeric code: tensors, dimensions, profile
Concurrent service: concurrent:, channels, pure core