winton / gitcycle

Development cycle automation

Gitcycle

Development cycle automation.

About

Gitcycle is a git wrapper that makes working on a team easy.

It assumes you are using pull requests along side GitHub Issues.

It connects to email, Lighthouse, and Campfire if you want it to.

Get Started

Visit gitcycle.com to set up your repository.

gitc

The gitc command does everything git does, but with some extra features.

Try using gitc for everything. It should just work.

Branch From Ticket

First, checkout the branch that you will eventually merge your code into:

gitc checkout [BRANCH]

Type gitc branch + your ticket URL to create a new branch:

gitc branch https://xxx.lighthouseapp.com/projects/0000/tickets/0000-my-ticket

Pull

Use gitc pull without parameters. It knows what you're trying to do.

gitc pull

If you're working on a ticket branch, it will automatically pull the latest code from upstream.

Commit

Commit all changes and open commit message in EDITOR:

gitc commit

Ticket number and name are prefilled if present.

Push

Use gitc push without parameters. It knows what you're trying to do.

gitc push

Discuss

After pushing some commits, put the code up for discussion:

gitc discuss

Ready

When the branch is ready for code review:

gitc ready

This will label the pull request as "Pending Review".

Open

If you want to view the pull request without updating the ticket:

gitc open

Code Review

Periodically check for "Pending Review" issues on GitHub.

Pass

gitc review pass [GITHUB ISSUE #] [...]

Label the issue "Pending QA".

Fail

gitc review fail [GITHUB ISSUE #] [...]

Label the issue "Fail".

Quality Assurance

Periodically check for "Pending QA" issues on Github.

Create QA Branch

gitc qa [GITHUB ISSUE #] [...]

Now you have a QA branch containing all commits from the specified Github issue numbers.

Fail

gitc qa fail [GITHUB ISSUE #]

Label the issue with "Fail" and regenerate the QA branch without the failing issue.

Pass

gitc qa pass

Label all issues "Pass" and the merge the QA branch into target branch.

Immediate Pass

gitc checkout [TARGET BRANCH]
gitc qa pass [GITHUB ISSUE #] [...]

Immediately merge issue into the target branch.

Status

See who is QA'ing what:

gitc qa

Checkout

Check out an upstream or local branch:

gitc checkout [BRANCH]

From Ticket

Checkout a branch from a ticket URL:

gitc checkout [TICKET URL]

From Ticket Number

Checkout a branch from a ticket #:

gitc checkout [TICKET NUMBER]

From User's Fork

gitc checkout user/branch

Todo

Nice to haves:

• gitc branch [lh]

• gitc branch [gitissue]

• gitc ready # switch me back to rc or master

• gitc ready - issue already closed, will open a new issue

• Conflict recording not working

• gitc qa pass [issue] should use a qa_rc_tongueroo_temp branch so it doesnt blow away the changes in the qa_rc_tongueroo branch

  • not working : https://gist.github.com/819c99281f5d6492de47

• gitc qa pass (all), doesnt update lighthouse to state pending-approval

• Collaborator mode = work on same ticket, gitc ready readys ticket no matter who is working on it, if more than one ticket then we should have a feature branch that people are basing tickets off of

• Hook to run after gitc qa pass, so I can write a script for amit that will auto merge master into rc

• Issues aren't assigned to people

• On pass or fail, send email to Github email

• Note you can use gitc with a string (and get this working)

• gitc qa pass, should not set ticket to pending-approval if its already resolved

• Everything before colon in ticket name, make shorter somehow $ gitc st - shortcut

• gitc clean # to clean up old branches

• fail should change to inactive

• gitc pull: shouldnt matter who does it, it should update the latest br/rc, not working https://gist.github.com/22b1e248e8dba7a32288

gitcycle's Issues

Warning message when committing a deletion

FYI, I got this message when my commit contained a deletion:

gitc commit

Retrieving branch information from gitcycle.

Transaction ID: zzfxqawxwhfnwpvgjyoz
warning: You ran 'git add' with neither '-A (--all)' or '--ignore-removal',
whose behaviour will change in Git 2.0 with respect to paths you removed.
Paths like 'app/views/facebook_promos/popup_country.html.erb' that are
removed from your working tree are ignored with this version of Git.

• 'git add --ignore-removal ', which is the current default,
  ignores paths you removed from your working tree.
• 'git add --all ' will let you also record the removals.

Run 'git status' to check the paths you removed from your working tree.

[rc-13830-conversion-promo-admin 5cc0452] International pages share route/view and take precendence. [#13830] Conversion: promo admin not working for league/swagger pages
6 files changed, 28 insertions(+), 37 deletions(-)
delete mode 100644 app/views/facebook_promos/popup_country.html.erb

License missing from gemspec

RubyGems.org doesn't report a license for your gem. This is because it is not specified in the gemspec of your last release.

via e.g.

spec.license = 'MIT'
# or
spec.licenses = ['MIT', 'GPL-2']

Including a license in your gemspec is an easy way for rubygems.org and other tools to check how your gem is licensed. As you can image, scanning your repository for a LICENSE file or parsing the README, and then attempting to identify the license or licenses is much more difficult and more error prone. So, even for projects that already specify a license, including a license in your gemspec is a good practice. See, for example, how rubygems.org uses the gemspec to display the rails gem license.

There is even a License Finder gem to help companies/individuals ensure all gems they use meet their licensing needs. This tool depends on license information being available in the gemspec. This is an important enough issue that even Bundler now generates gems with a default 'MIT' license.

I hope you'll consider specifying a license in your gemspec. If not, please just close the issue with a nice message. In either case, I'll follow up. Thanks for your time!

Appendix:

If you need help choosing a license (sorry, I haven't checked your readme or looked for a license file), GitHub has created a license picker tool. Code without a license specified defaults to 'All rights reserved'-- denying others all rights to use of the code.
Here's a list of the license names I've found and their frequencies

p.s. In case you're wondering how I found you and why I made this issue, it's because I'm collecting stats on gems (I was originally looking for download data) and decided to collect license metadata,too, and make issues for gemspecs not specifying a license as a public service :). See the previous link or my blog post aobut this project for more information.

http://gitcycle.com seems to be parked

It was parked when I checked a few weeks ago and still seems to be parked.