github-trello-cl 0.0.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8ae309b5667e125bcc1e13bfff8b932109547616
+  data.tar.gz: f0a476e318e67b9da2db3f3fbd2d20e19fb2ce69
+SHA512:
+  metadata.gz: b9d93f3582be6b1067dda282f2396eeb94c9c8995801247b30758b308e19db2b5a86cb2a8d1e8d96b69fd25dce5d1e6a5644c23a9ec2d865ee2605b7bedd66ac
+  data.tar.gz: e43af0607cd3ae4a1ac167691f479300c377779af3c9486582cd77e6f26d6cd022a751f076aaa6c15d913a066419a006019f89c57a8ec90d1a92b64c1faaf4df

data/.gitignore

@@ -0,0 +1,34 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,35 @@
+PATH
+  remote: .
+  specs:
+    trello (0.0.2)
+      commander
+      configuration
+      httparty
+      launchy
+      recursive-open-struct
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.3.7)
+    commander (4.3.0)
+      highline (~> 1.6.11)
+    configuration (1.3.4)
+    highline (1.6.21)
+    httparty (0.13.3)
+      json (~> 1.8)
+      multi_xml (>= 0.5.2)
+    json (1.8.2)
+    launchy (2.4.3)
+      addressable (~> 2.3)
+    multi_xml (0.5.5)
+    rake (10.3.2)
+    recursive-open-struct (0.5.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.6)
+  rake (~> 10.3.1)
+  trello!

data/README.md

@@ -0,0 +1,2 @@
+# trello-cl
+Command-line tool to allow users to interact with Trello without actually using Trello.

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/bin/trello

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'trello'
+
+Trello::Main.new.run

data/lib/.trelloconfig.default

@@ -0,0 +1 @@
+{}

data/lib/trello.rb

@@ -0,0 +1,150 @@
+require 'commander'
+require 'httparty'
+require 'launchy'
+require 'recursive-open-struct'
+require 'trello/constants'
+require 'trello/helpers'
+
+module Trello
+  class Main
+    include Commander::Methods
+
+    def run
+      program :name, "Trello"
+      program :description, 'Trello interface'
+      program :version, '1.0.0'
+
+      command :init do |c|
+        c.syntax = 'trello init'
+        c.description = 'Generates a default config file for the Trello CLI so it can be used in this directory.'
+        c.action do |args, options|
+          FileUtils.cp(File.join(Helpers::root, '.trelloconfig.default'), './.trelloconfig')
+          say "Created .trelloconfig in this directory."
+        end
+      end
+
+      command 'server-config' do |c|
+        c.syntax = 'trello server-config'
+        c.description = 'Builds a config file for your API backend.'
+        c.action do |args, options|
+          trello_config = {base_url: "https://api.trello.com/1/"}
+          trello_config[:api_key] = ask("API key?")
+          
+          url = "https://trello.com/1/authorize?key=#{trello_config[:api_key]}&name=Your+Application&expiration=never&response_type=token&scope=read,write"
+          puts "Requesting access to this application..."
+          sleep(0.5)
+          Launchy.open(url)
+          sleep(0.5)
+          trello_config[:token] = ask("What was the token?")
+
+          trello_config[:board_id] = Helpers::prompt_for("Which board should the API reference? (ID)") do
+            result = Helpers::make_trello_api_call(:get, "members/me", key: trello_config[:api_key], token: trello_config[:token], boards: 'open')['boards']
+
+            result.map do |board|
+              {id: board['id'], name: board['name']}
+            end
+          end
+
+          lists_resp = Helpers::make_trello_api_call(:get, "boards/#{trello_config[:board_id]}", key: trello_config[:api_key], token: trello_config[:token], lists: 'open')
+          lists = lists_resp['lists'].map do |list|
+            {id: list['id'], name: list['name']}
+          end
+
+          trello_config[:pending_columns] = Helpers::prompt_for_array("Which lists hold pending tasks? (ID,ID)") { lists }
+
+          {
+            in_development_column: "Which column represents tasks in development? (ID)",
+            in_review_column: "Which column represents tasks in review? (ID)",
+            approved_merged_column: "Which column represents tasks approved/merged to staging? (ID)",
+            deployed_column: "Which column represents tasks deployed to production? (ID)"
+          }.each do |field, message|
+            trello_config[field] = Helpers::prompt_for(message) { lists }
+          end
+
+          config_file = {
+            trello: trello_config
+          }
+
+          puts "Saving to config.json..."
+
+          Helpers::write_json_to_file(config_file, './config.json')
+        end
+      end
+
+      command :config do |c|
+        c.syntax = 'trello config --<field> value'
+        c.description = 'Configure options for the integration'
+        c.option '--user USERNAME', 'Configures the user\'s Trello username (required)'
+        c.option '--prefix initials', 'Initials to prepend to new branch names, e.g. \'[initials]-branch-name\''
+        c.action do |args, options|
+          if options.user
+            response = Helpers::make_trello_api_call(:get, "members/#{options.user}", {fields: :none},
+              not_found: "Couldn't find user #{options.user}.")
+            Helpers::config.user = response['id']
+          end
+
+          Helpers::config.prefix = options.prefix if options.prefix
+
+          Helpers::save_config
+        end
+      end
+
+      command :tasks do |c|
+        c.syntax = 'trello tasks [status]'
+        c.description = 'Shows tasks assigned to the configured user. If status is provided, shows tasks with the given status'
+        c.option '--all', 'Shows all tasks with the provided status, regardless of assignee'
+        c.action do |args, options|
+          user = options.all ? nil : Helpers::config['user']
+
+          status = args[0] || 'pending'
+
+          response = Helpers::make_integration_api_call(:get, "cards/#{status}", {},
+            bad_request: "Could not find lists for status #{status}.")
+
+          enable_paging
+          response.each do |list|
+            if user && list['cards'].none? {|card| card['idMembers'].include? user}
+              next
+            end
+
+            list_name = list['name']
+            say list_name
+            say ('-' * list_name.length)
+            list['cards'].each do |task|
+              if options.all || (user && task['idMembers'].include?(user))
+                say "  ##{task['idShort']}: #{task['name']}"
+              end
+            end
+          end
+        end
+      end
+      alias_command :ls, :tasks
+      alias_command :list, :tasks
+
+      command :start do |c|
+        c.syntax = 'trello start 123 <branch>'
+        c.description = "Marks the specified card as 'in development' on Trello and associates the specified branch with the card."
+        c.option '--no-branch', 'Starts the card without creating a new branch.' 
+        c.action do |args, options|
+          user = Helpers::config['user']
+          unless user
+            abort "You don't have a username configured - set one up so you can be assigned to cards"
+          end
+
+          unless args[1] || options['no-branch']
+            abort 'You need a branch name. To start this card without a branch, set the --no-branch flag (-n).'
+          end
+
+          branch = Helpers::config['prefix'] ? "#{Helpers::config['prefix']}-#{args[1]}" : args[1]
+
+          response = Helpers::make_integration_api_call(:post, "cards/#{args[0]}/start", {user: user, branch: branch},
+            not_found: "Could not find card #{args[0]}.")
+
+          say "Started card '#{response.parsed_response['name']}' with branch #{branch}."
+        end
+      end
+
+      run!
+    end
+  end
+end

data/lib/trello/constants.rb

@@ -0,0 +1,9 @@
+CONFIG_FILE_NAME = '.trelloconfig'
+# API_BASE_PATH = "https://trello.bookbub.com/api/"
+API_BASE_PATH = "http://trellobub.herokuapp.com/"
+DEFAULT_ERROR_MESSAGES = {
+  bad_request: "Invalid request.",
+  auth: "Failed to authenticate.",
+  not_found: "Couldn't find the site.",
+  server_error: "Something broke in the server."
+}

data/lib/trello/helpers.rb

@@ -0,0 +1,119 @@
+module Trello
+  module Helpers
+    class << self
+      def root
+        File.dirname __dir__
+      end
+
+      def make_api_call(method, url, body, errors = {})
+        api_errors = DEFAULT_ERROR_MESSAGES.merge(errors)
+        result = HTTParty.public_send(method, url, body: body)
+
+        unless result.success?
+          bad_response_msg = case result.code
+            when 400
+              api_errors[:bad_request]
+            when 401
+              api_errors[:auth]
+            when 404
+              api_errors[:not_found]
+            when 500
+              api_errors[:server_error]
+            else
+              "No message for error #{result.code}, message returned was #{result.inspect}"
+          end
+
+          abort bad_response_msg
+        end
+
+        result
+      end
+
+      def make_trello_api_call(method, endpoint, body, errors = {})
+        trello_errors = {
+          bad_request: "Authentication failed with token #{body[:token]}",
+          not_found: "Could not find Trello server - are you online?",
+          server_error: "Something blew up."
+        }.merge(errors)
+
+        make_api_call(method, "https://api.trello.com/1/#{endpoint}", body, trello_errors)
+      end
+
+      def make_integration_api_call(method, endpoint, body, errors = {})
+        make_api_call(method, "#{API_BASE_PATH}#{endpoint}", body, errors)
+      end
+
+      def to_i(str)
+        begin
+          Integer(str || '')
+        rescue ArgumentError
+          nil
+        end
+      end
+
+      def config
+        begin
+          @config ||= RecursiveOpenStruct.new(YAML.load_file(CONFIG_FILE_NAME))
+        rescue
+          abort "Could not load config - run 'trello init' to generate a config file."
+        end
+      end
+
+      def user_check
+        unless config['user']
+          abort "No user defined! Specify a user with trello config --user <username>."
+        end
+      end
+
+      def save_config
+        File.open(CONFIG_FILE_NAME, 'w') {|f| f.write config.to_hash.to_yaml }
+      end
+
+      def generate_branch(name, type)
+        prefix = config.name_prefix ? "#{config.name_prefix}-" : ''
+        try_external_command "git flow #{type} start #{prefix}#{name}"
+      end
+
+      def prompt_for_array(prompt_message)
+        var = nil
+        options = yield
+        options.each_with_index do |opt, i|
+          puts "#{i}: #{opt[:name]}"
+        end
+        until var
+          response = ask(prompt_message).split(',').map{|resp| to_i(resp)}
+          if response.all?{|id| id && options[id] }
+            var = options.values_at(*response).map{|option| option[:id]}
+          else
+            puts "Invalid array indices"
+          end
+        end
+
+        var
+      end
+
+      def prompt_for(prompt_message)
+        var = nil
+        options = yield
+        options.each_with_index do |opt, i|
+          puts "#{i}: #{opt[:name]}"
+        end
+        until var
+          response = to_i(ask(prompt_message))
+          if response && options[response]
+            var = options[response][:id]
+          else
+            say "Invalid array index"
+          end
+        end
+
+        var
+      end
+
+      def write_json_to_file(hash, filename)
+        puts hash
+        File.open(filename, 'w') {|f| f.write JSON.pretty_generate(hash)}
+      end
+    end
+  end
+end

data/trello.gemspec

@@ -0,0 +1,24 @@
+$LOAD_PATH << File.expand_path('../lib', __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = 'github-trello-cl'
+  s.version     = '0.0.3'
+  s.date        = '2015-02-23'
+  s.summary     = "Interface with trello"
+  s.description = "A tool to allow people using Trello as a workflow to interface with it via command line access to an API"
+  s.authors     = ["Steve Pletcher"]
+  s.email       = 'steve@steve-pletcher.com'
+  s.files       = `git ls-files -z`.split("\x0")
+  s.require_paths = ["lib"]
+  s.executables = ["trello"]
+  s.homepage    = 'http://rubygems.org/gems/trello'
+
+  s.add_development_dependency 'bundler', '~> 1.6'
+  s.add_development_dependency 'rake', '~> 10.3.1'
+
+  s.add_runtime_dependency 'commander'
+  s.add_runtime_dependency 'httparty'
+  s.add_runtime_dependency 'configuration'
+  s.add_runtime_dependency 'launchy'
+  s.add_runtime_dependency 'recursive-open-struct'
+end

metadata

@@ -0,0 +1,153 @@
+--- !ruby/object:Gem::Specification
+name: github-trello-cl
+version: !ruby/object:Gem::Version
+  version: 0.0.3
+platform: ruby
+authors:
+- Steve Pletcher
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-02-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 10.3.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 10.3.1
+- !ruby/object:Gem::Dependency
+  name: commander
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: configuration
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: launchy
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: recursive-open-struct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A tool to allow people using Trello as a workflow to interface with it
+  via command line access to an API
+email: steve@steve-pletcher.com
+executables:
+- trello
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- bin/trello
+- lib/.trelloconfig.default
+- lib/trello.rb
+- lib/trello/constants.rb
+- lib/trello/helpers.rb
+- trello.gemspec
+homepage: http://rubygems.org/gems/trello
+licenses: []
+metadata: {}
+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.0.14
+signing_key: 
+specification_version: 4
+summary: Interface with trello
+test_files: []