DC-TOOL(1)

📦
version 0.7.11build1 · 5 versions
, in ubuntu resolute, ubuntu stonking

💖 NAME 💖

okay so bestie, this is dc-tool — the little command that lets you manage contributions to contributors.debian.org. that's the whole vibe. she's a Debian user command, she's in section 1 of the manual, and she's here to help you get your contribution data where it needs to go. periodt. 👑

🌸 DESCRIPTION 🌸

here's the whole usage, and yes i'm giving it to you exactly as it comes, no edits, no cap:

usage: dc-tool [-h] [--debug] [--verbose] [--baseurl url] [--source
SOURCE] [--auth-token AUTH_TOKEN] [--json] [--post] [--method method]
[--mine conffile] [--mine-documentation] [source(s) ...]

that's a LOT of flags but don't panic, we're gonna walk through every single one. grab a snack. 🍓

🦋 positional arguments 🦋

  • source(s) — these are the JSON file(s) you wanna post, but ONLY when you didn't hand over --mine. if --mine is in the chat, these aren't needed. iykyk. ✨

💅 options 💅

  • -h, --help — shows you this help message and then dips out (exit). the classic. the icon. 🫶
  • --debug — turns on debugging output. all the messy little details, out loud. 💀
  • --verbose — turns on verbose output. chatty mode: activated. 🗣️
  • --baseurl url — the URL you're posting your data to. the default is literally https://contributors.debian.org/ so if you don't say anything, that's where it's going. 🏠
  • --source SOURCE — the name of your data source. gotta tell her who you are. 🌈
  • --auth-token AUTH_TOKEN — your authentication token, aka the little key that says "yes it's really me". pro move: if you use @file instead, she takes the contents of that file as the auth token. keep it secret, keep it safe. 🔐
  • --json — writes the JSON submission straight to standard output. no posting, just lookin'. 👀
  • --post — POST the contribution data to the site. this is the "actually send it" button. 🔥
  • --method method — the submission method, and it's gotta be one of exactly two things: 'replace' or 'extend'. pick your fighter. ⭐
  • --mine conffile — do the whole data mining thing using the config file you give her. ⛏️
  • --mine-documentation — prints out the data mining documentation in reStructuredText format, if you need the lore. 📜
quick reminder bestie: --post is the one that actually sends stuff to the site, so don't yeet that flag around unless you mean it. 💖

okay that's the whole page, you ate that. now go forth and contribute. 🎀

this was dc-tool version 0.7.11, dated January 2026 — thanks for reading, love u, bye 🦋💜

📦 where this page comes from