---
name: "poncho_package_run"
section: "1"
platform: "linux"
package: "coop-computing-tools"
version: "1:7.14.5-1+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/poncho_package_run"
---

# poncho\_package\_run(1)

wrapper script that executes Python script within an isolated Conda environment

## NAME

**poncho\_package\_run** - wrapper script that executes Python script within an isolated Conda environment

## SYNOPSIS

FCponcho\_package\_run \[options\] --environment *\<file\>* *\<command and args ...\>*FT

## DESCRIPTION

The **poncho\_package\_run** tool acts as a wrapper script for a Python task, running the task within the specified Conda environment. **poncho\_package\_run** can be utilized on different machines within the Work Queue system to unpack and activate a Conda environment, and run a task within the isolated environment.

The --environment *\<file\>* argument is the name of the Conda environment as a tarball file in which to run the Python task. The --environment *\<file\>* argument is the name of the Conda environment as a tarball file in which to run the Python task. command and args (the COMMAND) are interpreted as ARGV for a command to be run inside the Conda environment.

By default, the conda environment is unpacked into a temporary directory which is removed at the end of execution. If the --unpack-to *\<dir\>* is given, then the environment is unpacked to *\<dir\>*, and it is not removed at the end of execution. Further (even simultaneous) executions of python\_package\_run will not unpack the environment if *\<dir\>* is already populated. Instances of python\_package\_run coordinate via a writing lock. By default, the wait for a writing lock is 300 seconds, but this can be modified with the --wait-for-lock *\<secs\>* option.

If the argument to --unpack-to does not exist, then it is created as an empty directory. If it is an existing directory, but it is not empty, then unpacking is not performed, regardless on whether this directory contains a valid conda environment.

## OPTIONS

- **-e,--environment=*\<file\>***

     Conda environment as a tar file. (Required.)

- **-u,--unpack-to=*\<dir\>***

        Directory to unpack the environment. If not given, a temporary directory is used.

- **-w,--wait-for-lock=*\<secs\>***

   Number of seconds to wait to get a writing lock on *\<dir\>*. Default is 300.

- **-d,--debug**

   Print debug messages.

- **--help-env-creation**

   Show instructions to create conda environments as tar files.

- **-h,--help**

                  Show the help screen.

## EXIT STATUS

On success, returns 0. On failure, returns non-zero.

## EXAMPLE

FCponcho\_package\_run --environment example\_venv.tar.gz python3 example.pyFT

This will run the command python3 example.py within the Conda environment in example\_venv.tar.gz. Note that this command can be performed either locally, on the same machine that analyzed the script and created the environment, or remotely, on a different machine that contains the Conda environment tarball and the example.py script.

FCponcho\_package\_run --unpack-to my\_persistent\_env --environment example\_venv.tar.gz python3 example.pyFT

The previous command will run faster the second time it is executed, as the environment is only unpacked once to my\_persistent\_env.

## COPYRIGHT

The Cooperative Computing Tools are Copyright (C) 2022 The University of Notre Dame.  This software is distributed under the GNU General Public License.  See the file COPYING for details.