Versioning

This library’s version numbers follow the SemVer 2.0.0 specification.

Installation

pip install dynamicscope

Usage

Import:

from dynamicscope import DYNAMIC_SCOPE

To get a variable named x in the current dynamic scope:

DYNAMIC_SCOPE.x

(Note: dynamic scope starts with your stack frame, not your caller’s stack frame, so if you have a variable named x in the local scope, DYNAMIC_SCOPE.x will refer to that x, not bypass it.)

To overwrite a existing variable named x in the current dynamic scope:

DYNAMIC_SCOPE.x = 'foo'

To delete a variable named x found in the current dynamic scope:

del DYNAMIC_SCOPE.x

(DANGER: reaching up from a lower scope to delete variables in callers is a GOTO-level crime under international software law.)

If a variable is not found in dynamic scope, an AttributeError is raised:

AttributeError: 'x' not found in dynamic scope

(It is an AttributeError and not a NameError because dynamic scope is accessed with attribute access - returning the standard error for attribute access composes better with existing code and builtins like hasattr, getattr, and delattr.)

Getting and setting variables with dynamic scope is not always possible in Python. Two errors, both subclasses of RuntimeError, are defined to help you detect when it cannot be done:

• If the stack cannot be inspected to find variables during either a get, set, or delete: a dynamicscope.ReadError is raised.

• If the stack cannot be modified during a set or delete: a dynamicscope.WriteError is raised.