NOTO

trello APIでカードの名前を取得してみる

はじめに

kanban 系のタスク管理ツールを探していて会社の人に教えてもらいました。
これは結構良さそうだったので、いつもどおりタスク管理ツールからタスクを抜き出すスクリプトを書いてみました。

環境

• ruby 2.2.3p173
• MAC OS X (El Capitain)
  ※ windowsでも多分動くと思うのですが API tokenは事前に取得している前提です

コード

先に書いたコードを記載します。

require 'open-uri'
require 'json'

module MyTrello
class Task
def initialize(name, key, token)
@name = name
@key = key
@token = token
end

def boards
responce = open(boards_url)
code, message = responce.status
if code == '200'
@json = JSON.parse(responce.read)
end
# @json
end

def lists(boardname)
@boardname = boardname
boards
board_id
responce = open(lists_url)
code, message = responce.status
if code == '200'
@listjson = JSON.parse(responce.read)
end
end

def cards(boardname, listname)
@boardname = boardname
@listname = listname
lists(boardname)
list_id
responce = open(cards_url)
code, message = responce.status
if code == '200'
@cardjson = JSON.parse(responce.read)
end
@cardjson
end

def cardnames(boardname, listname)
cards(boardname, listname).collect do |card|
card['name']
end
end

private
def board_id
@json.each do |board|
if board['name'] == @boardname
@board_id = board['id']
end
end
end

def list_id
@listjson.each do |list|
if list['name'] == @listname
@list_id = list['id']
end
end
@list_id
end

def boards_url
"https://trello.com/1/members/#{@name}/boards?key=#{@key}&token=#{@token}"
end

def lists_url
"https://trello.com/1/boards/#{@board_id}/lists?key=#{@key}&token=#{@token}"
end

def cards_url
"https://trello.com/1/lists/#{@list_id}/cards?key=#{@key}&token=#{@token}"
end
end
end

こんな感じです。
単純ですね。

使い方

pryでrequireして例で出します。
そして今回取り出すデータ元はこんな感じです。

$ pry -r ./mytrello.rb

mytrello.rbは上記コードが書いてあるファイルです
とりあえずイニシャライズします。

[4] pry(main)> name = "username"
=> "username"
[5] pry(main)> key = "000000000000000000000000000000"
=> "000000000000000000000000000000"
[6] pry(main)> token = "1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a"
=> "1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a"
[7] pry(main)> trello = MyTrello::Task.new(name, key, token)
=> #<MyTrello::Task:0x007fe47486a488
@key="000000000000000000000000000000",
@name="username",
@token=
"1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a">

key, name, tokenの値は各自のものを入れます。
つづいて実際に実行してみます。用意しているコマンドは以下です。
すべて、インスタンスメソッドです。

• boards

• ボード一覧のjsonデータを出します

• lists(boardname)

• リスト一覧のjsonデータを出します

• cards(boardname, listname)

• カード一覧のjsonデータを出します

• cardnames(boardname, listname)

• カード一覧の名前を配列で返します。 実際のイメージです。

  boards

  pry(main)> trello.boards => [{"name"=>"Doing", "desc"=>"", "descData"=>nil, "closed"=>true, "idOrganization"=>"56306c68cd4e76bda747e2c7", "pinned"=>nil, "invitations"=>nil, "shortLink"=>"aibKU27g", "powerUps"=>[], "dateLastActivity"=>nil, "idTags"=>[], "id"=>"56306dafd00fd151baf7edbf", "invited"=>false, "starred"=>false, "url"=>"https://trello.com/b/aibKU27g/doing", "prefs"=> {"permissionLevel"=>"private", "voting"=>"disabled", "comments"=>"members", 略

  boards collectしてみる

  trelloがjsonで介してくれるので、これをいじっていけばいい感じにいけますよね。

  [13] pry(main)> trello.boards.collect{|board| board['name']} => ["Doing", "In Progress", "Tasks", "Welcome Board", "あまりにも秘密のプロジェクト"]

  lists

  [15] pry(main)> trello.lists("あまりにも秘密のプロジェクト") => [{"id"=>"56306e48cd95adfabb7d3fa1", "name"=>"In Progress", "closed"=>false, "idBoard"=>"56306e3d0220e708273b8c6b", "pos"=>65535, "subscribed"=>false}, {"id"=>"56306e4f54ac86c9201683f1", "name"=>"Doing", "closed"=>false, "idBoard"=>"56306e3d0220e708273b8c6b", "pos"=>131071, "subscribed"=>false}, {"id"=>"56306e5230ac095b026eaa84", "name"=>"Done", "closed"=>false, "idBoard"=>"56306e3d0220e708273b8c6b", "pos"=>196607, "subscribed"=>false}]

  listsをcollectしてみる

  [16] pry(main)> trello.lists("あまりにも秘密のプロジェクト").collect{|list| list['name']} => ["In Progress", "Doing", "Done"]

  cards

  [17] pry(main)> trello.cards("あまりにも秘密のプロジェクト", "In Progress)=> [{"id"=>"56306ff0800225dd8f7bb59a", "checkItemStates"=>[], "closed"=>false, "dateLastActivity"=>"2015-10-28T06:49:24.639Z", "desc"=>"", "descData"=>nil, "idBoard"=>"56306e3d0220e708273b8c6b", "idList"=>"56306e48cd95adfabb7d3fa1", "idMembersVoted"=>[], "idShort"=>5, "idAttachmentCover"=>nil, "manualCoverAttachment"=>false, "idLabels"=>[], "name"=>"どうしようもなく秘密のラベリングを考える", "pos"=>131071, "shortLink"=>"9Ml4KdoQ", "badges"=> {"votes"=>0, "viewingMemberVoted"=>false, "subscribed"=>true, "fogbugz"=>"", "checkItems"=>0, "checkItemsChecked"=>0, "comments"=>0, "attachments"=>0, "description"=>false, "due"=>nil}, "due"=>nil,

  nameばっかりで芸が無いので。

  [18] pry(main)> trello.cardnames("あまりにも秘密のプロジェクト", "In Progress")=> ["どうしようもなく秘密のラベリングを考える", "trelloでタスク管理すればみんな幸せなのに！", "これで会話してるみたいに見える?"]

  という風にできる感じをチョロっと書いてみました。

  終わりに

  WunderlistのAPIもそうですが、簡単にjson形式でデータが抜き出せるのでこれを別なところに連携するということあ比較的用意です。私の場合は日報を書くのが手間なので、普段の仕事をタスク管理ツールで行って、そこで完了した作業を少し加工して使用します。今回のコードで言うと

  trello.cardsname(boardname, listname).collect{|cardname| "■ #{cardname}"}.sort

  とかして、タスク自体にグルーピングした名前とかつけて投げるだけみたいなことをしてます。