Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

LSST Data Management SQuaRE code management tools

Project description

Build Status


LSST DM SQuaRE misc. code management tools


sqre-codekit runs on Python 3.6 or newer. You can install it with

pip install sqre-codekit

Available commands

  • github-auth: Generate a GitHub authentication token.
  • github-decimate-org: Delete repos and/or teams from a GitHub organization.
  • github-fork-org: Fork repositories from one GitHub organization to another.
  • github-get-ratelimit: Display the current github ReST API request ratelimit.
  • github-list-repos: List repositories on Github using various criteria.
  • github-mv-repos-to-team: Move repo(s) from one team to another.
  • github-tag-release: Tag git repositories, in a GitHub org, that correspond to the products in a published eups distrib tag.
  • github-tag-teams: Tag the head of the default branch of all repositories in a GitHub org which belong to the specified team(s).

Use the --help flag with any command to learn more.

Example usage


To generate a personal user token (you will be prompted for your password):

github-auth -u {{username}}

Or to generate a token with delete privileges:

github-auth -u {{username}} --delete-role


To clone all repos into an GitHub organization called {{username}}-shadow:

github-fork-org \
    --dry-run \
    --debug \
    --src-org 'lsst' \
    --dst-org '{{username}}-shadow' \
    --token "$GITHUB_TOKEN" \
    --team 'DM Auxilliaries' \
    --team 'DM Externals' \
    --team 'Data Management' \

You'll need to create this shadow organization in advance. Working in a shadow organization is useful for testing.


If you want to take a recent fork, you will need to delete the existing shadow repos first:

github-decimate-org \
    --dry-run \
    --debug \
    --org 'example' \
    --token "$GITHUB_TOKEN" \
    --delete-repos \
    --delete-repos-limit 3 \
    --delete-teams \
    --delete-teams-limit 3

That requires a token with delete privileges.

To get more debugging information, set your DM_SQUARE_DEBUG variable before running any command, or use the -d debug flag on the command line.








To develop codekit, create a Python virtual environment, and

git clone
cd sqre-codekit
virtualenv venv
. venv/bin/activate
pip install -r requirements.txt
python develop

Note that all scripts (in codekit/cli) are installed using setuptools entry_points. See


Unit tests can be run with pytest:

python test


pytest tests

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for sqre-codekit, version 7.5.0
Filename, size File type Python version Upload date Hashes
Filename, size sqre_codekit-7.5.0-py3-none-any.whl (39.4 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size sqre-codekit-7.5.0.tar.gz (42.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page