t1k 1.2.0 → 2.0.0.alpha

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 032fd6051d9d59dc4ae603a5247c6510bd17cc2f
-  data.tar.gz: ca404f600d7a733a80b71d9c4af62b5b96d67996
+  metadata.gz: b96b74479f3ee077f668e24ea6349f2c6e4cedeb
+  data.tar.gz: b046a9d6730e25a55b015e752ce8ba8b1acbd8b0
 SHA512:
-  metadata.gz: 28f58526fb0d9fcb5f6266060bf56d895f9c2fba0d153cf6e811a278705327a6e06f1de1c37bc1cd966d420478d9334331e65b876cd27943cb54ac6c85d8a072
-  data.tar.gz: c3acb79196e7eaf8c026ef818ac4df6250d5576d9e66b0ad7f2315f6817231d99193e55b0e03ca1e7db286e9e05aeb3a956475b928740de5785096ed76df9b44
+  metadata.gz: 2561a612aea91a0960a4927982379eeb791949a97f27d533adf7fb86c47bffde9a5e1eebadae89683c24788b23bb7aaaf2521710c62a93111e0733864d447039
+  data.tar.gz: 6fdc77bca049bb2afb01bd6ef68b24e370b35389e3e73872bd587bb59cdc6d3e73b1187db7cafbc8feba69f0acba5af7b89a4b70d15d47ffd8521f5276719fa2

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, 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, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other 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. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](http:contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Fernando Martínez
+
+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,113 @@
+# T1K [![Code Climate](https://codeclimate.com/github/fortesinformatica/t1k/badges/gpa.svg)](https://codeclimate.com/github/fortesinformatica/t1k)
+
+T1K - Automated Git and Trello Workflow
+
+Use those scripts to automatically create branchs associated with issues and tracked commits with cards on Trello.
+
+T1k allow you from command line to use some tasks to make easy to create brach, commit, create an issue and track it down in a Trello's card.
+
+- [T1K](#t1k)
+  - [Getting started](#getting-started)
+    - [T1000 Configuration File](#t1000-configuration-file)
+  - [Commands](#commands)
+    - [Init](#init)
+    - [Commit](#commit)
+    - [Sink](#sink)
+    - [Ship](#ship)
+  - [License](#license)
+
+## Getting started
+
+Install in your system T1k's gem
+
+```ruby
+$ gem install t1k
+```
+
+Start using t1k into your project directory
+
+```shell
+$ t1k init
+```
+
+It creates the T1000 configuration file inside your project folder.
+
+### T1000 Configuration File
+Here is a possible configuration for `github` and `trello`.
+Your `T1000` should look like this:
+
+```ruby
+T1k.setup do |config|
+  # Change the repository adapter. Default is github.
+  # config.repository.adapter = :github
+
+  # Change the tracker adapter. Default is trello.
+  # config.tracker.adapter = :trello
+
+  # Configuring your repository
+  config.repository.setup do |c|
+    # https://github.com/settings/applications
+    # Personal access tokens
+    c.oauth_token = 'PERSONAL_ACCESS_TOKEN'
+    c.user = 'YOUR_REPOSITORY_USERNAME'
+    c.repo = 'YOUR_REPOSITORY_NAME'
+  end
+
+  # Configuring your tracker
+  config.tracker.setup do |c|
+    # https://trello.com/app-key
+    # https://trello.com/1/connect?key=YOUR_KEY&name=BOARD_NAME&expiration=never&response_type=token&scope=read,write
+    c.developer_public_key = 'PUBLIC_KEY'
+    c.member_token = 'APP_MEMBER_TOKEN'
+    c.user_name = 'YOUR_TRELLO_USER'
+    c.board_name = 'BOARD_NAME'
+  end
+end
+```
+
+When using `:github` as your repository, you must define `:oauth_token`, `:user`, `:repo`.
+
+When using `:trello` as your tracker, you must define `:developer_public_key`, `:member_token`, `:user_name` and `:board_name`.
+
+## Commands
+
+Basic workflow:
+
+```shell
+$ t1k commit -m 'commit message'
+$ t1k commit -m 'finish issue and close it' -c
+$ t1k sink
+$ t1k ship
+```
+
+### Init
+
+Just adds to your project folder a T1000 config file template
+
+### Commit
+
+Commit has to params options, -m and -c.
+
+1. `t1k commit` : just commits your staged changes (no message is added) *not recommended*
+2. `t1k commit -m 'message'` : commits your staged changes with a custom message
+2. `t1k commit -c -m 'message'` : -c is used to close your issue.
+
+### Sink
+
+Just _sync_ with master your current branch
+
+### Ship
+
+It deliveries to master (local and remote) your branch and changes current branch to master
+
+## License
+
+MIT License (MIT)
+
+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/Rakefile

@@ -1,29 +1 @@
-begin
-  require 'bundler/setup'
-rescue LoadError
-  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
-end
-
-require 'rdoc/task'
-
-RDoc::Task.new(:rdoc) do |rdoc|
-  rdoc.rdoc_dir = 'rdoc'
-  rdoc.title    = 'T1k'
-  rdoc.options << '--line-numbers'
-  rdoc.rdoc_files.include('README.rdoc')
-  rdoc.rdoc_files.include('lib/**/*.rb')
-end
-
-Bundler::GemHelper.install_tasks
-
-require 'rake/testtask'
-
-Rake::TestTask.new(:test) do |t|
-  t.libs << 'lib'
-  t.libs << 'test'
-  t.pattern = 'test/**/*_test.rb'
-  t.verbose = false
-end
-
-
-task default: :test
+require "bundler/gem_tasks"

data/T1000

@@ -0,0 +1,24 @@
+T1k.setup do |config|
+
+  # Setup Github repository credentials
+  #
+  # config.repository.adapter = :github
+  # config.repository.setup do |c|
+  #   c.user = "GITHUB_USER"
+  #   c.oauth_token = "GITHUB_AUTH_TOKEN"
+  #   c.repo = "REPOSITORY_NAME"
+  # end
+
+  # Setup Trello board credentials
+  #
+  # T1k.setup do |config|
+  #  config.tracker.adapter = :trello
+  #  config.tracker.setup do |c|
+  #    c.user_name = "TRELLO_USER"
+  #    c.member_token = "TRELLO_MEMBER_TOKEN"
+  #    c.board_name = "TRELLO_BOARD_NAME"
+  #    c.developer_public_key = "TRELLO_DEVELOPER_PUB_KEY"
+  #  end
+  # end
+
+end

data/bin/t1k

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+require 't1k'
+
+puts ARGV
+
+command = T1k::Command.new(ARGV)
+command.run

data/lib/t1k/command.rb

@@ -0,0 +1,50 @@
+require 't1k/commands/init'
+require 't1k/commands/hack'
+require 't1k/commands/commit'
+require 't1k/commands/sink'
+require 't1k/commands/ship'
+
+module T1k
+  INIT = "init"
+  HACK = "hack"
+  COMMIT = "commit"
+  SINK = "sink"
+  SHIP = "ship"
+
+  class Command
+
+    def initialize(argv)
+      @args = argv
+    end
+
+    def run
+      T1k.setup_credentials
+
+      @args.count == 0 ? help : parse_args(@args)
+    end
+
+    def help
+      puts "T1K (T-100) Gem. It's a help and let's learn"
+      puts ""
+      puts "t1k [command] <params>"
+      puts ""
+      puts T1k::Commands::Init.help
+      puts T1k::Commands::Hack.help
+      puts T1k::Commands::Commit.help
+      puts T1k::Commands::Sink.help
+      puts T1k::Commands::Ship.help
+    end
+
+    private
+
+    def parse_args(args)
+      command = args[0]
+
+      T1k::Commands::Init.run if command == INIT && args.count == 1
+      T1k::Commands::Hack.run(args[1]) if command == HACK && args.count == 2
+      T1k::Commands::Commit.run(args[1..args.count]) if command == COMMIT
+      T1k::Commands::Sink.run if command == SINK && args.count == 1
+      T1k::Commands::Ship.run if command == SHIP && args.count == 1
+    end
+  end
+end

data/lib/t1k/commands/commit.rb

@@ -0,0 +1,37 @@
+module T1k
+  module Commands
+    class Commit
+
+      def self.run(args)
+        message, close = parse_args(args)
+
+        branch = `git branch | grep '*' | awk '{print $2}'`
+        system "git commit -m '[#{close} ##{branch.strip}] #{message}'"
+      end
+
+      def self.help
+        <<-DESC
+        commit - commit your staged changes.
+
+          -m <message>  - send a commit with a custom message
+          -c            - send a commit with close sentence. eg. [closes #320]
+        DESC
+      end
+
+      private
+
+      def self.parse_args(args)
+        message = ""
+        close = ""
+
+        args.each_with_index do |arg, i|
+
+          message = args[i + 1] || message if arg == '-m'
+          close = "close" if arg == '-c'
+        end
+
+        return message, close
+      end
+    end
+  end
+end

data/lib/t1k/commands/hack.rb

@@ -0,0 +1,26 @@
+module T1k
+  module Commands
+    class Hack
+
+      def self.run(path_card_part)
+        code_card = T1k::hack path_card_part
+
+        system 'git checkout master'
+        system 'git pull --rebase origin master'
+        existent_branch = `git branch --list #{code_card}`
+
+        if existent_branch.present?
+          system "git checkout #{code_card}"
+        else
+          system "git checkout -b #{code_card}"
+        end
+      end
+
+      def self.help
+        <<-DESC
+        hack <card_identifier> - creates a branch associated with a card and checkout to it.
+        DESC
+      end
+    end
+  end
+end

data/lib/t1k/commands/init.rb

@@ -0,0 +1,22 @@
+require 'fileutils'
+
+module T1k
+  module Commands
+    class Init
+
+      def self.run
+        src = File.join(T1k::path_to_resources, "T1000")
+        dest = T1k::tthousand_path
+
+        FileUtils.cp src, dest
+      end
+
+      def self.help
+        <<-DESC
+        init - Creates T1000 file into your project folder.
+          Setup your keys and other configurations in this file.
+        DESC
+      end
+    end
+  end
+end

data/lib/t1k/commands/ship.rb

@@ -0,0 +1,23 @@
+
+
+module T1k
+  module Commands
+    class Ship
+
+      def self.run
+      branch = `git branch | grep '*' | awk '{print $2}'`
+      system "git checkout master"
+      system "git pull --rebase"
+      system "git merge #{branch.strip}"
+      system "git commit -v"
+      system "git push origin master"
+      end
+
+      def self.help
+        <<-DESC
+        ship - delivery your changes to local and remote master branch.
+        DESC
+      end
+    end
+  end
+end

data/lib/t1k/commands/sink.rb

@@ -0,0 +1,20 @@
+module T1k
+  module Commands
+    class Sink
+
+      def self.run
+        branch = `git branch | grep '*' | awk '{print $2}'`
+        system "git checkout master"
+        system "git pull --rebase origin master"
+        system "git checkout #{branch.strip}"
+        system "git rebase master #{branch.strip}"
+      end
+
+      def self.help
+        <<-DESC
+        sink - update current branch with master (ie Sync with master).
+        DESC
+      end
+    end
+  end
+end

data/lib/t1k/repositories/bitbucket.rb

@@ -1,23 +1,23 @@
 # bitbucket requirements
 
 module T1k
-	module Repositories
-		class Bitbucket
+  module Repositories
+    class Bitbucket
 
-			# bitbucket configurations
-			# cattr_accessor :config_name
-			# @@config_name = "default value"
+      # bitbucket configurations
+      # cattr_accessor :config_name
+      # @@config_name = "default value"
 
-			# implement setup method
-			# def self.setup &block
-			# 	yield(self) if block_given?
-			# end
+      # implement setup method
+      # def self.setup &block
+      #   yield(self) if block_given?
+      # end
 
-			# implement create_issue method
-			# def self.create_issue(title); end
+      # implement create_issue method
+      # def self.create_issue(title); end
 
-			# implement create_issue method
-			# def self.get_issue(html_url); end
-		end
-	end
+      # implement create_issue method
+      # def self.get_issue(html_url); end
+    end
+  end
 end

data/lib/t1k/repositories/github.rb

@@ -1,57 +1,57 @@
-require "github_api"
+require 'github_api'
 
 module T1k
-	module Repositories
-		class Github
-
-			cattr_accessor :oauth_token
-			@@oauth_token = ""
-
-			cattr_accessor :user
-			@@user = ""
-
-			cattr_accessor :repo
-			@@repo = ""
-
-			Issue = Struct.new(:code, :link)
-
-			def self.setup &block
-				yield(self) if block_given?
-				self.config_keys
-			end
-
-			def self.config_keys
-				# ::Github.configure do |config|
-					# your keys
-				# end
-			end
-
-			def self.create_issue title
-				begin
-					puts "Creating issue"
-					github_auth = ::Github.new(oauth_token: self.oauth_token)
-					issue = github_auth.issues.create(user: self.user, repo: self.repo, title: title)
-					issue
-				rescue
-					raise 'Issue not created'
-				end			
-			end
-
-			def self.get_issue issue_number
-				begin
-					puts "Recovering existent issue"
-					github_auth = ::Github.new(oauth_token: self.oauth_token)
-					issue = github_auth.issues.get user: self.user, repo: self.repo, number: issue_number
-					issue
-				rescue
-					raise 'Issue not recovered'
-				end			
-			end
-
-			def self.get_issue_number html_url
-				code = html_url[html_url.rindex('/')+1..html_url.size]
-				Issue.new(code, "Link to code: [#{code}](#{html_url})")
-			end
-		end
-	end
+  module Repositories
+    class Github
+
+      cattr_accessor :oauth_token
+      @@oauth_token = ""
+
+      cattr_accessor :user
+      @@user = ""
+
+      cattr_accessor :repo
+      @@repo = ""
+
+      Issue = Struct.new(:code, :link)
+
+      def self.setup &block
+        yield(self) if block_given?
+        self.config_keys
+      end
+
+      def self.config_keys
+        # ::Github.configure do |config|
+          # your keys
+        # end
+      end
+
+      def self.create_issue title
+        begin
+          puts 'Creating issue'
+          github_auth = ::Github.new(oauth_token: self.oauth_token)
+          issue = github_auth.issues.create(user: self.user, repo: self.repo, title: title)
+          issue
+        rescue
+          raise 'Issue not created'
+        end
+      end
+
+      def self.get_issue issue_number
+        begin
+          puts 'Recovering existent issue'
+          github_auth = ::Github.new(oauth_token: self.oauth_token)
+          issue = github_auth.issues.get user: self.user, repo: self.repo, number: issue_number
+          issue
+        rescue
+          raise 'Issue not recovered'
+        end
+      end
+
+      def self.get_issue_number html_url
+        code = html_url[html_url.rindex('/')+1..html_url.size]
+        Issue.new(code, "Link to code: [#{code}](#{html_url})")
+      end
+    end
+  end
 end

data/lib/t1k/repository.rb

@@ -1,15 +1,20 @@
 module T1k
-	class Repository
-		cattr_accessor :adapter
-		@@adapter = T1k::Repositories::Github # default adapter
-
-		class << self
-			delegate :setup, :create_issue, :get_issue, :get_issue_number, to: :adapter
-		end
-
-		def self.adapter=(adapter_name)
-			raise "Invalid adapter name. Adapter name must be a Symbol." unless adapter_name.class.eql?(Symbol)
-			@@adapter = "T1k::Repositories::#{adapter_name.to_s.classify}".constantize
-		end
-	end
+  class Repository
+
+    cattr_accessor :adapter
+    @@adapter = T1k::Repositories::Github
+
+    class << self
+      delegate :create_issue, :get_issue, :get_issue_number, to: @@adapter
+    end
+
+    def self.setup &block
+      self.adapter.setup(&block) if block_given?
+    end
+
+    def self.adapter=(adapter_name)
+      raise "Invalid adapter name. Adapter name must be a Symbol." unless adapter_name.class.eql?(Symbol)
+      @@adapter = "T1k::Repositories::#{adapter_name.to_s.classify}".constantize
+    end
+  end
 end

data/lib/t1k/tracker.rb

@@ -1,15 +1,20 @@
 module T1k
-	class Tracker
-		cattr_accessor :adapter
-		@@adapter = T1k::Trackers::Trello # default adapter
-
-		class << self
-			delegate :setup, :get_card, :update_card, to: :adapter
-		end
-
-		def self.adapter=(adapter_name)
-			raise "Invalid adapter name. Adapter name must be a Symbol." unless adapter_name.class.eql?(Symbol)
-			@@adapter = "T1k::Trackers::#{adapter_name.to_s.classify}".constantize
-		end
-	end
+  class Tracker
+
+    cattr_accessor :adapter
+    @@adapter = T1k::Trackers::Trello # default adapter
+
+    class << self
+      delegate :get_card, :update_card, to: @@adapter
+    end
+
+    def self.setup &block
+      self.adapter.setup(&block) if block_given?
+    end
+
+    def self.adapter=(adapter_name)
+      raise "Invalid adapter name. Adapter name must be a Symbol." unless adapter_name.class.eql?(Symbol)
+      @@adapter = "T1k::Trackers::#{adapter_name.to_s.classify}".constantize
+    end
+  end
 end