shell-source 2.0.0

A python module for sourcing variables from shell scripts

python-shell-source

A python module for sourcing variables from shell scripts.

Installation

You can install this package with pip or conda.

$ pip install shell-source

$ conda install -c abrahammurciano shell-source

Documentation

The full documentation is available here

Usage

This module provides a function source which attempts to mimic the shell's source command.

The purpose of this function is to allow you to run a shell script which sets either environment variables or local variables, and then give you access to those variables. Normally this is not a straght-forward task, but this function achieves it by running the script in its intended shell then injecting commands to the shell to write its local variables and its environment variables to a temporary file. Finally it reads the temporary file and parses it to return to you with exactly the data you asked for.

Basic Usage

If you just pass a script and an interpreter you'll get back all the environment variables and local variables visible to and set by the script.

>>> from shell_source import source
>>> variables = source("path/to/script.sh", "bash")
>>> # It returns a dictionary of local and environment variables known by the script.
>>> variables
{"USER": "abraham", "PATH": "/bin:/usr/bin", ..., "foo": "bar"}

Requesting Specific Variables

If you specify the argument variables, then only those variables you passed will be present as keys in the returned dictionary.

>>> source("path/to/script.sh", "csh", variables=("foo", "bar", "biz"))
{"foo": ..., "bar": ..., "biz", ...}

Ignoring Local Variables

If you don't want to obtain any local variables set by the script, but only want the environment variables, you can pass ignore_locals=True.

Supporting Different Shells

This module has been tested to work with bash, zsh, tcsh, and ksh. You can use any other shell that's somewhat posix compliant and supports the keyword "source", but it it doesn't work, you may use the ShellConfig class to indicate to source how to interact with your shell.

The class ShellConfig contains several string templates which are used to run the necessary commands with the shell. If the shell you want to use doesn't support any of the commands set by default in that class, you can pass an instance of ShellConfig to source to override the default templates.

For example, csh and fish are not supported by default, (specifically because they don't have the variable $? to get the exit status of the last command,) but we can source a script for one of these shells anyways by passing a ShellConfig instance which will declare how to get the exit code of the previous command.

source(
	"path/to/script.csh",
	"csh",
	shell_config=ShellConfig(prev_exit_code="$status")
)