Add a command to rename default branches

by metcalfc 6 years ago

GNU/Linux • xterm-256color • zsh 469 views

Describe the feature or problem you’d like to solve It takes at least three to five steps to rename the default branch of a repo. Some in the CLI and one that most users would use the GitHub UI for. But as I found the other day a few will find the a less documented CLI path for:

gh api -XPATCH “repos/:owner/:repo” -f default_branch=”$newbranch” >/dev/null This process isn’t new. There are blogs and gists all over.

https://www.hanselman.com/blog/EasilyRenameYourGitDefaultBranchFromMasterToMain.aspx https://gist.github.com/mislav/5ac69530acbe1b4ca909e272caabfdba All of this requires a lot from users: To search docs, download scripts, etc. Doing the right thing should be easier. I know GitHub is already working on a number of these changes internally. This just seems like another easy way to get something out that would have an impact quickly.

Proposed solution My proposal is to add a one stop shop for a rename tool. You already have a GitHub account if you’re using gh. There are a lot of repos out there to update. GitHub wants folks to use their new CLI. Here’s a good reason to download it. Make your life easier and the lives of others better.

Additional context I wanted to implement this to help me get through the repos I use. So I implemented something in my own fork. I used gh repo update though that probably isn’t what yall would want to do. I wasn’t sure where it would fit. Its not a simple update since it also does alter the local repo vs say just toggle the wiki or alter the description.

metcalfc@8b7cd75

There is a asciicast of the workflow here: https://asciinema.org/a/339953

More recordings by metcalfc

Allow for other branch names at repo create 0:29

by metcalfc 6 years ago

https://asciinema.org/a/339953

Copied!

Append ?t=30 to start the playback at 30s, ?t=3:20 to start the playback at 3m 20s.

See sharing docs for more link customization options.

Embed as image link

Use snippets below to display a preview image linking to this recording.
Ideal for places where scripts are not allowed, such as project README files.

HTML:

<a href="https://asciinema.org/a/339953" target="_blank"><img src="https://asciinema.org/a/339953.svg" /></a>

Copied!

Markdown:

[![asciicast](https://asciinema.org/a/339953.svg)](https://asciinema.org/a/339953)

Copied!

Embed the player

If you're embedding on your own page or on a site which permits script tags, you can use the full player widget:

<script src="https://asciinema.org/a/339953.js" id="asciicast-339953" async="true"></script>

Copied!

Paste the above script tag where you want the player to be displayed on your page.

See embedding docs for more player customization options.

You can download this recording in asciicast v2 format, as a .cast file.

Download

Replay in terminal

You can replay the downloaded recording in your terminal using the asciinema play command:

asciinema play 339953.cast

Copied!

If you don't have asciinema CLI installed then see installation instructions.

Use with stand-alone player on your website

Download asciinema player from the releases page (you only need .js and .css file), then use it like this:

<!DOCTYPE html>
<html>
<head>
  <link rel="stylesheet" type="text/css" href="/assets/asciinema-player.css" />
</head>
<body>
  <div id="player"></div>
  <script src="/assets/asciinema-player.min.js"></script>
  <script>
    // @license magnet:?xt=urn:btih:8e4f440f4c65981c5bf93c76d35135ba5064d8b7&dn=apache-2.0.txt Apache-2.0
    AsciinemaPlayer.create(
      '/assets/339953.cast',
      document.getElementById('player'),
      { cols: 120, rows: 30 }
    );
    // @license-end
  </script>
</body>
</html>

See asciinema player quick-start guide for full usage instructions.

While this site doesn't provide GIF conversion at the moment, you can still do it yourself with the help of asciinema GIF generator utility - agg.

Once you have it installed, generate a GIF with the following command:

agg https://asciinema.org/a/339953 demo.gif

Copied!

Or, if you already downloaded the recording file:

agg demo.cast demo.gif

Copied!

Check agg --help for all available options. You can change font family and size, select color theme, adjust speed and more.

See agg manual for full usage instructions.