v1gittools 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e07221ee4155c7323cc3eeaf864e4a6db17d6aeb
+  data.tar.gz: e86cfcba657a41c90e5ec8f001d946432b0b6b1c
+SHA512:
+  metadata.gz: 93d58ced68b07ca92cec63749b18e19ed017c9f39e8c31665dd07f098db6df345b43ed408ce02c67eb4f4cee6546b9296d7f5156ce27c46c3938b62d7bda1733
+  data.tar.gz: 526ae7d0c7718f1150da48623d0ba09f8748b46d25bb18b40127b14d52177190ffa15d2b08ae57dbd656b785e220888cef3e5b709463b213e23b3c51a6ab7d95

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/.idea

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.2.4
+before_install: gem install bundler -v 1.12.5

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,49 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, and in the interest of
+fostering an open and welcoming community, we pledge to respect all people who
+contribute through reporting issues, posting feature requests, updating
+documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free
+experience for everyone, regardless of level of experience, gender, gender
+identity and expression, sexual orientation, disability, personal appearance,
+body size, race, ethnicity, age, religion, or nationality.
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery
+* Personal attacks
+* Trolling or insulting/derogatory comments
+* Public or private harassment
+* Publishing other's private information, such as physical or electronic
+  addresses, without explicit permission
+* Other unethical or unprofessional conduct
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+By adopting this Code of Conduct, project maintainers commit themselves to
+fairly and consistently applying these principles to every aspect of managing
+this project. Project maintainers who do not follow or enforce the Code of
+Conduct may be permanently removed from the project team.
+
+This code of conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting a project maintainer at jchan@malwarebytes.org. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. Maintainers are
+obligated to maintain confidentiality with regard to the reporter of an
+incident.
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 1.3.0, available at
+[http://contributor-covenant.org/version/1/3/0/][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/3/0/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in v1gittools.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Jonathan Chan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,157 @@
+# V1GitTools
+
+VersionOne Git tool integrates VersionOne Story/Defect statuses with git branches and github PRs. The result encourages developers to only make code changes based off of stories and defects promoting better tracking for projects. v1git is roughly based off of git flow, though it should be flexible enough to be used in other workflows.
+### Screencast Tutorial
+* [Setting up VersionOne Project for V1GitTools](https://malwarebytes.box.com/shared/static/m67wyc7tgctgz2pfdzdl9z20kwl3oudw.mov)
+* [V1GitTools Demo & How To Setup](https://malwarebytes.box.com/shared/static/v2arkjgut0e7e3rt04p1mfmkj89p2cqc.mov)
+
+## VersionOne Prerequisites
+
+```v1git``` is designed for an environment where after code is written, testers or QA runs the code and verifies that it meets the requirement. In order for VersionOne to support that flow, an additional story status of "Test" must be created. The following resources are useful for setting up the "Test" status and adding it to the storyboard workflow.
+
+    https://community.versionone.com/Help-Center/Portfolio_Planning/Portfolio_Kanban/Working_with_Portfolio_Kanbans#Changing_Columns
+    https://community.versionone.com/Help-Center/Setup_and_Administration/List_Type_Administration
+
+
+
+## Installation
+
+### Installing it via Rubygems 
+
+    $ gem install v1gittools
+
+### Or Without Rubygems Install
+
+
+```
+gem install specific_install
+gem specific_install https://github.com/Malwarebytes/v1gittools.git master
+```
+
+
+## Setup
+
+Copy ```v1git.conf.example``` to ```~/.v1git.conf```. Please refer to the example file for details on each parameter that needs to be set.
+
+## Usage
+
+Demonstration of workflow:
+
+### Initialize
+
+When you start a new project with v1git, run:
+
+```shell
+$ v1git init
+NOTICE: v1git has never been used for this project before. Generating default config...
+
+Config generated with the following guessed/assumed values:
+
+Develop branch: develop
+github_url: https://github.com/acme/cool_project
+
+github_owner: acme
+
+github_repo: cool_project
+
+If these values are not correct, please correct it in "~/code/cool_project/.git/v1git.conf".
+
+Running validations... (if any of these fail, run 'exec/v1git validate' after correcting the issue.)
+Validating VersionOne URL... PASSED
+Validating VersionOne credentials... PASSED
+Validating git config... PASSED
+Validating github endpoint... PASSED
+Validating github credentials...PASSED
+```
+
+If there are any issues with the setup, please correct and verify all settings are correct.
+
+### Develop
+
+Stories/Defects are created and added to the current sprint. They will be in the "None" column in the TeamRoom Storyboard.
+
+![Story in None](doc_assets/none.png "Story in None")
+
+When beginning work on a story/defect, identify the story or defect ID. ```B-10147``` in our example. Run the following command:
+
+```shell
+$ v1git develop B-10147 more_widgets # optional branch name; if branch name not included, defaults to story/defect ID
+
+ - Switched to a new branch 'more_widgets' based off of 'develop'.
+ - Set B-10147 to the status In Progress.
+
+Implement story/defect in branch (Don't forget to push!). When complete, use:
+
+     v1git qa
+
+
+```
+
+![Story in In Progress](doc_assets/in_progress.png "Story In Progress")
+
+The story is put into "In Progress" and the git repository is put into a state ready to be worked on.
+
+### QA
+
+After making the necessary commit(s) to satsify the defect/story requirements, v1git can be used to move the story into "Test" status.
+
+```shell
+$ v1git qa
+ - Created PR for this branch (complete creating PR in browser).
+ - Set 'Build' field in story to 'more_widgets'.
+ - Set B-10147 to the status QA.
+```
+
+A Pull Request dialog box will be opened up for allowing other developers to review the code. QA testers can refer to the 'Build' field in the story to know which branch to refer to when testing the code. The story/defect is moved into the "test" column.
+
+![Story in Test](doc_assets/qa.png "Story in Test")
+
+
+The next steps after this are out of the scope of v1git tool. Testers must verify that the code meets the requirements. Other developers must peer review the Pull Request. Once QA signs off on the story meeting the requirements and the developers have approved and merged the Pull Request, the story can manually moved to "Done".
+
+### Changelog
+
+At the end of the sprint, when the stories/defects are all "Done" and merged into the develop branch, a release branch can be created. This branch can be deployed to a staging area and viewed by the stakeholders or the product owner during the end of sprint demo. When the stories meet the stakeholders/product owner's expectation, the story can be promoted to "Approved".
+
+v1git can generate a changelog of defects and stories that have been merged into the release branch.
+
+```shell
+# creating release branch
+$ git checkout develop
+$ git pull
+$ git checkout -b release/1.10.0
+$ v1git changelog 1.9.0 release/1.10.0
+[No Story ID] - Added logging system. - PR #123
+[B-10147] - Testing1 (https://www14.v1host.com/v1sdktesting/story.mvc/Summary?oidToken=Story%3A37879&RoomContext=TeamRoom%3A37878) - PR #124 
+```
+
+This changelog can be used in release notes or to distribute to the stakeholders/product owner to quickly see what was implemented and what was not.
+
+Finally, release can be merged into master, a tag can be created and master can be merged back into develop.
+
+```
+$ git checkout master
+$ git merge --no-ff release/1.10.0
+$ git tag -a 1.10.0 # you can place the changelog in the annotations of the tagged version
+$ git checkout develop
+$ git merge --no-ff master
+$ git push --all
+```
+
+
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/malwarebytes/v1gittools. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "v1gittools"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/exec/v1git

@@ -0,0 +1,52 @@
+#!/usr/bin/env ruby
+
+#require 'bundler/setup'
+require 'thor'
+require 'v1gittools'
+include V1gittools
+
+
+# for dev purposes
+Dir.chdir(ENV['v1git_cwd']) if ENV['v1git_cwd']
+
+class V1git < Thor
+  option :title, :type => :string, :banner => 'v1|git', :aliases => :t, desc: '"git" or "versionone" title, defaults to v1 title [v1,git]'
+  desc 'changelog start end', 'Generates a changelog of merged PRs with VersionOne tags'
+  def changelog(start_snapshot, end_snapshot)
+    tool = ChangeLogTool.new options
+    tool.generate_changelog(start_snapshot,end_snapshot)
+  end
+
+  desc 'develop v1_story_id [branch_name]', 'Move a v1 story into "in-progress" and start a new branch off of develop. If branch is not specified, defaults to story id name'
+  def develop(v1_story_id, branch_name = nil)
+    tool = DevelopStoryTool.new
+    tool.develop(v1_story_id,branch_name)
+  end
+
+  desc 'qa', 'Moves the current story/branch to "In-Test" and creates a PR in github'
+  def qa
+    tool = QATool.new
+    tool.qa
+  end
+
+
+  desc 'init', 'Initializes repo settings for v1git'
+  def init
+    V1gittools::generate_repo_config V1gittools::repo_config_path
+    V1gittools::initialize_github
+
+    puts "Running validations... (if any of these fail, run '#{$0} validate' after correcting the issue.)"
+    V1gittools::validate_config
+  end
+
+  desc 'validate', 'Validates config and connections and verifies if everything works.'
+  def validate
+    V1gittools::validate_config
+
+    puts "All validations pass! You're ready to run v1git on your project!"
+  end
+end
+
+
+
+V1git.start(ARGV)

data/lib/v1gittools.rb

@@ -0,0 +1,12 @@
+require 'v1gittools/version'
+require 'v1gittools/config'
+require 'v1gittools/base_tool'
+require 'v1gittools/change_log_tool'
+require 'v1gittools/develop_story_tool'
+require 'v1gittools/qa_tool'
+require 'git'
+require 'github_api'
+require 'versionone_sdk'
+
+module V1gittools
+end

data/lib/v1gittools/base_tool.rb

@@ -0,0 +1,25 @@
+module V1gittools
+  class BaseTool
+    attr_reader :v1, :git, :args, :config, :repo_config, :github
+
+    def initialize args=nil
+      @args = args
+
+
+      @config = V1gittools::config
+      check_proper_init
+      @repo_config = V1gittools::repo_config
+      git_root_path = `git rev-parse --show-toplevel`.strip
+      @git = Git.open(git_root_path)
+      @v1 = VersiononeSdk::Client.new(@config[:v1config])
+      @github = Github.new(Hash[@config[:github].map{ |k, v| [k.to_sym, v] }])
+    end
+
+    def check_proper_init
+      if @config[:github] && @config[:github][:oauth_token] == 'AUTOGENERATE'
+        puts "v1git has not been setup for this repository yet. Please run #{$0} init to initialize and setup v1git."
+        exit
+      end
+    end
+  end
+end

data/lib/v1gittools/change_log_tool.rb

@@ -0,0 +1,49 @@
+module V1gittools
+  class ChangeLogTool < V1gittools::BaseTool
+
+    def generate_changelog (start_snapshot, end_snapshot)
+      @git.log(999999).between(start_snapshot,end_snapshot).each do |commit|
+        if match = commit.message.match(/Merge pull request (#\d+) from ((.*?)\n\n([^\n]*).*)/m)
+          pr_id, full_message, branch_name, pr_title = match.captures
+
+          # puts "pr_id = #{pr_id}"
+          # puts "branch_name = #{branch_name}"
+          # puts "pr_title = #{pr_title}"
+          # puts "full_message = #{full_message}"
+          prefixes = @config[:v1config][:type_prefixes].keys.join('|')
+          stories = full_message.scan(/\b([#{prefixes}]-\d{4,6})\b/m)
+          v1_stories = {}
+
+          stories.each do |story_array|
+            story = story_array[0]
+
+            v1_stories[story] = @v1.getAsset(story)
+          end
+
+          v1_stories.each do |story_id, v1_story|
+            if v1_story.nil?
+              v1_title = 'Cannot Find Story in V1!'
+              v1_url = ''
+
+              puts "WARNING: Cannot Find Story [#{story_id}] in V1!"
+            else
+              v1_title = v1_story.getProp('Name')
+              v1_url = "https://#{config[:v1config][:hostname]}/#{config[:v1config][:instance]}/story.mvc/Summary?oidToken=#{v1_story.getProp(:_sObjectType__id)}:#{v1_story.getProp(:_iObjectId__id)}"
+            end
+
+            if @args[:title] == 'git'
+              title = pr_title
+            else
+              title = v1_title
+            end
+            puts "[#{story_id}] - #{title} (#{v1_url}) - PR #{pr_id} "
+          end
+
+          if v1_stories.empty?
+            puts "[No Story ID] - #{pr_title} - PR #{pr_id}"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/v1gittools/config.rb

@@ -0,0 +1,241 @@
+require 'json'
+require 'yaml'
+require 'v1gittools/deep_hash_with_indifferent_access'
+require 'socket'
+require 'faraday'
+require 'io/console'
+
+module V1gittools
+  @config = nil
+  def self.config
+    if @config.nil?
+      # load config from file
+      load_config_file
+    end
+
+    @config
+  end
+
+  def self.default_config_file
+    '~/.v1git.conf'
+  end
+
+  def self.load_config_file filename=nil
+    filename = V1gittools::default_config_file if filename.nil?
+    filename = File.expand_path(filename)
+    unless File.exists?(filename)
+      raise "Config file #{filename} must exist and be properly configured before running this tool! Please refer to v1git.conf.example."
+    end
+
+    @config = DeepHashWithIndifferentAccess.convert_hash(YAML::load(File.open(filename)))
+  end
+
+  @repo_config = nil
+  def self.repo_config
+    if @repo_config.nil?
+      load_repo_config
+    end
+
+    @repo_config
+  end
+
+  @repo_config_path = nil
+  def self.repo_config_path
+    if @repo_config_path.nil?
+      git_root_path = `git rev-parse --show-toplevel`.strip
+      raise git_root_path if $?.to_i != 0
+      @repo_config_path = git_root_path + '/.git/v1git.conf'
+    end
+
+    @repo_config_path
+  end
+
+  def self.load_repo_config
+    config_path = repo_config_path
+
+    unless File.exists?(config_path)
+      puts "v1git has not been setup for this repository yet. Please run #{$0} init to initialize and setup v1git."
+      exit
+    end
+
+    @repo_config = DeepHashWithIndifferentAccess.convert_hash(YAML::load(File.open(config_path)))
+  end
+
+  def self.generate_repo_config config_path
+    return if File.exists?(config_path)
+    puts "NOTICE: v1git has never been used for this project before. Generating default config...\n\n"
+
+    `git status`
+    if $?.to_i == 128
+      puts "Your current working directory isn't even a git repository! Goodbye!"
+      exit
+    end
+
+    # guessing github address from git remote origin url
+    git_remote_url = `git config --get remote.origin.url`.strip
+
+    if git_remote_url.start_with?('http')
+      # http connection is easy!
+      github_url=git_remote_url.chomp('.git')
+
+    elsif git_remote_url.start_with?('git')
+      github_host, github_project_uri = git_remote_url.match(/git@(.+?):(.+?)\.git/).captures
+      github_url = "https://#{github_host}/#{github_project_uri}"
+    else
+      github_url=''
+    end
+    url_parts = github_url.split('/')
+    github_repo = url_parts.pop
+    github_owner = url_parts.pop
+
+    default_config_hash = {
+        github_url: github_url,
+        github_owner: github_owner,
+        github_repo: github_repo,
+        develop_branch: 'develop',
+        github_remote: 'origin',
+        branches: {}
+    }
+
+    write_repo_config(config_path,default_config_hash)
+
+    if github_url == ''
+      raise "ERROR: Couldn't guess github config options. Please modify github config options manually in '#{config_path}'"
+    else
+      puts "Config generated with the following guessed/assumed values:\n\n"
+      puts "Develop branch: #{default_config_hash[:develop_branch]}"
+      puts "github_url: #{github_url}\n\n"
+      puts "github_remote: #{default_config_hash[:github_remote]}\n\n"
+      puts "github_owner: #{github_owner}\n\n"
+      puts "github_repo: #{github_repo}\n\n"
+      puts "If these values are not correct, please correct it in \"#{config_path}\".\n\n"
+    end
+  end
+
+  def self.update_repo_config
+    write_repo_config(V1gittools::repo_config_path, @repo_config)
+  end
+
+  def self.write_repo_config config_path, config_hash
+    File.open(config_path,'w') do |f|
+      f.write("# This file is autogenerated and updated by v1git! Comments and formatting will be lost!\n\n")
+      f.write(config_hash.to_yaml)
+    end
+  end
+
+  def self.initialize_github
+    if config[:github] && config[:github][:oauth_token] == 'AUTOGENERATE'
+      print 'V1git requires a github access token for creating PRs. We will be requesting github for an access token'
+      puts 'using your credentials. This will only be a one time operation.'
+      if config[:github] && config[:github][:endpoint]
+        endpoint = config[:github][:endpoint]
+        puts "\nV1Git is configured to connect to: #{endpoint}\n"
+      else
+        endpoint = nil
+        puts "\nV1Git is configured to connect to: api.github.com\n\n"
+      end
+
+
+      print "\nGithub Username: "
+      username = STDIN.gets.chomp
+      print "Github Password (no echo): "
+      password = STDIN.noecho(&:gets).chomp
+      puts "\nAutogenerating github repo authtoken with #{username} credentials..."
+
+
+
+      gh = Github.new basic_auth: "#{username}:#{password}", endpoint: endpoint
+      token = gh.oauth.create scopes: ['repo'], note: "v1gittools token for computer #{Socket.gethostname}"
+
+
+      # load the file as a string
+      config_data = File.read(File.expand_path(default_config_file))
+      # globally substitute "install" for "latest"
+      filtered_data = config_data.gsub(/oauth_token: *"AUTOGENERATE"/, "oauth_token: \"#{token.token}\"")
+      # open the file for writing
+      File.open(File.expand_path(default_config_file), "w") do |f|
+        f.write(filtered_data)
+      end
+
+      @config = nil # need to force reload of the config params after writing to it.
+
+      puts "Credential generated and written to #{default_config_file} config file."
+    end
+  end
+
+  def self.validate_config
+    # write some checks here to make sure that
+    # - v1 works
+    response = Faraday.get "https://#{config[:v1config][:hostname]}/#{config[:v1config][:instance]}/Account.mvc/LogIn"
+
+    if response.status == 200
+      puts 'Validating VersionOne URL... PASSED'
+    else
+      puts 'Validating VersionOne URL... FAILED'
+      puts 'Please verify that the VersionOne (v1config block) hostname and instance is correct.'
+      exit
+    end
+
+    print 'Validating VersionOne credentials... '
+    response = VersiononeSdk::Client.new(config[:v1config]).getAssets('State') # run a test query
+
+    if response.empty?
+      puts 'FAILED'
+      puts 'Please validate that the VersionOne credentials is correct (you may need to regenerate a new token).'
+    else
+      puts 'PASSED'
+    end
+
+
+
+    # - git works
+    `git status`
+    if $?.to_i == 128
+      puts 'Validating git config... FAILED'
+      puts "Your current working directory isn't even a git repository! Please make sure you're in the correct directory."
+      exit
+    else
+      puts 'Validating git config... PASSED'
+    end
+
+    # - github works
+    print 'Validating github endpoint... '
+    response = Faraday.get config[:github][:endpoint]
+    begin
+      json_response = JSON.parse(response.body)
+    rescue
+      puts 'FAILED'
+      puts 'Please verify that github[:endpoint] config option is set correctly. Could not contact github.'
+      exit
+    end
+
+    if json_response['message'] == 'Must authenticate to access this API.' || json_response['current_user_url'] != nil
+      puts 'PASSED'
+    else
+      puts 'FAILED'
+      puts 'Please verify that github[:endpoint] config option is set correctly. Could not contact github.'
+      exit
+    end
+
+    print 'Validating github credentials...'
+    github = Github.new(Hash[config[:github].map{ |k, v| [k.to_sym, v] }])
+    begin
+      response = github.pull_requests.list(repo_config[:github_owner], repo_config[:github_repo])
+    rescue ArgumentError
+      puts 'FAILED'
+      puts "Please verify that github_owner and github_repo in #{repo_config_path} is set."
+      exit
+    rescue Github::Error::NotFound
+      puts 'FAILED'
+      puts 'Please verify that your github endpoint and credentials are correct:'
+      puts ' - Did you put github.com creds when you meant to use github enterprise creds or visa versa?'
+      exit
+    rescue Github::Error::Unauthorized
+      puts 'FAILED'
+      puts "Please verify that the github oauth configuration setting is set correctly in #{default_config_file}"
+      exit
+    end
+
+    puts 'PASSED'
+  end
+end

data/lib/v1gittools/deep_hash_with_indifferent_access.rb

@@ -0,0 +1,41 @@
+require 'thor/core_ext/hash_with_indifferent_access'
+# A hash with indifferent access and magic predicates.
+#
+#   hash = Thor::CoreExt::HashWithIndifferentAccess.new 'foo' => 'bar', 'baz' => 'bee', 'force' => true
+#
+#   hash[:foo]  #=> 'bar'
+#   hash['foo'] #=> 'bar'
+#   hash.foo?   #=> true
+#
+module V1gittools
+  class DeepHashWithIndifferentAccess#:nodoc:
+    #HashWithIndifferentAccess does not convert the hash deeply so we must do this ourselves :(
+    def self.convert_hash(hash)
+      new_hash = Thor::CoreExt::HashWithIndifferentAccess.new
+      hash.each do |key, value|
+        if value.is_a? Hash
+          new_hash[key] = convert_hash value
+        elsif value.is_a? Array
+          new_hash[key] = convert_array value
+        else
+          new_hash[key] = value
+        end
+      end
+      new_hash
+    end
+
+    def self.convert_array(arr)
+      new_array = []
+      arr.each do |value|
+        if value.is_a? Hash
+          new_array << (convert_hash value)
+        elsif value.is_a? Array
+          new_array << (convert_array value)
+        else
+          new_array << value
+        end
+      end
+      new_array
+    end
+  end
+end

data/lib/v1gittools/develop_story_tool.rb

@@ -0,0 +1,28 @@
+module V1gittools
+  class DevelopStoryTool < V1gittools::BaseTool
+
+    def develop(v1_story_id, branch_name=nil)
+      branch_name ||= v1_story_id
+      v1_story = v1.getAsset(v1_story_id.dup)
+      if v1_story.nil?
+        puts "Sorry, story/defect #{v1_story_id} not found! Can't start development on unknown story/defect!"
+        return
+      end
+
+      git.checkout(repo_config[:develop_branch])
+      git.pull(repo_config[:github_remote], repo_config[:develop_branch])
+      git.branch(branch_name).checkout
+
+      repo_config[:branches][branch_name] = v1_story_id
+      V1gittools::update_repo_config
+      v1.updateAsset(v1_story.getProp(:_sObjectType__id), v1_story.getProp(:_iObjectId__id),'Status', config[:v1_story_statuses][:develop])
+
+      v1_story = v1.getAsset(v1_story_id.dup)
+
+      puts " - Switched to a new branch '#{branch_name}' based off of '#{repo_config[:develop_branch]}'."
+      puts " - Set #{v1_story_id} to the status #{v1_story.getProp(:"Status.Name")}.\n\n"
+      puts "Implement story/defect in branch (Don't forget to push!). When complete, use:\n\n"
+      puts "     v1git qa\n\n"
+    end
+  end
+end

data/lib/v1gittools/qa_tool.rb

@@ -0,0 +1,62 @@
+require 'launchy'
+module V1gittools
+  class QATool < V1gittools::BaseTool
+    def qa
+      branch = git.current_branch
+      v1_story_id = repo_config[:branches][branch.to_sym]
+
+
+      if v1_story_id.nil?
+        puts "This branch was not created with v1git tool. Cannot send this branch/story to QA."
+        return
+      end
+      v1_story = v1.getAsset(v1_story_id.dup)
+      if v1_story.nil?
+        puts "Sorry, story/defect #{v1_story_id} not found! Can't mark story for QA! Was the story deleted?"
+        return
+      end
+
+      if v1_story.asHash.keys.include?(:FixedInBuild)
+        build_field = 'FixedInBuild'
+      else
+        build_field = 'LastVersion'
+      end
+
+      v1.updateAsset(v1_story.getProp(:_sObjectType__id), v1_story.getProp(:_iObjectId__id),'Status', config[:v1_story_statuses][:test])
+      v1.updateAsset(v1_story.getProp(:_sObjectType__id), v1_story.getProp(:_iObjectId__id),build_field,branch)
+
+      v1_story = v1.getAsset(v1_story_id.dup)
+
+      begin
+        pr = @github.pull_requests.create(repo_config[:github_owner], repo_config[:github_repo],
+          {
+            title: "[#{v1_story_id}] #{v1_story.getProp(:Name)}",
+            body: "https://#{config[:v1config][:hostname]}/#{config[:v1config][:instance]}/story.mvc/Summary?oidToken=#{v1_story.getProp(:_sObjectType__id)}:#{v1_story.getProp(:_iObjectId__id)}",
+            head: branch,
+            base: repo_config[:develop_branch]
+        })
+        puts " - Created PR for this branch (PR ##{pr.number})."
+      rescue Github::Error::UnprocessableEntity => e
+        ## TODO: Need to change all these errors to use error_messages instead of trying to analyze it manually.
+        if e.error_messages.include?({:resource=>"PullRequest", :code=>"custom", :message=>"No commits between develop and add_truth_statements"})
+          puts "Cannot create Pull Request! There have been no changes between #{branch} and #{repo_config[:develop_branch]}. Did you forget to commit your code?"
+          exit
+        elsif e.to_s.include?('field: head, code: invalid')
+          puts "Branch '#{branch}' does not exist on github. Did you forget to `git push`? Cannot create PR!"
+          exit
+        elsif e.to_s.include?('A pull request already exists for')
+          puts " - Pull Request for branch '#{branch}' already exists. Skipped creating PR."
+        else
+          raise e
+        end
+      end
+
+
+
+      puts " - Set 'Build' field in story to '#{branch}'."
+      puts " - Set #{v1_story_id} to the status '#{v1_story.getProp(:"Status.Name")}'.\n\n"
+
+      Launchy.open(pr.html_url) if pr
+    end
+  end
+end

data/lib/v1gittools/version.rb

@@ -0,0 +1,3 @@
+module V1gittools
+  VERSION = "0.1.1"
+end

data/v1git.conf.example

@@ -0,0 +1,46 @@
+v1config:
+  # The following is taken from the url of your v1 instance
+  # eg. https://www14.v1host.com/v1sdktesting/Default.aspx
+  hostname: 'www14.v1host.com'
+  instance: 'v1sdktesting'
+  
+  # we can either use username/password or access_token - access_token is preferred
+  #username: ''
+  #password: ''
+
+  # You can get the access_token by mousing over your name in the upper-right 
+  # corner of v1 and clicking "Applications". A dialog will walk you through
+  # generating an access_token.
+  access_token: ''
+
+  # probably do not need to change this.
+  type_prefixes:
+    D: 'Defect'
+    B: 'Story'
+  port: 443
+  protocol: 'https'
+v1_story_statuses:
+  # go to #{YOURHOST}/rest-1.v1/Data/StoryStatus ie. 
+  # https://www14.v1host.com/v1sdktesting/rest-1.v1/Data/StoryStatus
+  # to find the story status IDs for your v1 account.
+  # 'test' status probably won't be setup by default in your versionone
+  # account. You may need to have to add a column in kanban:
+  # https://community.versionone.com/Help-Center/Portfolio_Planning/Portfolio_Kanban/Working_with_Portfolio_Kanbans#Changing_Columns
+  # https://community.versionone.com/Help-Center/Setup_and_Administration/List_Type_Administration
+  # Story Status to set when running `v1git develop`
+  develop: 'StoryStatus:134' # In Progress
+  # Story status to set when running `v1git qa`
+  test: 'StoryStatus:1073' # In Test
+github:
+  # If you're using github enterprise, point this to your domain name
+  # Typically, you'll need to add /api/v3 to it. Eg.
+  # https://github.mydomain.com/api/v3/
+  endpoint: https://api.github.com
+
+  # Auth token used to access github. Leave this as "AUTOGENERATE" to have v1git create one for you. The auth token
+  # needs to have permission to read/write code in repos
+
+  # if you use 2FA, you will need to generate the auth_token yourself. Please follow
+  # https://help.github.com/articles/creating-an-access-token-for-command-line-use/
+  # make sure to check "repo" permissions
+  oauth_token: "AUTOGENERATE"

data/v1gittools.gemspec

@@ -0,0 +1,40 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'v1gittools/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'v1gittools'
+  spec.version       = V1gittools::VERSION
+  spec.authors       = ['Jonathan Chan']
+  spec.email         = ['jchan@malwarebytes.org']
+
+  spec.summary       = %q{VersionOne/Git/Github Integration tools}
+  spec.description   = %q{Tool(s) to integrate the VersionOne project managemente system with git/github developer workflow.}
+  spec.homepage      = 'http://malwarebytes.org'
+  spec.license       = 'MIT'
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata['allowed_push_host'] = "https://rubygems.org"
+  else
+    raise 'RubyGems 2.0 or newer is required to protect against public gem pushes.'
+  end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'exec'
+  spec.executables   = spec.files.grep(%r{^exec}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_runtime_dependency 'git', '~> 1.3.0'
+  spec.add_runtime_dependency 'versionone_sdk', '~>0.2'
+  spec.add_runtime_dependency 'thor', '~> 0.19'
+  spec.add_runtime_dependency 'launchy', '~> 2.4', '>= 2.4.3'
+  spec.add_runtime_dependency 'github_api', '~> 0.14.4'
+
+
+  spec.add_development_dependency 'bundler', '~> 1.12'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+end

metadata

@@ -0,0 +1,189 @@
+--- !ruby/object:Gem::Specification
+name: v1gittools
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Jonathan Chan
+autorequire: 
+bindir: exec
+cert_chain: []
+date: 2016-08-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: git
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+- !ruby/object:Gem::Dependency
+  name: versionone_sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+- !ruby/object:Gem::Dependency
+  name: launchy
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.4.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.4.3
+- !ruby/object:Gem::Dependency
+  name: github_api
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.4
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Tool(s) to integrate the VersionOne project managemente system with git/github
+  developer workflow.
+email:
+- jchan@malwarebytes.org
+executables:
+- v1git
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- doc_assets/in_progress.png
+- doc_assets/none.png
+- doc_assets/qa.png
+- exec/v1git
+- lib/v1gittools.rb
+- lib/v1gittools/base_tool.rb
+- lib/v1gittools/change_log_tool.rb
+- lib/v1gittools/config.rb
+- lib/v1gittools/deep_hash_with_indifferent_access.rb
+- lib/v1gittools/develop_story_tool.rb
+- lib/v1gittools/qa_tool.rb
+- lib/v1gittools/version.rb
+- v1git.conf.example
+- v1gittools.gemspec
+homepage: http://malwarebytes.org
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5.1
+signing_key: 
+specification_version: 4
+summary: VersionOne/Git/Github Integration tools
+test_files: []