bpkg-rep-remove(1)

📦
version 0.17.0 · 2 versions
, in fedora 43, fedora 44, nixos 26.05

💖 bpkg-rep-remove — bestie edition 💖

okay so real talk: this is bpkg-rep-remove(1), a General Commands Manual situation, and it's about yeeting repositories out of your configuration. sit down, grab a strawberry 🍓, and let's get into it.

✨ NAME ✨

bpkg-rep-remove — remove repository from configuration

like, it removes a repo. from the config. that's the whole vibe. 💅

🌸 SYNOPSIS 🌸

bpkg rep-remove|remove [options] --all|-a
bpkg rep-remove|remove [options] --clean

notice bestie: you can call it rep-remove or just remove, both slay 💖

🦋 DESCRIPTION 🦋

so the rep-remove command removes the specified package repositories from the configuration. iconic behavior honestly.

the repository you wanna remove can be specified either as a repository name or as a repository location (that's a URL or a directory path, iykyk).

alternatively — and this is the power move — you can use the --all|-a option to remove all the repositories that were previously added via bpkg-rep-add(1) to the configuration. all of them. every single one. gone. no cap.

finally, the --clean option reverts the repositories to the clean state — as if they were added but never fetched. like a factory reset but for your repos ✨

🎀 REP-REMOVE OPTIONS 🎀

  • --all|-a — Remove all the repositories. every last one, bestie 😭
  • --clean — Clean the repository state. pristine. untouched. brand new 🧼
  • --directory|-d dir — Assume configuration is in dir rather than in the current working directory. tell it where the config actually lives, it's not a mind reader 🙈

👑 COMMON OPTIONS 👑

these are the common options, summarized below, and there's a more detailed description available in bpkg-common-options(1). go read it if you want the full lore.

  • -v — Print essential underlying commands being executed. just the essentials, the main character moments ✨
  • -V — Print all underlying commands being executed. ALL of them. every single one. no filter 💀
  • --quiet|-q — Run quietly, only printing error messages. silent era 🎧
  • --verbose level — Set the diagnostics verbosity to level between 0 and 6. pick your vibe, babe 🌈
  • --stdout-format format — Representation format to use for printing to stdout.
  • --jobs|-j num — Number of jobs to perform in parallel. multitasking queen 👑
  • --no-result — Don't print informational messages about the outcome of performing a command or some of its parts. no commentary, just vibes.
  • --structured-result fmt — Write the result of performing a command in a structured form.
  • --progress — Display progress indicators for long-lasting operations, such as network transfers, building, etc. we love a loading bar 🫶
  • --no-progress — Suppress progress indicators for long-lasting operations, such as network transfers, building, etc.
  • --diag-color — Use color in diagnostics. colorful slay 🌈
  • --no-diag-color — Don't use color in diagnostics.
  • --build path — The build program to be used to build packages.
  • --build-option opt — Additional option to be passed to the build program.
  • --fetch path — The fetch program to be used to download resources.
  • --fetch-option opt — Additional option to be passed to the fetch program.
  • --fetch-timeout sec — The fetch and fetch-like (for example, git) program timeout. don't ghost it forever ⏰
  • --pkg-proxy url — HTTP proxy server to use when fetching package manifests and archives from remote pkg repositories.
  • --git path — The git program to be used to fetch git repositories.
  • --git-option opt — Additional common option to be passed to the git program.
  • --sha256 path — The sha256 program to be used to calculate SHA256 sums.
  • --sha256-option opt — Additional option to be passed to the sha256 program.
  • --tar path — The tar program to be used to extract package archives.
  • --tar-option opt — Additional option to be passed to the tar program.
  • --openssl path — The openssl program to be used for crypto operations. crypto 🔐
  • --openssl-option opt — Additional option to be passed to the openssl program.
  • --auth type — Types of repositories to authenticate.
  • --trust fingerprint — Trust repository certificate with a SHA256 fingerprint. trusting fr fr 🤝
  • --trust-yes — Assume the answer to all authentication prompts is yes.
  • --trust-no — Assume the answer to all authentication prompts is no.
  • --git-capabilities up=pc — Protocol capabilities (pc) for a git repository URL prefix (up).
  • --pager path — The pager program to be used to show long text.
  • --pager-option opt — Additional option to be passed to the pager program.
  • --options-file file — Read additional options from file.
  • --default-options dir — The directory to load additional default options files from.
  • --no-default-options — Don't load default options files.
  • --keep-tmp — Don't remove the bpkg's temporary directory at the end of the command execution and print its path at the verbosity level 2 or higher. keeping the receipts 🧾

🧚 DEFAULT OPTIONS FILES 🧚

See bpkg-default-options-files(1) for an overview of the default options files. (go read it bestie, it's giving essential context 💜)

for the pkg-rep-remove command, the search start directory is the configuration directory.

the following options files are searched for in each directory and, if found, loaded in the order listed:

bpkg-rep-remove.options

and here's the tea ☕ — the following rep-remove command options cannot be specified in the default options files:

  • --directory|-d
like, do not even try it. it's not happening. periodt. 💅

💀 BUGS 💀

Send bug reports to the users@build2.org mailing list.

(found a bug? tell the mailing list, be nice about it, we're all just doing our best 🫶)

Copyright (c) 2014-2024 the build2 authors.

Permission is granted to copy, distribute and/or modify this document under the terms of the MIT License.

and that's the whole page, bestie!! 🎀✨🦋

cute little sign-off: this was bpkg 0.17.0, dated June 2024, and it's the bpkg-rep-remove(1) manpage — go forth and remove those repositories responsibly, mwah 💖🌸💅

📦 where this page comes from