DUB-UPGRADE(1)

📦
version 1.42.0 · 9 versions
, in arch rolling

💅 dub-upgrade — like, dub-upgrade(1), bestie ✨

okay so this is the dub-upgrade page from The D Language Foundation (section 1 of the manual, iykyk), and honestly? she's that girl. let's get into it 🎀

🌸 NAME 🌸

dub-upgrade — forces an upgrade of the dependencies 🔥

like. she will make it happen. no asking nicely.

🦋 SYNOPSIS 🦋

dub upgrade [<packages...>] OPTIONS...

that's it. that's the whole vibe check. packages optional, options always welcome 💖

✨ DESCRIPTION ✨

so basically dub-upgrade upgrades all the dependencies of the package by querying the package registry(ies) for new versions. plural registries. she's thorough like that 💅

and the way it works? it updates the versions stored in the selections file (dub.selections.json) accordingly. so like, the receipts get rewritten, fr fr.

if you name one or more packages, only those dependencies will get upgraded. otherwise? every single direct AND indirect dependency of the root package gets upgraded. all of them. no crumbs left behind 👑

💜 OPTIONS 💜

  • --prerelease — uses the latest pre-release version, even if release versions are available. living on the edge bestie 😭🙈
  • -s, --sub-packages — also upgrades dependencies of all directory based sub packages. she goes deep. yes ma'am 🫶
  • --verify — updates the project and performs a build. if successful, rewrites the selected versions file. and that's <to be implemented> btw — literally written like that in the docs, so like, don't come for me 💀
  • --dry-run — only prints what would be upgraded, but doesn't actually upgrade anything. window shopping. delulu but productive ✨
  • --missing-only — performs an upgrade only for dependencies that don't yet have a version selected. this is also done automatically before each build. so sneaky, so helpful 🎀
  • --force-remove — deprecated option that does nothing. she's just there. standing. iconic for no reason 🌸

🧚 COMMON OPTIONS 🧚

see dub(1). go read her too, she's the main character 🦋

💀 EXIT STATUS 💀

  • 0 — DUB succeeded. slay 🎉
  • 1 — usage errors, unknown command line flags. you did a whoopsie 😭
  • 2 — package not found, package failed to load, miscellaneous error. it's giving chaos, ngl 💅

🍓 FILES 🍓

  • dub.sdl, dub.json

those two. the whole personality. keep them safe 🙏

👑 AUTHOR 👑

Copyright (c) 1999-2026 by The D Language Foundation

look at that range. 1999 to 2026. generational 💖

🌈 ONLINE DOCUMENTATION 🌈

http://code.dlang.org/docs/commandline ⟨⟩

go click, bestie. absorb the knowledge ⭐

🔥 SEE ALSO 🔥

the mothership. the blueprint. go say hi 🫶

okay and finally, the cute little sign-off that lives at the bottom of the page — it's brought to you by The D Language Foundation, dated 2026-08-16, and that's the whole DUB-UPGRADE(1) moment. periodt. 💅✨🎀

📦 where this page comes from