A comprehensive standard library for the Sindarin programming language, providing modules for I/O, networking, cryptography, encoding, and more.

Add the SDK as a dependency in your sn.yaml:

dependencies:
- name: sindarin-pkg-sdk
  git: git@github.com:SindarinSDK/sindarin-pkg-sdk.git
  branch: main

Then run sn --install to fetch the package.

import "sdk/time/date"
import "sdk/time/time"
import "sdk/os/env"
import "sdk/core/random"
import "sdk/io/textfile"

fn main(): int =>
    // Current date and time
    var today: Date = Date.today()
    var now: Time = Time.now()
    print($"Today: {today.toIso()}\n")
    print($"Now: {now.format("HH:mm:ss")}\n")

    // Environment variables
    var user: str = Environment.getOr("USER", "unknown")
    print($"User: {user}\n")

    // Random values
    var dice: int = Random.randInt(1, 6)
    print($"Dice roll: {dice}\n")

    // File I/O
    TextFile.writeAll("/tmp/hello.txt", "Hello, SDK!")
    var content: str = TextFile.readAll("/tmp/hello.txt")
    print($"File: {content}\n")

    return 0

Full documentation is available in the docs folder.

• SDK Overview - Introduction and shared concepts

General-purpose utilities for math, randomness, identifiers, and versioning.

Data serialization, parsing, and compression.

File operations, path utilities, directory management, and standard streams.

TCP, UDP, TLS, DTLS, SSH, QUIC, and Git networking.

Operating system and process interaction.

Calendar dates and timestamps.

To run the SDK test suite:

make test

This will compile and run all tests with parallel execution. Use make help to see all available targets.

The SDK depends on:

• sindarin-pkg-libs — native library bindings (OpenSSL, zlib, etc.)
• sindarin-pkg-test — testing framework

Dependencies are automatically managed via the sn.yaml package manifest.

MIT License - see LICENSE for details.