pyrex.ini

# Pyrex User Configuration
#
# The following variables are made available as variable expansions when
# Pyrex is initialized:
#   ${pyrex:pyrexroot}      The absolute path to Pyrex (e.g. $PYREX_ROOT)
#

# Pyrex build information. Any changes to this section will require
# reinitializing the build environment to take effect.
[config]
# The version of Pyrex this config is written against. This option is required
# to be specified in the user config file
confversion = @CONFVERSION@

# A list of additional globs for commands that should be wrapped by Pyrex.
# Appends to the command set specified by the container itself when it was
# captured. Any path starting with a "!" will be excluded from being wrapped by
# Pyrex and will run directly in the host environment. You will often want to
# root these with an environment variable, remembering to import it with envimport.
# $PYREX_CONFIG_BIND is usually a good choice here, but you can set and use
# your own variable if desired. As an example:
#
#    ${env:PYREX_CONFIG_BIND}/bin/*
#    !${env:PYREX_CONFIG_BIND}/bin/exclude_this
#
# Note that any command listed here will take precedence over a command with
# the same name specified by the container, and excludes take precedence over
# includes. Thus, you can override the containers decision to include or
# exclude a command by adding it here.
%commands =

# The Container engine executable (e.g. docker, podman) to use. If the path
# does not start with a "/", the $PATH environment variable will be searched
# (i.e. execvp rules)
%engine = docker

# The type of image to build
%imagetype = oe

# As a convenience, the name of a Pyrex provided image
# can be specified here
%image = ubuntu-24.04-${config:imagetype}

# As a convenience, the tag of the Pyrex provided image. Defaults to the
# Pyrex version.
%pyrextag = v${pyrex:version}

# The name of the tag given to the image. If you want to keep around different
# Pyrex images simultaneously, each should have a unique tag
%tag = ghcr.io/garmin/pyrex-${config:image}:${config:pyrextag}

# If set to 1, the image is built up locally every time the environment is
# sourced. If set to 0, building the image will be skipped, which means that
# the container engine may attempt to download a prebuilt image from a
# repository
%buildlocal = 0

# A list of environment variables that should be imported as Pyrex
# configuration variables in the "env" section, e.g. ${env:HOME}. Note that
# environment variables accessed in this way must be set or an error will
# occur. Default values can be assigned by making an "env" section in this file
# and populating it with the default values. Also note that Pyrex will attempt
# to perform variable expansion on the environment variable values, so care
# should be taken
%envimport =
%    HOME
%    PYREX_BIND

[imagebuild]
# The command used to build container images
%buildcommand =
%    ${config:engine} build
%    -t ${config:tag}
%    --network=host
%    -f ${pyrex:pyrexroot}/image/Dockerfile
%    --target=pyrex-${config:imagetype}
%    --build-arg PYREX_BASE=${config:image}
%    ${pyrex:pyrexroot}/image

# Build quietly?
%quiet = true

# Environment variables to set when building the image
%env =
%   DOCKER_BUILDKIT=1

# Capture options. Changes in the section only affect when a Pyrex container is
# initialized
[capture]
%envvars =
%   BDIR
%   BITBAKEDIR
%   OEROOT

# Runtime options. Changes in this section take effect the next time a Pyrex
# command is run
[run]
# A list of directories that should be bound when running in the container
%bind =
%   ${env:PYREX_BIND}

# A list of environment variables that should be propagated to the container
# if set in the parent environment
%envvars =
%   http_proxy
%   https_proxy
%   no_proxy
%   SSH_AUTH_SOCK

# Environment variables that contain the path to a socket that should be
# proxied into the container (if set in the host environment)
%envsockproxy =
%   SSH_AUTH_SOCK

# Extra arguments to pass when running the image. For example:
#   --mount type=bind,src=${env:HOME}/.ssh,dst=${env:HOME}/.ssh,readonly
#   --device /dev/kvm
%args =

# Prefix for all Pyrex commands. Useful for debugging. For example:
#   strace -ff -ttt -o strace.log --
%commandprefix =

# Assign default values for environment variables in this section
[env]
%PYREX_BIND=