github-trello 0.0.3

data/MIT-LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2011 Zachary Anker
+
+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,28 @@
+Overview
+===
+Allows you to manage or reference your Trello board through commits to Github. Tag a commit with "Closes 1234" to have a card automatically archived, or "Card 1234" to have the commit sent to the card.
+
+Commands
+-
+Commit messages are searched for `(case|card|close|archive|fix)e?s? \D?([0-9]+)` to find the card short id. Case/card resolve to on_start configuration, close/fix resolve to on_close, and archive will just archive the card regardless.
+
+The commit message is added as a comment to the card as well.
+
+Usage
+-
+
+See `trello-web --help` for a list of arguments for starting the server. If your domain name is foobar.com and the server is listening on port 4000, then set the posthook URL on Github to __http://foobar.com:4000/posthook__
+
+On the first run, it will create an empty configuration file for you that you will need to configure based on how you want it to manage.
+
+You will need to get your api key and OAuth token with read/write access that won't expire for this to work. You can either use your own account, or create a separate deployment one for this.
+
+Go to https://trello.com/1/appKey/generate to get your key, then go to _https://trello.com/1/authorize?response_type=token&name=Trello+Github+Integration&scope=read,write&expiration=never&key=[Your Key Here]_ replacing __[Your Key Here]__ with the key Trello gave you. Authorize the request and then add the token and key to your trello.yml file.
+
+You can get the board id from the URL, for example https://trello.com/board/trello-development/4d5ea62fd76aa1136000000c the board id is _4d5ea62fd76aa1136000000ca_.
+
+There are 3 actions you can configure to decide what happens to a card. Currently due to a bug in Trello's API, you cannot move a card to another list through the API, so only __archive__ will work. The code is already in, just waiting on Trello to fix the bug.
+
+To do
+-
+Once Trello fixes the list API bug, I'll be implementing an on deploy action for people who want to be able to move cards from list A to B, such as moving from a "Pending Deployment" to "Live" or just archiving the cards.

data/Rakefile

@@ -0,0 +1,12 @@
+require "bundler"
+Bundler.setup
+
+require "rake"
+require "rspec"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new("spec") do |spec|
+  spec.pattern = "spec/**/*_spec.rb"
+end
+
+task :default => :spec

data/bin/trello-web

@@ -0,0 +1,26 @@
+#!/usr/bin/env ruby
+$LOAD_PATH.unshift File.expand_path(File.dirname(__FILE__) + "/../lib")
+
+require "vegas"
+require "yaml"
+require "github-trello/server"
+
+Vegas::Runner.new(GithubTrello::Server, "trello-web", {
+  :launch_path => lambda {|vegas|
+    path = File.join(vegas.app_dir, "trello.yml")
+    if File.exists?(path)
+      GithubTrello::Server.config = YAML::load(File.read(path))
+    else
+      puts "[WARNING] No configuration found at #{path}."
+      puts "We've generated an example one for you, but you need to configure it still."
+
+      File.open(path, "w+") do |f|
+        f.write("# NOTE: Due to a Trello API bug, currently only archive is supported and not move_to.\n\nboard_ids:\n  [repo name]: [board id]\noauth_token: [token]\napi_key: [key]\non_start:\n  move_to: [list id]\non_close:\n  move_to: [list id]\n  archive: false\non_deploy:\n  move_to: [list id]\n  archive: true")
+      end
+
+      exit
+    end
+
+    nil
+  }
+})

data/lib/github-trello.rb

@@ -0,0 +1 @@
+require "github-trello/version"

data/lib/github-trello/http.rb

@@ -0,0 +1,52 @@
+require "cgi"
+require "net/https"
+
+module GithubTrello
+  class HTTP
+    def initialize(token, api_key)
+      @token, @api_key = token, api_key
+      @uri = URI("https://api.trello.com")
+    end
+
+    def get_card(board_id, card_id)
+      http_request(:get, "/1/boards/#{board_id}/cards/#{card_id}", :params => {:fields => "idList,closed"})
+    end
+
+    def update_card(card_id, params)
+      http_request(:put, "/1/cards/#{card_id}", :params => params)
+    end
+
+    def add_comment(card_id, comment)
+      http_request(:post, "/1/cards/#{card_id}/actions/comments", :body => "text=#{CGI::escape(comment)}")
+    end
+
+    private
+    def http_request(method, request_path, args={})
+      request_path << "?"
+      args[:params] ||= {}
+      args[:params][:key] = @api_key
+      args[:params][:token] = @token
+      args[:params].each {|k, v| request_path << "#{k}=#{CGI::escape(v.to_s)}&"}
+
+      http = Net::HTTP.new(@uri.host, @uri.port)
+      http.use_ssl = true
+      http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+
+      http.start
+
+      if method == :get
+        response = http.request_get(request_path)
+      elsif method == :post
+        response = http.request_post(request_path, args.delete(:body))
+      elsif method == :put
+        response = http.request_put(request_path, args.delete(:body))
+      end
+
+      unless response.code == "200" or response.code == "201"
+        raise Net::HTTPError.new("#{response.body == "" ? response.message : response.body.strip} (#{response.code})", response)
+      end
+
+      response.body
+    end
+  end
+end

data/lib/github-trello/server.rb

@@ -0,0 +1,87 @@
+require "json"
+require "sinatra/base"
+require "github-trello/version"
+require "github-trello/http"
+
+module GithubTrello
+  class Server < Sinatra::Base
+    post "/posthook" do
+      config, http = self.class.config, self.class.http
+
+      payload = JSON.parse(params[:payload])
+
+      board_id = config["board_ids"][payload["repository"]["name"]]
+      unless board_id
+        puts "[ERROR] Commit from #{payload["repository"]["name"]} but no board_id entry found in config"
+        return
+      end
+
+      branch = payload["ref"].gsub("refs/heads/", "")
+      if config["blacklist_branches"] and config["blacklist_branches"].include?(branch)
+        return
+      elsif config["whitelist_branches"] and !config["whitelist_branches"].include?(branch)
+        return
+      end
+
+      payload["commits"].each do |commit|
+        # Figure out the card short id
+        match = commit["message"].match(/((case|card|close|archive|fix)e?s? \D?([0-9]+))/i)
+        next unless match and match[3].to_i > 0
+
+        results = http.get_card(board_id, match[3].to_i)
+        unless results
+          puts "[ERROR] Cannot find card matching ID #{match[3]}"
+          next
+        end
+
+        results = JSON.parse(results)
+
+        # Add the commit comment
+        message = "#{commit["author"]["name"]}: #{commit["message"]}\n\n[#{branch}] #{commit["url"]}"
+        message.gsub!(match[1], "")
+        message.gsub!(/\(\)$/, "")
+
+        http.add_comment(results["id"], message)
+
+        # Determine the action to take
+        update_config = case match[2].downcase
+          when "case", "card" then config["on_start"]
+          when "close", "fix" then config["on_close"]
+          when "archive" then {:archive => true}
+        end
+
+        next unless update_config.is_a?(Hash)
+
+        # Modify it if needed
+        to_update = {}
+
+        # Disabled for now due to a Trello bug
+        #unless results["idList"] == update_config["move_to"]
+        #  to_update[:idList] = update_config["move_to"]
+        #end
+
+        if !results["closed"] and update_config["archive"]
+          to_update[:closed] = true
+        end
+
+        unless to_update.empty?
+          http.update_card(results["id"], to_update)
+        end
+      end
+
+      ""
+    end
+
+    get "/" do
+      "Nothing to see here"
+    end
+
+    def self.config=(config)
+      @config = config
+      @http = GithubTrello::HTTP.new(config["oauth_token"], config["api_key"])
+    end
+
+    def self.config; @config end
+    def self.http; @http end
+  end
+end

data/lib/github-trello/version.rb

@@ -0,0 +1,3 @@
+module GithubTrello
+  VERSION = "0.0.3"
+end

metadata

@@ -0,0 +1,87 @@
+--- !ruby/object:Gem::Specification
+name: github-trello
+version: !ruby/object:Gem::Version
+  version: 0.0.3
+  prerelease: 
+platform: ruby
+authors:
+- Zachary Anker
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-04-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: vegas
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.1.8
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.1.8
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.2
+description: Enables managing Trello cards through Github posthooks and Git commits
+email:
+- zach.anker@gmail.com
+executables:
+- trello-web
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/github-trello/http.rb
+- lib/github-trello/server.rb
+- lib/github-trello/version.rb
+- lib/github-trello.rb
+- MIT-LICENSE
+- README.md
+- Rakefile
+- !binary |-
+  YmluL3RyZWxsby13ZWI=
+homepage: http://github.com/zanker/github-trello
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: github-trello
+rubygems_version: 1.8.21
+signing_key: 
+specification_version: 3
+summary: Github -> Trello integration
+test_files: []