bootstrap

Documentation

Overview

Package bootstrap performs initial setup of the environment. Create a new `*env.Environment` and then pass it to `Into`.

Index

• Constants
• func DevNull(e *env.Environment)
• func DevNullEnvironment() *env.Environment
• func Into(e *env.Environment)
• func ProcessArgs(e *env.Environment)
• func ProcessEnv(e *env.Environment)
• func StandardIO(e *env.Environment)
• func TopLevelEnvironment() *env.Environment

Constants

const (
	// ErrBuiltInNotFound is raised when a built-in procedure can't be resolved
	ErrBuiltInNotFound = "built-in not found: %s"

	// ErrSpecialNotFound is raised when a built-in special can't be resolved
	ErrSpecialNotFound = "special form not found: %s"

	// ErrMacroNotFound is raised when a built-in macro can't be resolved
	ErrMacroNotFound = "macro not found: %s"
)

Functions

func DevNull

func DevNull(e *env.Environment)

DevNull binds *in*, *out*, and *err* to the operating system's bit bucket device (usually /dev/null)

func DevNullEnvironment

func DevNullEnvironment() *env.Environment

DevNullEnvironment configures a bootstrapped environment completely isolated from the top-level of the system. All I/O is rerouted to and from the operating system's bit bucket device (usually /dev/null)

func Into

func Into(e *env.Environment)

Into sets up initial built-ins and assets. This call is useful if you're wiring up your own Environments. Otherwise, calls to TopLevelEnvironment and DevNullEnvironment will perform this action for you.

func ProcessArgs

func ProcessArgs(e *env.Environment)

ProcessArgs binds *args* to the current Go app's command line arguments

func ProcessEnv

func ProcessEnv(e *env.Environment)

ProcessEnv binds *env* to the operating system's environment variables

func StandardIO

func StandardIO(e *env.Environment)

StandardIO binds *in*, *out*, and *err* to the operating system's standard input and output facilities

func TopLevelEnvironment

func TopLevelEnvironment() *env.Environment

TopLevelEnvironment configures an environment that could be used at the top-level of the system, such as the REPL. It has access to the *env*, *args*, and operating system's standard in/out/err file streams.