Skip to main content

LSST Data Management SQuaRE code management tools

Project description

[![Build Status](](

# sqre-codekit

LSST DM SQuaRE misc. code management tools

## Installation

sqre-codekit runs on Python 2.7 or 3.5. You can install it with

`bash pip install sqre-codekit `

This will also install dependencies: github3, urllib3, requests, progress and gitpython.

## Example usage

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

`bash github-auth -u {{username}} `

Or to generate a token with delete privileges:

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

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

`bash github-fork-repos -u {{username}} --org {{username}}-shadow `

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:

`bash github-delete-shadow -u {{username}} `

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.

## Available commands

  • github-auth: create a GitHub authentication token.
  • github-fork-repos: fork repositories into a shadow GitHub organization.
  • github-list-repos: list repositories in a GitHub organization, showing teams.
  • github-mv-repos-to-team: move repositories from one team to another.
  • github-tag-version: tag all repositories in a GitHub org using a team-based scheme.
  • lsst-bp: upgrade LSST DM code to [RFC-45](

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

## Development

To develop codekit, create a Python virtual environment, and

`bash 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

Tests can be run with [pytest](

`bash py.test 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 jmatt-sqre-codekit, version 2.1.0
Filename, size File type Python version Upload date Hashes
Filename, size jmatt_sqre_codekit-2.1.0-py3-none-any.whl (24.5 kB) File type Wheel Python version 3.6 Upload date Hashes View
Filename, size jmatt-sqre-codekit-2.1.0.tar.gz (16.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page