BST-ARTIFACT-PUSH(1)

📦
version 2.8.1 · 2 versions
, in fedora 43, fedora 44, nixpkgs unstable, ubuntu stonking

💖 bst-artifact-push — bestie's guide to yeeting your artifacts into the cache 💖

okay so real talk, this is a page from the bst artifact push Manual, and we're gonna make it make sense. it's giving "you built the thing, now ship the thing". let's go 🫶

✨ NAME ✨

bst-artifact-push — Push a built artifact

like literally, that's the whole vibe. you made a thing, now you push the thing. periodt.

✨ SYNOPSIS ✨

bst artifact push [OPTIONS] [ARTIFACTS]...

✨ DESCRIPTION ✨

ok so here's the tea 🍵 — you push your built artifacts to a remote artifact cache, and ngl sometimes it's gonna pull them first before it pushes. it's a whole journey.

  • Specifying no elements means it just pushes the project's default targets. and if there are no default targets configured?? it pushes all project elements. we go big or we go home 💅
  • when you run this command from a workspace directory, the default is to push the workspace element. yes bestie, it just knows.
  • if bst has been configured to include build trees on artifact pulls, it's gonna try to pull any required build trees so it doesn't end up skipping partial artifacts that are being pushed. like, it's doing the extra work so you don't get a sad half-artifact. iconic behavior honestly 🌸
  • you wanna control which artifacts get pushed? specify --deps, and here are your options, no cap:
    • none: No dependencies, just the element itself
    • run: Runtime dependencies, including the element itself
    • build: Build time dependencies, excluding the element itself
    • all: All dependencies

✨ OPTIONS ✨

  • -d, --deps [build|none|run|all] — the dependencies to push. the default is none so like, if you don't say anything, it's just the element, bestie.
  • --artifact-remote REMOTE — a remote for uploading artifacts. tell it where to send the goods 📦✨
  • --ignore-project-artifact-remotes — ignore remote artifact cache servers recommended by projects. yeah, we're not listening to the project today, we're doing our own thing 🙈
🌟 reminder: --deps takes exactly one of build, none, run, or all — no vibes-based guessing, pick one fr fr.

and that's the whole page, bestie!! you ate 💅✨

this was the bst artifact push Manual, version 2.5, dated 2025-05-09 — mwah, sending you off with all the love 🎀🦋💖

📦 where this page comes from