Comment on page

pkgx & Scripting

pkgx is a “Universal” Interpreter
$ pkgx ./script.py
pkgx: running python ./script.py
​
$ pkgx ./script.ts
pkgx: running: deno run ./script.ts
​
$ head -n1 ./script
#!/usr/bin/ruby
$ pkgx ./script
pkgx: running: ruby ./script
We read the shebang and install the interpreter before executing the script. If there is no shebang we use the default interpreter for the file extension.
shebangs
You can use pkgx as the shebang for your scripts:
#!/usr/bin/env -S pkgx [email protected]
​
import sys
​
print(sys.version)
$ chmod +x ./my-script.py
$ ./my-script.py
3.9.17
Using env to invoke pkgx is typical for tools that have no POSIX location.
The -S parameter is required to pass multiple arguments.
Including Additional pkgs
Scripts are the glue that allows open source to be composed into powerful new tools. With our +pkg syntax you make anything in open source available to your script.
#!/usr/bin/env -S pkgx +openssl deno run
​
Deno.dlopen("libssl.dylib")
Shell Scripting
#!/bin/sh
​
eval "$(pkgx --shellcode)"
# ^^ integrates `pkgx` during this script execution
​
env +openai
# ^^ requires integration
​
openai --version
Robustness requires precisely specifying your environment:
#!/usr/bin/env -S pkgx bash>=4
​
source <(pkgx --shellcode)
# ^^ bash >=4 is required for this syntax, and eg macOS only comes with bash 3
Super Portable Scripts
If you like you can use our cURL-installer in your scripts. If pkgx is installed then the script just exits and uses that pkgx, if it’s not installed, it installs pkgx to a temporary directory first.
#!/bin/sh
​
eval "$(curl -Ssf https://pkgx.sh)"
​
which pkgx   #=> /tmp/pkgx.sh/pkgx
echo $PATH  #=> /tmp/pkgx.sh:$PATH
​
pkgx +node@16 which node  #=> /tmp/pkgx.sh/nodejs.org/v16/bin/node

Last modified 1mo ago