temjin 0.0.1

data/README.md

@@ -0,0 +1,3 @@
+# temjin
+
+cli tool for talking to trello

data/Rakefile

@@ -0,0 +1,26 @@
+require 'rake/clean'
+require 'rake/testtask'
+require 'rake/notes/rake_task'
+require 'rubocop/rake_task'
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+  t.test_files = ['test/main.rb']
+  t.verbose = true
+  t.warning = false
+end
+
+RuboCop::RakeTask.new
+
+desc "Runs Rubocop style checker with xml output for Jenkins"
+task 'rubocop:jenkins' do
+  system("bundle exec rubocop \
+          --require rubocop/formatter/checkstyle_formatter \
+          --format Robocop::Formatter::CheckstyleFormatter \
+          --no-color \
+          --out rubocop.xml")
+end
+
+task :default => %i[test rubocop]
+
+CLEAN << 'coverage'

data/authors.yml

@@ -0,0 +1,2 @@
+---
+- Adam Price

data/bin/temjin

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+
+require 'temjin'
+begin
+  Temjin::MainCommand.run
+rescue StandardError => e
+  puts e.message
+  exit 1
+end

data/lib/temjin/card_command/add_command.rb

@@ -0,0 +1,26 @@
+module Temjin
+  class CardCommand
+    class AddCommand < Temjin::TrelloAPICommand
+      parameter 'BOARD', 'board name'
+      parameter 'LIST', 'list name'
+      parameter '[CARD_NAME]', 'name of card to add'
+
+      option '--desc', 'DESC', 'card description'
+
+      def execute
+        # TODO: should also be included in the command setup
+        user = find_user(config.username)
+
+        list_id = find_list(user, board, list).id
+
+        create_options = {}
+        create_options[:list_id] = list_id
+        create_options[:name] = card_name if card_name
+        create_options[:desc] = desc if desc
+
+        new_card = Trello::Card.create(create_options)
+        Formatador.display_line("[[yellow]#{new_card.id}[/]] added")
+      end
+    end
+  end
+end

data/lib/temjin/card_command/list_command.rb

@@ -0,0 +1,26 @@
+module Temjin
+  class CardCommand
+    class ListCommand < Temjin::TrelloAPICommand
+      # TODO: eventually make BOARD and LIST optional, but for now we need them
+      parameter 'BOARD', 'trello board'
+      parameter 'LIST', 'trello list'
+
+      def execute
+        # TODO: should also be included in the command setup
+        user = find_user(config.username)
+
+        cards = find_list(user, board, list).cards
+
+        cards = cards.map do |c|
+          {:id => c.id,
+           :name => c.name,
+           :desc => c.desc}
+        end
+
+        cards.each do |card|
+          Formatador.display_line("[yellow]#{card[:id]}[/] - #{card[:name]}")
+        end
+      end
+    end
+  end
+end

data/lib/temjin/card_command/show_command.rb

@@ -0,0 +1,44 @@
+module Temjin
+  class CardCommand
+    class ShowCommand < Temjin::TrelloAPICommand
+      parameter 'CARD_ID', 'card ID'
+
+      def execute
+        card = find_card(card_id)
+        list = find_list_by_id(card.list_id)
+        board = find_board(card.board_id)
+        members = card.member_ids.map { |member| find_user(member).username }
+        labels = card.labels.map { |label| label.name }
+
+        Formatador.display_line("# [bold]#{card.name}[/]")
+        Formatador.indent do
+          Formatador.display_line("-> #{list.name} --> #{board.name}")
+        end
+        Formatador.display_line("[[yellow]#{card.id}[/]] #{card.short_url} #{card.attachments.empty? ? '' : '+attachments '}- #{card.closed? ? '[_red_]closed[/]' : '[green]open[/]'}")
+        Formatador.display_line(members.map { |m| "[cyan]@#{m}[/]" }.join(', ')) unless members.empty?
+        Formatador.display_line("{ #{labels.map { |l| "[purple]#{l}[/]" }.join(', ')} }") unless labels.empty?
+        Formatador.display_line("due on [red]#{card.due.getlocal.ctime}[/]") unless card.due.nil?
+        unless card.checklists.empty?
+          Formatador.display_line("---")
+          card.checklists.each do |checklist|
+            Formatador.display_line(checklist.name)
+            Formatador.indent do
+              checklist.check_items.each do |checklist_item|
+                checkbox = if checklist_item['state'].match?(/^complete$/)
+                             "\u2713".force_encoding('utf-8')
+                           else
+                             ' '
+                           end
+                Formatador.display_line("[#{checkbox}] #{checklist_item['name']}")
+              end
+            end
+          end
+        end
+        unless card.desc.empty?
+          Formatador.display_line("---")
+          Formatador.display_line(card.desc) # FIXME: what happens if the desc is multiple lines?
+        end
+      end
+    end
+  end
+end

data/lib/temjin/card_command/update_command.rb

@@ -0,0 +1,20 @@
+module Temjin
+  class CardCommand
+    class UpdateCommand < Temjin::TrelloAPICommand
+      parameter 'CARD_ID', 'card ID'
+
+      option '--name', 'NAME', 'card name'
+      option '--desc', 'DESC', 'card description'
+
+      def execute
+        card = find_card(card_id)
+
+        card.name = name if name
+        card.desc = desc if desc
+
+        card.save
+        Formatador.display_line("[[yellow]#{card.id}[/]] updated")
+      end
+    end
+  end
+end

data/lib/temjin/card_command.rb

@@ -0,0 +1,3 @@
+module Temjin
+  class CardCommand < Clamp::Command; end
+end

data/lib/temjin/command.rb

@@ -0,0 +1,46 @@
+module Temjin
+  class Command < Clamp::Command
+    def initialize(invocation_path, context = {})
+      @config = context[:config] if context.key?(:config)
+      super(invocation_path, context)
+    end
+
+    def config
+      @config ||= Config.new
+    end
+  end
+
+  class TrelloAPICommand < Temjin::Command
+    def initialize(invocation_path, context = {})
+      super(invocation_path, context)
+      trello_connection
+    end
+
+    def trello_connection
+      Trello.configure do |c|
+        c.developer_public_key = config.key
+        c.member_token = config.token
+      end
+    end
+
+    def find_board(board_id)
+      Trello::Board.find(board_id)
+    end
+
+    def find_list(user, board_name, list_name)
+      user.boards.detect { |b| b.name.match(board_name) }.lists.detect { |l| l.name.match(list_name) }
+    end
+
+    def find_list_by_id(list_id)
+      Trello::List.find(list_id)
+    end
+
+    def find_user(username)
+      Trello::Member.find(username)
+    end
+
+    def find_card(card_id)
+      Trello::Card.find(card_id)
+    end
+  end
+end

data/lib/temjin/config.rb

@@ -0,0 +1,42 @@
+module Temjin
+  class Config
+    attr_accessor :username, :key, :token
+
+    attr_reader :file_path
+
+    def initialize(options = {})
+      options = {:path => File.join(ENV['HOME'], '.config', 'temjin.yml'),
+                 :create => false}.merge(options.select { |k, _| %i[path create].include?(k) })
+
+      @file_path = options[:path]
+
+      create_or_verify_file(options[:create])
+
+      config = YAML.load_file(@file_path) || {}
+      @username = config.dig('username')
+      @key = config.dig('key')
+      @token = config.dig('token')
+
+      verify_format unless options[:create]
+    end
+
+    def create_or_verify_file(create_bool = false)
+      if create_bool
+        FileUtils.touch(file_path)
+      else
+        fail Temjin::ConfigurationNotFoundError unless File.exist?(file_path)
+      end
+    end
+
+    def verify_format
+      malformed = username.nil? || key.nil? || token.nil?
+      fail Temjin::ConfigurationNotFoundError if malformed
+    end
+
+    def save!
+      File.open(file_path, 'w') do |f|
+        f.write({'username' => username, 'key' => key, 'token' => token}.to_yaml)
+      end
+    end
+  end
+end

data/lib/temjin/config_command/init_command.rb

@@ -0,0 +1,27 @@
+module Temjin
+  class ConfigCommand
+    class InitCommand < Temjin::Command
+      def config # override
+        @config ||= Config.new(:create => true)
+      end
+
+      def prompt(message, default = nil)
+        print(message)
+        result = $stdin.gets.chomp
+        result.empty? ? default : result
+      end
+
+      def execute
+        # TODO: use Formatador for all output
+        puts 'Go to https://trello.com/app-key to get your key and token.'
+        puts
+
+        config.username = prompt('username: ')
+        config.key = prompt('key: ')
+        config.token = prompt('token: ')
+
+        config.save!
+      end
+    end
+  end
+end

data/lib/temjin/config_command/show_command.rb

@@ -0,0 +1,11 @@
+module Temjin
+  class ConfigCommand
+    class ShowCommand < Temjin::Command
+      def execute
+        # TODO: use formatador for all output
+        puts "key: #{config.key}"
+        puts "token: #{config.token}"
+      end
+    end
+  end
+end

data/lib/temjin/config_command.rb

@@ -0,0 +1,3 @@
+module Temjin
+  class ConfigCommand < Clamp::Command; end
+end

data/lib/temjin/configuration_not_found_error.rb

@@ -0,0 +1,8 @@
+module Temjin
+  class ConfigurationNotFoundError < StandardError
+    def initialize(message = nil)
+      message ||= "Configuration not found. Please run `temjin config init`."
+      super(message)
+    end
+  end
+end

data/lib/temjin/list_command.rb

@@ -0,0 +1,3 @@
+module Temjin
+  class ListCommand < Clamp::Command; end
+end

data/lib/temjin/main_command.rb

@@ -0,0 +1,8 @@
+module Temjin
+  class MainCommand < Clamp::Command
+    option ['-v', '--version'], :flag, 'display version' do
+      puts Temjin.version
+      exit
+    end
+  end
+end

data/lib/temjin/version.rb

@@ -0,0 +1,5 @@
+module Temjin
+  def self.version
+    @version ||= Gem::Version.new('0.0.1')
+  end
+end

data/lib/temjin.rb

@@ -0,0 +1,34 @@
+require 'formatador'
+require 'clamp'
+require 'trello' # ruby-trello
+
+# beta feature
+Clamp.allow_options_after_parameters = true
+
+require 'temjin/configuration_not_found_error'
+require 'temjin/config'
+require 'temjin/command'
+
+require 'temjin/config_command'
+require 'temjin/config_command/show_command'
+require 'temjin/config_command/init_command'
+require 'temjin/card_command'
+require 'temjin/card_command/list_command'
+require 'temjin/card_command/show_command'
+require 'temjin/card_command/add_command'
+require 'temjin/card_command/update_command'
+require 'temjin/list_command'
+require 'temjin/main_command'
+
+# cli structure
+module Temjin
+  ConfigCommand.subcommand("show", "display current configuration", ConfigCommand::ShowCommand)
+  ConfigCommand.subcommand("init", "setup configuration", ConfigCommand::InitCommand)
+  MainCommand.subcommand("config", "temjin configuration", ConfigCommand)
+
+  CardCommand.subcommand("list", "list cards using optional filters", CardCommand::ListCommand)
+  CardCommand.subcommand("show", "display a card's information", CardCommand::ShowCommand)
+  CardCommand.subcommand("add", "add a new card", CardCommand::AddCommand)
+  CardCommand.subcommand("update", "update a card", CardCommand::UpdateCommand)
+  MainCommand.subcommand("card", "trello cards", CardCommand)
+end

data/test/files/configs/proper_config.yml

@@ -0,0 +1,4 @@
+---
+username: bigboss
+key: 0123456789abcdef0123456789abcdef
+token: 0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef

data/test/helpers/capture_output.rb

@@ -0,0 +1,26 @@
+module Temjin
+  module Test
+    module CaptureOutput
+      def capture_output
+        original_stdout = $stdout
+        $stdout = fake_stdout = StringIO.new
+
+        original_stderr = $stderr
+        $stderr = fake_stderr = StringIO.new
+
+        original_stdin = $stdin
+        $stdin = fake_stdin = StringIO.new
+
+        begin
+          yield(fake_stdin)
+        ensure
+          $stdout = original_stdout
+          $stderr = original_stderr
+          $stdin = original_stdin
+        end
+
+        [fake_stdout.string, fake_stderr.string]
+      end
+    end
+  end
+end

data/test/main.rb

@@ -0,0 +1,28 @@
+require 'mocha/mini_test'
+
+require 'simplecov'
+SimpleCov.start do
+  add_filter '/test/'
+end
+
+require 'minitest/autorun'
+require 'mocha/setup'
+
+require 'temjin'
+
+require 'webmock'
+include WebMock::API
+WebMock.enable!
+WebMock.disable_net_connect!
+
+module Temjin
+  module Test
+    HOME_DIR = File.dirname(__FILE__)
+  end
+end
+
+require './test/helpers/capture_output.rb'
+
+Dir['./test/**/*_test.rb'].each do |f|
+  require f
+end

data/test/temjin/card_command/add_command_test.rb

@@ -0,0 +1,98 @@
+module Temjin
+  module Test
+    module CardCommand
+      class AddCommandTest < MiniTest::Test
+        include CaptureOutput
+
+        def setup
+          @username = 'solid_snake'
+          @key = '0123456789abcdef0123456789abcdef'
+          @token = '0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef'
+
+          @board_name = 'fake_board'
+          @list_name = 'fake_list'
+          @id = '0123456789abcdef0123456789abcdef'
+          @card_name = "remind everyone that i'm no hero"
+          @card_desc = "uttered it a million times in metal gear solid 4"
+        end
+
+        def teardown; end
+
+        def test_execute_no_options
+          config = mock()
+          config.expects(:username).returns(@username)
+          config.expects(:key).returns(@key)
+          config.expects(:token).returns(@token)
+
+          list = mock()
+          list.expects(:id).returns(@id)
+
+          add_command = Temjin::CardCommand::AddCommand.new('temjin card add', :config => config)
+          add_command.expects(:find_user).with(@username).returns(@username)
+          add_command.expects(:find_list).with(@username, @board_name, @list_name).returns(list)
+
+          added_card = mock()
+          added_card.expects(:id).returns(@id)
+
+          create_options = {:list_id => @id}
+
+          Trello::Card.expects(:create).with(create_options).returns(added_card)
+
+          capture_output do
+            add_command.run([@board_name, @list_name])
+          end
+        end
+
+        def test_execute_with_name
+          config = mock()
+          config.expects(:username).returns(@username)
+          config.expects(:key).returns(@key)
+          config.expects(:token).returns(@token)
+
+          list = mock()
+          list.expects(:id).returns(@id)
+
+          add_command = Temjin::CardCommand::AddCommand.new('temjin card add', :config => config)
+          add_command.expects(:find_user).with(@username).returns(@username)
+          add_command.expects(:find_list).with(@username, @board_name, @list_name).returns(list)
+
+          added_card = mock()
+          added_card.expects(:id).returns(@id)
+
+          create_options = {:list_id => @id, :name => @card_name}
+
+          Trello::Card.expects(:create).with(create_options).returns(added_card)
+
+          capture_output do
+            add_command.run([@board_name, @list_name, @card_name])
+          end
+        end
+
+        def test_execute_with_name_and_desc
+          config = mock()
+          config.expects(:username).returns(@username)
+          config.expects(:key).returns(@key)
+          config.expects(:token).returns(@token)
+
+          list = mock()
+          list.expects(:id).returns(@id)
+
+          add_command = Temjin::CardCommand::AddCommand.new('temjin card add', :config => config)
+          add_command.expects(:find_user).with(@username).returns(@username)
+          add_command.expects(:find_list).with(@username, @board_name, @list_name).returns(list)
+
+          added_card = mock()
+          added_card.expects(:id).returns(@id)
+
+          create_options = {:list_id => @id, :name => @card_name, :desc => @card_desc}
+
+          Trello::Card.expects(:create).with(create_options).returns(added_card)
+
+          capture_output do
+            add_command.run([@board_name, @list_name, @card_name, '--desc', @card_desc])
+          end
+        end
+      end
+    end
+  end
+end

data/test/temjin/card_command/list_command_test.rb

@@ -0,0 +1,47 @@
+module Temjin
+  module Test
+    module CardCommand
+      class ListCommandTest < MiniTest::Test
+        include CaptureOutput
+
+        def setup
+          @username = 'solid_snake'
+          @key = '0123456789abcdef0123456789abcdef'
+          @token = '0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef'
+
+          @board_name = 'fake_board'
+          @list_name = 'fake_list'
+          @id = '0123456789abcdef0123456789abcdef'
+          @card_name = "remind everyone that i'm no hero"
+          @card_desc = "uttered it a million times in metal gear solid 4"
+        end
+
+        def teardown; end
+
+        def test_run
+          config = mock('config')
+          config.expects(:username).returns(@username)
+          config.expects(:key).returns(@key)
+          config.expects(:token).returns(@token)
+
+          card = mock('card')
+          card.expects(:id).times(3).returns(@id)
+          card.expects(:name).times(3).returns(@card_name)
+          card.expects(:desc).times(3).returns(@card_desc)
+          card_list = [card, card, card]
+
+          list = mock('list')
+          list.expects(:cards).returns(card_list)
+
+          list_command = Temjin::CardCommand::ListCommand.new('temjin card list', :config => config)
+          list_command.expects(:find_user).with(@username).returns(@username)
+          list_command.expects(:find_list).with(@username, @board_name, @list_name).returns(list)
+
+          capture_output do
+            list_command.run([@board_name, @list_name])
+          end
+        end
+      end
+    end
+  end
+end

data/test/temjin/card_command/show_command_test.rb

@@ -0,0 +1,66 @@
+module Temjin
+  module Test
+    module CardCommand
+      class ShowCommandTest < MiniTest::Test
+        include CaptureOutput
+
+        def setup
+          @username = 'solid_snake'
+          @key = '0123456789abcdef0123456789abcdef'
+          @token = '0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef'
+
+          @board_name = 'fake_board'
+          @list_name = 'fake_list'
+          @label = 'fake_label'
+          @id = '0123456789abcdef0123456789abcdef'
+          @card_name = "remind everyone that i'm no hero"
+          @card_desc = "uttered it a million times in metal gear solid 4"
+        end
+
+        def teardown; end
+
+        def test_run
+          config = mock('config')
+          config.expects(:key).returns(@key)
+          config.expects(:token).returns(@token)
+
+          label = mock('label')
+          label.expects(:name).times(2).returns(@label)
+
+          card = mock('card')
+          card.expects(:list_id).returns(@id)
+          card.expects(:board_id).returns(@id)
+          card.expects(:member_ids).returns([@id, @id])
+          card.expects(:labels).returns([label, label])
+          card.expects(:name).returns(@card_name)
+          card.expects(:id).returns(@id)
+          card.expects(:short_url).returns('http://trello.com/fancyshorturl')
+          card.expects(:attachments).returns([])
+          card.expects(:closed?).returns(false)
+          card.expects(:due).times(2).returns(Time.now + (60 * 60 * 24))
+          card.expects(:checklists).returns([])
+          card.expects(:desc).times(2).returns(@card_desc)
+
+          user = mock('user')
+          user.expects(:username).times(2).returns(@username)
+
+          list = mock('list')
+          list.expects(:name).returns(@list_name)
+
+          board = mock('board')
+          board.expects(:name).returns(@board_name)
+
+          show_command = Temjin::CardCommand::ShowCommand.new('temjin card show', :config => config)
+          show_command.expects(:find_card).with(@id).returns(card)
+          show_command.expects(:find_list_by_id).with(@id).returns(list)
+          show_command.expects(:find_user).with(@id).times(2).returns(user)
+          show_command.expects(:find_board).with(@id).returns(board)
+
+          capture_output do
+            show_command.run([@id])
+          end
+        end
+      end
+    end
+  end
+end