Skip to main content

switchbox

A collection of small tools for git workflows.

A screenshot displaying the output of 'switchbox finish'.

Installation

Clone the repository and install the package with pip.

pip install --user .

Usage

Invoke switchbox directly or run it via git switchbox.

Switchbox commands assume your git repository has a default branch and a default remote. When Switchbox is used for the first time (or you run switchbox setup) it will find and remember names for these.

  • The default branch will use a branch named main or master.
  • The default remote will use a remote named upstream or origin.

Switchbox options are set in a repository's .git/config file under a switchbox section.

switchbox config

Show config options that Switchbox has set.

switchbox config init

Detect a default branch and default remote, and save them to the repository's git configuration. This will be done automatically when you first use a command that works on a default branch or default remote.

switchbox config default-branch $branch

Change the default branch.

switchbox config default-remote $remote

Change the default remote.

switchbox finish [--update/--no-update]

  • Update all git remotes.
  • Update the local default branch to match the remote default branch.
  • Switch to the default branch.
  • Remove branches merged into the default branch.
  • Remove branches squashed into the default branch.

switchbox tidy [--update/--no-update]

  • Update all git remotes.
  • Remove branches merged into the default branch.
  • Remove branches squashed into the default branch.

switchbox update

  • Update all git remotes.

Release files for switchbox 0.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for switchbox 0.5.0
File Size Uploaded
switchbox-0.5.0.tar.gz 9.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for switchbox 0.5.0
File Interpreter ABI Platform
switchbox-0.5.0-py3-none-any.whl Python 3 none any Details

Total release size: 19.7 kB

Release files / switchbox-0.5.0.tar.gz

Download URL switchbox-0.5.0.tar.gz
Size 9.1 kB
Tags Source
SHA-256 checksum
How to use checksums
a7bc2efd8faf9554d02bcd66f12a9a644d2f7726a57c215b5aea183a400ea795
BLAKE2b-256 checksum
How to use checksums
3483acebc5662af26d5ce3ed0bfef7bde4b4d74825bab361b7858eec42287a42
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.7.1 CPython/3.12.3 Linux/6.8.9-300.fc40.x86_64

Release files / switchbox-0.5.0-py3-none-any.whl

Download URL switchbox-0.5.0-py3-none-any.whl
Size 10.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1283e153a733ef2870a2250f51fbf60673220d46b001a54bb2a92fc41bef2199
BLAKE2b-256 checksum
How to use checksums
88980593092d8f4ecbdae24fd3e52090670126222b83f570a76fa977bea6585d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.7.1 CPython/3.12.3 Linux/6.8.9-300.fc40.x86_64

Release history Release notifications | RSS feed

This release

0.5.0 This release

2 release files

0.4.0

2 release files

0.3.4

2 release files

0.3.1

2 release files

0.2.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page