Standard library

Dream includes a library for everyday tasks. Import the packages you need, such as import system.collections;. A few common types, including Option, Result, and Math, are available without an import. Shaders, rendering, and machine learning are in GPU and ML.

Each guide explains a task with examples. Entries with an API link also open the exact public declarations for that package in the API reference.

Core

Console, math, Option and Result, synchronization, and API errors.

• Built-insConsole output, Math, and Time, available from import system;.API
• Option and ResultHandle missing values and failures without null or exceptions.API
• Lock and SemaphoreCoordinate access to shared state between tasks.API
• API errorsUnderstand and handle failures reported by library calls.

Text and data

Strings, formatting, regular expressions, encodings, and SIMD.

• StringsJoin, interpolate, search, and change text.API
• FormattingFill message patterns with values using Fmt.format.API
• RegexFind, extract, and replace text with regular expressions.API
• EncodingConvert between text, bytes, UTF-8, hex, and Base64.API
• SIMDProcess a small group of numbers with each operation.API

Collections

Lists, maps, sets, queues, stacks, and queries over them.

• ListA growable sequence you read and change by position.API
• MapLook up values by key.API
• SortedMapA map that keeps its keys in order.API
• SetKeep unique values and test membership.API
• QueueProcess items in the order they arrive.API
• StackRemove the most recently added item first.API
• PriorityQueueRemove the smallest or highest-priority item first.API
• Queries and SeqFilter, transform, and combine collection items.API

System

Time, randomness, logging, testing, processes, and command-line arguments.

• RandomRepeatable random numbers for tests, games, and shuffling.API
• DateTimeDates, times, time zones, durations, and stopwatches.API
• LoggingRecord events with named loggers, levels, and handlers.API
• TestingWrite @test functions with assertions.API
• DebugInspect memory use while developing.
• ProcessLaunch and talk to child processes.API
• CLI argumentsDefine commands and parse command-line arguments.API
• Application utilitiesUUIDs, CSV, configuration files, and temporary resources.
• Raw sockets and compressionTCP and UDP sockets, plus gzip and deflate streams.API
• Windows and game inputOpen a window or use a browser canvas, then read keyboard, mouse and gamepad input once per frame.API
• Audio playback and FFTPlay audio, select outputs, and inspect PCM and frequency data.API

Files and network

Files, streams, paths, URLs, and HTTP clients.

• FilesRead and write files and folders.API
• StreamsRead and write data a piece at a time.API
• PathsBuild, split, and normalize file paths.API
• URLsParse URLs and work with query parameters.API
• HTTPSend HTTP requests and stream responses.API

Serialization

Turn values into data formats and back.

• JSONParse JSON, and derive encoders for your types with @json.API

Security

Secure randomness, hashing, and encryption.

• CryptoSecure random values, hashes, and AES-GCM encryption.API

Code generation

Libraries for writing source generators.

• CodeBuilderWrite formatted Dream source and inspect declarations from a generator.API