Primordials

amalgam.primordials._add(_env: Environment, *nums: am.Numeric) → am.Numeric

Returns the sum of nums.

amalgam.primordials._and(env: Environment, *exprs: am.Amalgam) → am.Atom

Checks the truthiness of the evaluated exprs and performs an and operation. Short-circuits when :FALSE is returned and does not evaluate subsequent expressions.

amalgam.primordials._at(_env: Environment, index: am.Numeric, vector: am.Vector) → am.Amalgam

Indexes vector with index.

amalgam.primordials._bool(_env: Environment, expr: am.Amalgam) → am.Atom

Checks for the truthiness of an expr.

amalgam.primordials._break(env: Environment) → am.Notification

Exits a loop with :NIL.

amalgam.primordials._concat(_env: Environment, *strings: am.String) → am.String

Concatenates the given strings.

amalgam.primordials._cond(env: Environment, *pairs: am.Vector[am.Amalgam]) → am.Amalgam

Traverses pairs of conditions and values. If the condition evaluates to :TRUE, returns the value pair and short-circuits evaluation. If no conditions are met, :NIL is returned.

amalgam.primordials._cons(_env: Environment, amalgam: am.Amalgam, vector: am.Vector) → am.Vector

Preprends an amalgam to vector.

amalgam.primordials._div(_env: Environment, *nums: am.Numeric) → am.Numeric

Divides nums[0] and the product of nums[1:]

amalgam.primordials._do(env: Environment, *exprs: am.Amalgam) → am.Amalgam

Evaluates a variadic amount of exprs, returning the final expression evaluated.

amalgam.primordials._eq(_env: Environment, x: am.Amalgam, y: am.Amalgam) → am.Atom

Performs an equals comparison.

amalgam.primordials._eval(env: Environment, amalgam: am.Amalgam) → am.Amalgam

Evaluates a given amalgam.

amalgam.primordials._exit(env: Environment, exit_code: am.Numeric = <Numeric '0' @ 0x7f4206a81c90>) → am.Amalgam

Exits the program with the given exit_code.

amalgam.primordials._fn(env: Environment, args: am.Vector[am.Symbol], body: am.Amalgam) → am.Function

Creates an anonymous function using the provided arguments.

Binds env to the created amalgams.Function if a closure is formed.

amalgam.primordials._ge(env: Environment, x: am.Amalgam, y: am.Amalgam) → am.Atom

Performs a greater than or equal comparison.

amalgam.primordials._gt(_env: Environment, x: am.Amalgam, y: am.Amalgam) → am.Atom

Performs a greater than comparison.

amalgam.primordials._if(env: Environment, cond: am.Amalgam, then: am.Amalgam, else_: am.Amalgam) → am.Amalgam

Checks the truthiness of the evaluated cond, evaluates and returns then if :TRUE, otherwise, evaluates and returns else_.

amalgam.primordials._is_map(_env: Environment, vector: am.Vector) → am.Atom

Verifies whether vector is a mapping.

amalgam.primordials._le(env: Environment, x: am.Amalgam, y: am.Amalgam) → am.Atom

Performs a less than or equal comparison.

amalgam.primordials._len(_env: Environment, vector: am.Vector) → am.Numeric

Returns the length of a vector.

amalgam.primordials._let(env: Environment, pairs: am.Vector[am.Vector], body: am.Amalgam) → am.Amalgam

Creates temporary bindings of names to values specified in pairs before evaluating body.

amalgam.primordials._loop(env: Environment, *exprs: am.Amalgam) → am.Amalgam

Loops through and evaluates exprs indefinitely until a break or return is encountered.

amalgam.primordials._lt(_env: Environment, x: am.Amalgam, y: am.Amalgam) → am.Atom

Performs a less than comparison.

amalgam.primordials._macro(env: Environment, name: am.Symbol, args: am.Vector[am.Symbol], body: am.Amalgam) → am.Amalgam

Creates a named macro using the provided arguments.

amalgam.primordials._make_function(name: str, func: Optional[Callable[[…], T]] = None, defer: bool = False, contextual: bool = False, allows: Optional[Sequence[str]] = None) → Union[functools.partial, Callable[[…], T]]

Transforms a given function func into a Function and stores it inside of the FUNCTIONS mapping.

amalgam.primordials._map_at(_env: Environment, vector: am.Vector, atom: am.Atom) → am.Amalgam

Obtains the value bound to atom in vector.

amalgam.primordials._map_in(_env: Environment, vector: am.Vector, atom: am.Atom) → am.Atom

Checks whether atom is a member of vector.

amalgam.primordials._map_up(_env: Environment, vector: am.Vector, atom: am.Atom, amalgam: am.Amalgam) → am.Vector

Updates the vector mapping with :data:`atom, and amalgam.

amalgam.primordials._merge(_env: Environment, *vectors: am.Vector) → am.Vector

Merges the given vectors.

amalgam.primordials._mkfn(env: Environment, name: am.Symbol, args: am.Vector[am.Symbol], body: am.Amalgam) → am.Amalgam

Creates a named function using the provided arguments.

Composes _fn() and _setn().

amalgam.primordials._mul(_env: Environment, *nums: am.Numeric) → am.Numeric

Returns the product of nums.

amalgam.primordials._ne(_env: Environment, x: am.Amalgam, y: am.Amalgam) → am.Atom

Performs a not equals comparison.

amalgam.primordials._not(_env: Environment, expr: am.Amalgam) → am.Atom

Checks and negates the truthiness of expr.

amalgam.primordials._or(env: Environment, *exprs: am.Amalgam) → am.Atom

Checks the truthiness of the evaluated exprs and performs an or operation. Short-circuits when :TRUE is returned and does not evaluate subsequent expressions.

amalgam.primordials._print(_env: Environment, amalgam: am.Amalgam) → am.Amalgam

Prints the provided amalgam and returns it.

amalgam.primordials._putstrln(_env: Environment, string: am.String) → am.String

Prints the provided string and returns it.

amalgam.primordials._remove(_env: Environment, index: am.Numeric, vector: am.Vector) → am.Vector

Removes an item in vector using index.

amalgam.primordials._return(env: Environment, result: am.Amalgam) → am.Notification

Exits a context with a result.

amalgam.primordials._setn(env: Environment, name: am.Symbol, amalgam: am.Amalgam) → am.Amalgam

Binds name to the evaluated amalgam value in the immediate env and returns that value.

amalgam.primordials._setr(env: Environment, rname: am.Amalgam, amalgam: am.Amalgam) → am.Amalgam

Attemps to resolve rname to a amalgams.Symbol and binds it to the evaluated amalgam in the immediate env.

amalgam.primordials._slice(_env: Environment, vector: am.Vector, start: am.Numeric, stop: am.Numeric, step: am.Numeric = <Numeric '1' @ 0x7f4206a816d0>) → am.Vector

Returns a slice of the given vector.

amalgam.primordials._snoc(_env: Environment, vector: am.Vector, amalgam: am.Amalgam) → am.Vector

Appends an amalgam to vector.

amalgam.primordials._sub(_env: Environment, *nums: am.Numeric) → am.Numeric

Subtracts nums[0] and the summation of nums[1:].

amalgam.primordials._unquote(_env: Environment, qamalgam: am.Quoted[am.Amalgam]) → am.Amalgam

Unquotes a given qamalgam.

amalgam.primordials._when(env: Environment, cond: am.Amalgam, body: am.Amalgam) → am.Amalgam

Synonym for _if() that defaults else to :NIL.