with-shadowed-bindings establishes a new lexical context
within which specified bindings are explicitly shadowed,
making it clear that they are not referenced within,
thereby reducing cognitive load.
One should normally import a single symbol from this package, with-shadowed-bindings.
Any other symbols from this package should normally be explicitly qualified, such as with-shadowed-bindings:invalid-access.
Don't (:use)!
bindings &body forms => results
Establishes a new lexical context within which the named bindings cannot be directly accessed, executes forms as an implicit progn within that context and returns the results.
Each binding names a binding to shadow, of either of the following types:
function as the first element and a function name as second element names a function or macro to shadow.Throws an with-shadowed-bindings:invalid-access error if an attempt is made to access any of the shadowed bindings within forms.
Currently, no attempt is made to detect if the named bindings to shadow are actually accessible in a parent environment.
Currently, there is no way to define new kinds of bindings that one could shadow.
For now, see the unit tests for examples.
error
Thrown when an attempt is made to access a binding shadowed by with-shadowed-bindings.
This condition class provides two slots, one initialized by initarg :kind and retrieved by with-shadowed-bindings:kind, and another initialized by initarg :name and retrieved by with-shadowed-bindings:name.
condition => kind
Returns the appropriate slot value from a with-shadowed-bindings:invalid-access condition.
kind is one of :variable, :function or :macro.
condition => name
Returns the appropriate slot value from a with-shadowed-bindings:invalid-access condition.
name is usually a symbol. In the case of a setf function, it would be (setf name).