envstack 0.1.0

Stacked environment variable management system.

envstack

Stacked environment variable management system.

Environment variables are declared in namespaced .env files using yaml syntax. The default namespace is stack and variables are declared in stack.env files.

Quickstart

To create a new environment stack, create a new namespaced .env file. For example, here is a simple thing.env file (namespace is "thing"):

all: &default
  FOO: bar

To see the resolved environment for the thing stack, run:

$ envstack thing
FOO 'bar'

Environment stacks are hierarchical, so values for $FOO defined in .env files lower in the filesystem (lower in scope) override those defined higher up (higher in scope):

/show/thing.env
/show/seq/thing.env
/show/seq/shot/thing.env
/show/seq/shot/task/thing.env

Variables can reference other variables defined elsewhere (but cannot be circular):

all: &default
  BAR: $FOO

Variables can be platform specific (and inherit the defaults):

linux:
  <<: *default
  HELLO: world

Environment files can include other namespaced environments:

include: ['other']

Installation

The easiest way to install:

$ pip install envstack

Usage

To see the default resolved environment for any given scope (directory):

$ envstack

To see the resolved environment for a given namespace.

$ envstack <namespace> [OPTIONS]

To resolve a $VAR declaration for a given namespace:

$ envstack <namespace> -r <VAR>

To trace where a $VAR declaration is being set:

$ envstack <namespace> -t <VAR>

To see an environment stack on another platform:

$ envstack <namespace> -p <platform>