ALR-EXEC(1)

✨ alr-exec 🎀 (Alire manual) ✨

💖 NAME

Okay so alr-exec is the main character of the Alire project context 💅 It runs whatever command you give it, inside the project context. Iconic, honestly.

🧚 SYNOPSIS

alr exec [options] [-P?] [--] <executable/script> [<switches and arguments>]

Bestie, the [-P?] bit is optional, and so is [options]. The -- is there so anything after it gets passed straight through to your command. 🫶

🌸 OPTIONS

• -P[ARG] — Adds -P <PROJECT_FILE> to the command switches. Lowkey the whole reason you're here 🦋

👑 GLOBAL OPTIONS

These are the global options, and they work on basically every subcommand. No cap, know them 🌈

• -c, --config=ARG — Overrides the configuration folder location 🍓
• -f, --force — Keeps going after a recoverable troublesome situation. Main character energy, but make it careful 💀
• -h, --help — Shows general help, or help for a specific command 🫶
• -n, --non-interactive — Assumes default answers for every user prompt. No questions asked 😭
• --no-color — Turns off colours in the output 🙈
• --no-tty — Turns off control characters in the output 💜
• --prefer-oldest — When resolving dependencies, it picks the oldest versions instead of the newest. Vibe check: this one's a little different ✨
• --version — Shows the version and exits 🦋
• -q — Limits the output to errors only 🌸
• -v — Makes things more verbose. Use it twice for extra detail 🔥
• -d, --debug[] — Turns on debug-specific log messages 🧚

🦋 DESCRIPTION

Okay so, alr exec sets up the environment variables (GPR_PROJECT_PATH, PATH, etc.) and then spawns the command you gave it. Literally so helpful 💖

This is the move for running tools or scripts on Alire projects. The -P switch tells Alire to slip a -P <PROJECT_FILE> switch into your command's arguments. It takes an optional position, so you can decide where it goes:

• -P1 means first position
• -P2 means second position, and so on
• -P-1 means last position
• -P-2 means penultimate position, and so on
• -P on its own equals -P1

For example, alr exec -P2 -- python3 main.py arg1 runs this command:

["python3", "main.py", -P, "crate.gpr", "arg1"]

The -P2 put the -P switch right in the second spot, so it's giving organised 👑

🌈 SEE ALSO

Here's where to look next, bestie 🎀 alr(1), alr-action(1), alr-build(1), alr-clean(1), alr-dev(1), alr-edit(1), alr-run(1), alr-test(1), gprbuild(1)

💅 AUTHOR

Generated with generate-man from Alire execution. Iykyk 🧚

Alire 1.2 · Aug 3, 2022 · ALR-EXEC(1) — bye bestie, you're literally the best 💖🫶✨