Any way to make multiple scripts available in .pex?

[mconigliaro]

I have a desire to run both gunicorn and flask (for cli commands) for my app in production. It seems like I can only pick one or the other with the -c option while building the pex file. Is there some way to make everything available so both ./example.pex flask ... and ./example.pex gunicorn ... will work?

[jsirois]

There are 18 ways to accomplish this. Here's a few by example:

• Using PEX runtime environment variables:

  :; pex flask gunicorn -o multi-tool.pex
  
  :; PEX_SCRIPT=flask ./multi-tool.pex --version
  Python 3.11.12
  Flask 3.1.0
  Werkzeug 3.1.3
  
  :; PEX_SCRIPT=gunicorn ./multi-tool.pex --help | head
  usage: multi-tool.pex [OPTIONS] [APP_MODULE]
  
  options:
    -h, --help            show this help message and exit
    -v, --version         show program's version number and exit
    -c CONFIG, --config CONFIG
                          :ref:`The Gunicorn config file<configuration_file>`.
                          [./gunicorn.conf.py]
    -b ADDRESS, --bind ADDRESS
                          The socket to bind. [['127.0.0.1:8000']]

• Using conscript:

  :; pex flask gunicorn conscript -c conscript -o multi-tool.pex
  
  :; ./multi-tool.pex -h
  usage: multi-tool.pex [-h] [PROGRAM]
  
  A multi-tool.pex busy box.
  
  positional arguments:
    PROGRAM     The program to execute.
                
                The following programs are available:
                + flask
                + gunicorn
  
  options:
    -h, --help  Show this help message and exit.
  
  :; ./multi-tool.pex flask --version
  Python 3.11.12
  Flask 3.1.0
  Werkzeug 3.1.3
  
  :; ./multi-tool.pex gunicorn --help | head
  usage: multi-tool.pex [OPTIONS] [APP_MODULE]
  
  options:
    -h, --help            show this help message and exit
    -v, --version         show program's version number and exit
    -c CONFIG, --config CONFIG
                          :ref:`The Gunicorn config file<configuration_file>`.
                          [./gunicorn.conf.py]
    -b ADDRESS, --bind ADDRESS
                          The socket to bind. [['127.0.0.1:8000']]

• Using a PEX scie busybox:

  :; pex flask gunicorn conscript -o multi-tool.pex --scie eager --scie-busybox gunicorn --scie-busybox flask
  
  :; file multi-tool
  multi-tool: ELF 64-bit LSB pie executable, x86-64, version 1 (SYSV), static-pie linked, stripped
  
  :; ./multi-tool
  Error: Could not determine which command to run.
  
  Please select from the following boot commands:
  
  flask
  gunicorn
  
  You can select a boot command by setting the SCIE_BOOT environment variable or else by passing it as the 1st argument.
  
  :; ./multi-tool flask --version
  Python 3.11.12
  Flask 3.1.0
  Werkzeug 3.1.3
  
  :; ./multi-tool gunicorn --help | head
  usage: multi-tool [OPTIONS] [APP_MODULE]
  
  options:
    -h, --help            show this help message and exit
    -v, --version         show program's version number and exit
    -c CONFIG, --config CONFIG
                          :ref:`The Gunicorn config file<configuration_file>`.
                          [./gunicorn.conf.py]
    -b ADDRESS, --bind ADDRESS
                          The socket to bind. [['127.0.0.1:8000']]

[mconigliaro]

WTF, only 18? 😂

I think conscript is exactly what I was looking for. Thank you!