DEP-14-CON...RANCH-NAMES(1)

💖 NAME 💖

dep-14-convert-git-branch-names — bestie, this one converts your git repository branch names so they follow DEP-14. That's it, that's the whole job. ✨

🌸 DESCRIPTION 🌸

Okay so picture this: you've got a Debian packaging repo and your branch names are a mess. This little helper tool swoops in and helps you rename them — not by doing anything itself (more on that in a sec, this is the iconic part), but by printing out the exact git commands you need for your local repository, plus the salsa commands for your remote repository, so you can rename the branches and update the default git branch. 🎀

Oh and it also prints the commands to create a gbp.conf with matching branch names, because of course it does, it's thorough like that. 💅

Here's the part that makes it chef's kiss: this script does not actually modify anything. Nothing. Zero. Nada. So bestie, feel free to run this script in any Debian packaging repository just to see what it outputs. It's giving "window shopping but for branch renames". 🦋

Now why do we even need this? Real talk: renaming is needed because git defaults to main as the branch name. Previously git used master, and git-buildpackage still used master as the branch name. And that is not ideal for Debian packaging, because if you use the same default development branch names that upstream projects typically do, you may end up with branch name conflicts. 😭 Messy. We don't do messy here.

DEP-14 (<https://dep-team.pages.debian.net/deps/dep14/>, status: candidate) says, and I quote:

In Debian this means that uploads to unstable and experimental should be prepared either in the debian/latest branch or respectively in the debian/unstable and debian/experimental branches.

and also:

The helper tools that do create those repositories should use a command like git symbolic-ref HEAD refs/heads/debian/latest to update HEAD to point to the desired branch.

See? It's all right there. DEP-14 said what it said. 👑

✨ SYNOPSIS ✨

dep-14-convert-git-branch-names [options]

🫶 Options

• --packaging-branch <name> — the branch for your main packaging, like for example 'debian/latest' 💖
• --debug — shows you debug information while it's running, for when you wanna see the behind-the-scenes 👀
• -h, --help — displays this help message, classic move 🌈
• --version — displays version information, so you know exactly what you're working with ⭐

🔥 SEE ALSO 🔥

• DEP-14: <https://dep-team.pages.debian.net/deps/dep14/>

okay that's the whole page bestie, go forth and rename those branches responsibly 💅✨

this was brought to you by the DEBIAN crew, filed under Debian Utilities — mwah, ily, take care of your HEAD refs 🎀💜