spork-runtime

spork-runtime is the runtime distribution for Spork programs. It contains:

• the runtime types and helpers emitted Python code depends on;
• persistent collection integration backed by spork-pds;
• namespace and protocol support;
• JSON support and declared-test descriptors; and
• the Spork standard library implemented as ordinary Python modules.

It intentionally contains no reader, compiler, import hook, or .spork source files. A compiled Spork application can therefore depend on spork-runtime without installing spork-lang or compiling the standard library during installation.

Install

pip install spork-runtime

Python API

from spork.runtime import Keyword, assoc, get, hash_map, vec
from spork.std import map as maps
from spork.std import string

users = hash_map(Keyword("count"), 1)
users = maps.update(users, Keyword("count"), lambda value: value + 1)
assert get(users, Keyword("count")) == 2
assert string.join(", ", vec("Spork", "Python")) == "Spork, Python"

Python standard-library modules mirror the Spork namespaces:

spork.std.prelude.MACROS exposes the built-in macro implementations as Python callables for the compiler to install into its macro environment.

Development

python -m venv .venv
.venv/bin/python -m pip install -e '.[dev]'
.venv/bin/python -m pytest
.venv/bin/python -m build

The spork directory is an implicit namespace package. This allows spork-runtime, spork-pds, and spork-lang to provide separate portions of the same Python namespace.