__init__

Global functions

TIP

Note that the documentation is automatically generated from envd/api folder in tensorchord/envd repo. Please update the python file there instead of directly editing file inside envd-docs repo.

base

def base(os: str, language: str, image: Optional[str])

Set base image

Arguments:

• os str - The operating system (i.e. ubuntu20.04)
• language str - The programing language dependency (i.e. python3.8)
• image Optional[str] - Custom image (i.e. python:3.9-slim)

shell

def shell(name: str)

Interactive shell

Arguments:

• name str - shell name (i.e. zsh, bash)

run

def run(commands: str, mount_host: bool = False)

Execute command

Arguments:

• commands str - command to run during the building process
• mount_host bool - mount the host directory. Default is False. Enabling this will disable the build cache for this operation.

Example:

run(commands=["conda install -y -c conda-forge exa"])

git_config

def git_config(name: Optional[str] = None,
               email: Optional[str] = None,
               editor: Optional[str] = None)

Setup git config

Arguments:

• name optional, str - User name

• email optional, str - User email

• editor optional, str - Editor for git operations

  Example usage:

git_config(name="My Name", email="my@email.com", editor="vim")

include

def include(git: str)

Import from another git repo

This will pull the git repo and execute all the envd files. The return value will be a module contains all the variables/functions defined (expect those has _ prefix).

Arguments:

• git str - git URL

  Example usage:

envd = include("https://github.com/tensorchord/envdlib")

def build():
    base(os="ubuntu20.04", language="python")
    envd.tensorboard(8000)