dpt-forward(1)

📦
version 0.88 · 6 versions
, in ubuntu stonking

💖 dpt-forward(1) 💖

okay bestie, so this is dpt-forward, one of the little gems from the Debian Perl packaging Tools, and it does exactly one (1) job and it does it adorably: it forwards a bug or a patch upstream. like, from your Debian packaging world to the actual upstream project. no cap. 🦋

✨ NAME ✨

dpt-forward — forward a bug or a patch upstream 💅

🌸 SYNOPSIS 🌸

dpt forward [option...] path/to/some.patch [bug-number]
dpt forward [option...] bug-number [path/to/some.patch]

so you can put the patch first or the bug number first, the vibes are flexible, it'll figure itself out. periodt. ✨

🎀 OPTIONS 🎀

  • --dist name / -d name — the distribution name, girl. it gets determined from META, then the "Name" field in debian/upstream/metadata, then the "Homepage" field in the debian/control file, then the "Source" field in debian/copyright — in exactly that order, first hit wins, no takebacks. 👑
  • --force — normally dpt-forward checks whether the bug/patch is already forwarded upstream and just aborts if it is, like "ma'am we've been here". with this flag the check still happens, it just doesn't abort — it only issues a warning and keeps going. main character energy, honestly. 🔥
  • --meta file — tells it where the META file lives. defaults to META.json or META.yml in the current directory, whichever one it finds first.
  • --mode bug|patch / -m bug|patch — the mode of operation, and ngl you'll rarely need this one. it decides what your arguments mean: bug means the first argument is a bug number and the second is a patch file name, patch means the polar opposite. normally it figures this out from the first non-option argument and whether that thing looks like a bug number or a patch file name. it's giving mind reader. 🔮
  • --offline-test — every operation that needs the network gets swapped for stubs, so you can test offline. cozy. 🛋️
  • --ticket number — if you pass it, the info gets submitted to that ticket as an additional comment. if you don't pass it, a brand new ticket is created. 💌
  • --tracker name / -t name — the tracker the distribution uses. dpt forward currently supports cpan (<http://rt.cpan.org>) and github. the default comes from the "resources->bugtracker->web" field of META, and if that field isn't there, it's cpan. 🧚
  • --tracker-url url / -u url — the tracker URL to submit the info to. it's taken from the "resources->bugtracker->web" field of META or the "Bug-Database" field in debian/upstream/metadata. it defaults to "https://rt.cpan.org/Public/Dist/Display.html?Name=dist-name" for cpan, and for github it is mandatory — like, you must give it. 😤
  • --use-mail — send bug and patch submissions by e-mail instead of creating an issue or pull request via the API. heads up though: because the resulting ticket URL is not known to dpt forward, it cannot mark the patch and the bug as forwarded. 😭
  • --mailto address — sets the e-mail address to forward to. the default comes from the "resources->bugtracker->mailto" field of META, or the CPAN RT bug address if that field isn't present. 📧
  • --fallback — enables falling back to forwarding patches as bug reports whenever pull requests fail for any reason. defaults to false. 💀

💜 FILES 💜

  • ~/.pause — your pause credentials, bestie. you need at least user and password in order to create tickets on rt.cpan.org via the REST API. otherwise dpt forward falls back to email, which is slower and won't mark patches and bugs as forwarded. so like… do the credentials. 🙈

🌈 ENVIRONMENT 🌈

  • DPT_GITHUB_OAUTH — to do any github operations at all, DPT_GITHUB_OAUTH must be set. check out dpt-github-oauth(1) for how to get an access token for your github account, and dpt-config(5) for storing settings permanently in dpt.conf. ✨
  • DPT_GITHUB_ORGNAME — producing merge requests on github as a result of forwarding a patch requires that you belong to an organization that will own the cloned repositories from upstream. so you'll need some organization administrator to invite you — for instance by using dpt-invite-github(1). 🫶

for more details about tuning merge requests through environment variables and their defaults, please see Debian::PkgPerl::GitHub(1). 📚

⭐ SEE ALSO ⭐

Copyright 2016 Alex Muntada.

Copyright 2014 Salvatore Bonaccorso.

Copyright 2014 Damyan Ivanov.

Copyright 2011 Alessandro Ghedini.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See <http://dev.perl.org/licenses/> for more information.

and that's the whole page, bestie, literally all of it 💖 this was written for pkg-perl-tools version 0.88, dated 2026-04-01 — go forth and forward those patches, you absolute icon 🎀✨🦋

📦 where this page comes from