Qiita:Team Reporter

This creates a report based on daily reports in your Qiita:Team.

TL;DR

cd ./exe
./list_daily_reports yasulab

# ...
# 2018-07-24, Railsガイド, 8h, Railsガイド5.1更新準備を進めた
# 2018-07-25, Railsガイド, 8h, Railsガイドの翻訳作業を進めた
# 2018-07-26, Railsガイド, 8h, Railsガイドの新機能の開発を進めた

This requires the following environment variables.

• QIITA_TEAM: Qiita:Team subdomain like yasslab
• QIITA_ACCESS_TOKEN: See #アクセストークンの発行 at the bottom.

できること

本リポジトリにあるスクリプトを使うと、下記が実行できます。

• Qiita:Team内の特定のタグがついている投稿を取り出す
• 取り出した結果を投稿者のidで絞り込む
• 取り出した結果からタイトルだけを出力する

例えば特定のタグを取得して、最後に| sort > report.csv などと繋げることで、日報から様々なレポートを作ることも可能です。

例: 特定タグの投稿を取り出す方法

qiitaコマンドで特定タグの記事を取得することができます。

% qiita list_tag_items 日報/2017/09 -t yasslab

ページネーションのパラメータを指定すると、最大で100件ずつ取得することができます。

% qiita list_tag_items 日報/2017/09 per_page=100 page=1 -t yasslab 

jqコマンドを使えば、特定の投稿者のidで絞り込むことができます。

# 特定タグの記事を100件取得する
% qiita list_tag_items 日報/2017/09 per_page=100 page=1 -t yasslab | jq '.[] | .title'

# 特定タグの記事で、yasulabが投稿した記事を100件取得する
% qiita list_tag_items 日報/2017/09 per_page=100 page=1 -t yasslab | jq -r '.[] | select(.user.id == "yasulab") | .title'

• 📝 NOTE: 1ページにその人の投稿が1つもない状態はほぼ起きないはずなので、上記コマンドのpage=の数字を増やしながら実行したり、結果が空になるまで取得するという処理にしても良さそうです。
• 📝 NOTE: 404が返るまでpage=nのパラメータ渡すのを繰り返してjqでcatするシェルスクリプト書けばRuby必要ないかも? 🤔

別案: Rubyでタグが付いた記事を取得する

require 'qiita'
client = Qiita::Client.new(team: 'yasslab', access_token: ENV['QIITA_ACCESS_TOKEN'])
res = client.list_tag_items('日報/2017/09')
puts res.body.map {|i| i["title"] }

# 2017-09-08, YassLab, 1h, テンプレートに合わせてタグ修正
# ...

参考: qiita コマンドの使い方

詳細は下記ドキュメントを参考に。 http://www.rubydoc.info/gems/qiita

Qiita:Team API v2

• リリースノート: http://blog.qiita.com/post/98796001374/qiita-api-v2
• ドキュメント: http://qiita.com/api/v2/docs

ここから個人用アクセストークンを発行して使うのが一番手軽
https://qiita.com/settings/applications

アクセストークンの発行

Qiitaのアカウント管理のアプリケーションの個人用アクセストークンを発行するから発行できます
https://qiita.com/settings/applications

とりあえずQiita:Teamにだけアクセス出来ればよいので以下にチェックを入れて発行。

• ✅ read_qiita_team

アクセストークンの管理

qiita gemは環境変数のQIITA_ACCESS_TOKENにアクセストークンが設定されている場合CLIツールではそれを使う

Accepts access token via -a, --access-token or QIITA_ACCESS_TOKEN environment variable. https://github.com/increments/qiita-rb#access-token

発行したアクセストークンはenvchainなどで環境変数に入れておく

% envchain --set qiita-team-reporter QIITA_ACCESS_TOKEN

qiitaコマンドをirbで試してみる

次のようにenvchainなどに保存した環境変数を経由してirbで試してみる

% envchain qiita-team-reporter irb

チームの記事を取る場合はteamオプションを設定する

require 'qiita'
client = Qiita::Client.new(team: 'yasslab', access_token: ENV['QIITA_ACCESS_TOKEN'])
res = client.list_items
res.body.first.fetch('title')
# => "ライブラリを作るときpublicで書き始めた方がいい理由"

LICENSE

Copyright © YassLab.