platform

This package provides a unified abstraction layer for platform-specific functions. It exposes a single, agnostic API that handles the differences between desktop and web environments.

Features:

• Agnostic file I/O: Wrappers read_entire_file and write_entire_file match the core:os signature but work across all build targets.
• Serialization helpers: High-level functions loadStruct and saveStruct for generic data persistence, along side low-level loadBytes and saveBytes.

Usage

init :: proc() {
  // Load a config file from LocalStorage or a disk file
  data, success := platform.loadBytes("config")
  if success {
    // ...
  }
}

exit :: proc() {
  // Saves to LocalStorage or a specified save file dependent on the build target
  platform.saveStruct("save01", &potState)
}

---

loadBytes

loadBytes :: proc (key: string, allocator := context.allocator) -> (data: []byte, success: bool)

Loads raw bytes from persistent storage.

---

loadStruct

loadStruct :: proc (key: string, value: ^$T) -> (success: bool)

Loads a struct from persistent storage. Returns false if the key doesn’t exist or data is corrupted.

---

read_entire_file

read_entire_file :: proc (
  name: string,
  allocator := context.allocator,
  loc := #caller_location,
) -> (
  data: []byte,
  success: bool,
)

Reads an entire file into memory.

Platform-agnostic wrapper.

• Web: Reads from the Emscripten Virtual File System.
• Desktop: Reads directly from the disk.

Note

Naming follows core:os convention rather than camelCase to indicate standard library behavior.

---

saveBytes

saveBytes :: proc (key: string, data: []byte) -> (success: bool)

Saves raw bytes to persistent storage.

---

saveStruct

saveStruct :: proc (key: string, value: ^$T) -> (success: bool)

Serializes and saves a struct to persistent storage.

• Desktop: Saves to saves directory as a binary file. (by default)
• Web: Saves to LocalStorage (Base64 encoded string).

---

write_entire_file

write_entire_file :: proc (name: string, data: []byte, truncate := true) -> (success: bool)

Writes a byte slice to a file.

Platform-agnostic wrapper.

• Web: Writes to the Emscripten Virtual File System (non-persistent between sessions).
• Desktop: Writes directly to the disk.

---