sqlitestore

Documentation

Overview

Package sqlitestore is the modernc.org/sqlite Store driver (RFC §13).

It is the V1 durable persistence driver for HTTP and Portico-managed Dockyard apps. modernc.org/sqlite is a pure-Go, CGo-free port of SQLite3 (brief 06 §2.8): the driver compiles and links with CGO_ENABLED=0 and cross-compiles cleanly to Dockyard's target triples (brief 06 §4 R6 — darwin/arm64, linux/amd64, linux/arm64, windows/amd64 are all supported; see decision D-026). Like every Store driver it passes the shared conformance suite in runtime/store/storetest.

The driver registers itself under the name "sqlite" via its init block; a blank import wires it up:

import _ "github.com/hurtener/dockyard/runtime/store/sqlitestore"

The data-source name passed to store.Open is a filesystem path. The special value ":memory:" opens a private in-memory SQLite database, useful for tests; an empty dsn is treated as ":memory:".

Index

• Constants
• func Open(ctx context.Context, dsn string) (store.Store, error)

Constants

const DriverName = "sqlite"

DriverName is the name this driver registers under.

Functions

func Open

func Open(ctx context.Context, dsn string) (store.Store, error)

Open opens (creating if absent) a SQLite database at dsn and returns a Store. An empty dsn or ":memory:" opens a private in-memory database.