# QiitaTrend [![Gem Version](https://badge.fury.io/rb/qiita_trend.svg)](https://badge.fury.io/rb/qiita_trend) [![MIT License](http://img.shields.io/badge/license-MIT-blue.svg?style=flat)](https://github.com/dodonki1223/qiita_trend/blob/master/LICENSE.txt) [![CircleCI](https://circleci.com/gh/dodonki1223/qiita_trend/tree/master.svg?style=svg)](https://circleci.com/gh/dodonki1223/qiita_trend/tree/master) Qiitaのトレンドを10秒で取得することができます ![qiita_trend_sample](qiita_trend.gif) ## 概要 - [Qiita](https://qiita.com/)のTOPページをスクレイピングしDaily、Weekly、Monthlyのトレンドを取得します - [Qiita](https://qiita.com/)のAPIにトレンドを取得する方法がないため - トレンドはDaily、Weekly、Monthlyそれぞれを日付と更新時間（5時と17時）の組み合わせごとにキャッシュを行います - Weekly、Monthlyに関してはQiitaにログインしないと取得できないためユーザー名とパスワード設定する必要があります（Dailyに関しては何も設定しなくても取得できます） - 過去のトレンドを取得することができます（**あくまでもキャッシュファイルから復元するためキャッシュファイルの無い過去のトレンドは取得することができません**） - いいね数は性質上取得した時の時間に依存します。どうしても現在時刻のいいね数が欲しい場合はキャシュファイルを手動で削除してもう一度実行してください ## ドキュメント [RubyDoc.info](https://rubydoc.info/github/dodonki1223/qiita_trend) ## 使用方法 `gem install qiita_trend`を実行する ```shell $ gem install qiita_trend ``` ### QiitaのDailyのトレンドを10秒で取得する ターミナルで`ruby -r qiita_trend -e "pp QiitaTrend::Trend.new.items"`を実行することでQiitaのトレンドを10秒（**gem install qiita_trendも含めて**）で取得できます ```shell $ ruby -r qiita_trend -e "pp QiitaTrend::Trend.new.items" [{"title"=>"2行でwebpack.config.jsで補完を効かせる方法", "user_name"=>"akameco", "user_image"=> "https://qiita-image-store.s3.amazonaws.com/0/15319/profile-images/1473684249", "user_page"=>"https://qiita.com/akameco", "article"=>"https://qiita.com/akameco/items/e12377e55e379d29636e", "created_at"=>"2019-08-05T01:17:34Z", "likes_count"=>158, "is_new_arrival"=>false}, {"title"=>"Excelで誰でも簡単言語処理 (感情推定, 固有表現抽出, キーワード抽出, 文類似度推定 etc...)", "user_name"=>"Harusugi", "user_image"=>"https://avatars2.githubusercontent.com/u/19549989?v=4", "user_page"=>"https://qiita.com/Harusugi", "article"=>"https://qiita.com/Harusugi/items/535874c0456dbc4db231", "created_at"=>"2019-08-04T23:01:22Z", "likes_count"=>103, "is_new_arrival"=>false}, ... ``` ### Dailyのトレンドの簡易表示 index + タイトル名 + いいね数 + ユーザー名 ```shell $ ruby -r qiita_trend -e "QiitaTrend::Trend.new.items.each_with_index {|t, i| puts '[' + i.to_s + ']' + t['title'] + '(' + t['likes_count'].to_s + ')' + ' - ' + t['user_name']}" [0]2行でwebpack.config.jsで補完を効かせる方法(158) - akameco [1]Excelで誰でも簡単言語処理 (感情推定, 固有表現抽出, キーワード抽出, 文類似度推定 etc...)(103) - Harusugi [2]コミュニケーション能力についてTwitterで打ち明けたら解決の糸口が見つかった話(109) - cyross4vocaloid [3]畑に農作物を植えてみたけど、忙しくて毎日水やりにいけないのに日照り続きでどうしたものかと悩んでいたら、自動で散水する方法を思いついて試してみたという話(86) - mix_dvd [4]KAGGLEでどこから手を付けていいか分からず学ぶことが多すぎてまとめてみた(89) - aokikenichi [5]畳み込みニューラルネットワークは何を見ているか(69) - okn-yu ``` ### Dailyのトレンドのタイトル一覧 ```shell $ ruby -r qiita_trend -e "QiitaTrend::Trend.new.items.each {|t| puts t['title']}" 2行でwebpack.config.jsで補完を効かせる方法 Excelで誰でも簡単言語処理 (感情推定, 固有表現抽出, キーワード抽出, 文類似度推定 etc...) コミュニケーション能力についてTwitterで打ち明けたら解決の糸口が見つかった話 畑に農作物を植えてみたけど、忙しくて毎日水やりにいけないのに日照り続きでどうしたものかと悩んでいたら、自動で散水する方法を思いついて試してみたという話 KAGGLEでどこから手を付けていいか分からず学ぶことが多すぎてまとめてみた 畳み込みニューラルネットワークは何を見ているか ``` ### Dailyのトレンドのうち`new`がついているものをブラウザで一括で開く ```shell $ ruby -r qiita_trend -e "QiitaTrend::Trend.new.new_items.each {|t| system('open ' + t['article'])}" ``` ## 自分のプロジェクトで使用する Gemfileにqiita_trendを追加する ```ruby gem 'qiita_trend' ``` Gemfileに追加したら`bundle install`してください ### Dailyのトレンドを取得する ```ruby daily_trend = QiitaTrend::Trend.new # Dailyのトレンドを全て取得する p daily_trend.items # DailyのトレンドでNEWのものだけを取得する p daily_trend.new_items ``` ### Weekly、Monthlyのトレンドを取得する WeeklyとMonthlyのトレンドを取得する時はQiitaにログインしている必要があるため、ログイン出来るユーザーとパスワードの設定が必要です ログインできないユーザー名とパスワードを指定している時は`LoginFailureError`の例外が発生します ```ruby # Qiitaにログインするためのユーザーとパスワードの設定をする QiitaTrend.configure do |config| config.user_name = 'ユーザー名' config.password = 'パスワード' end # Weeklyの全てのトレンドとNEWのものだけを取得 weekly_trend = QiitaTrend::Trend.new(QiitaTrend::TrendType::WEEKLY) p weekly_trend.items p weekly_trend.new_items # Monthlyの全てのトレンドとNEWのものだけを取得 monthly_trend = QiitaTrend::Trend.new(QiitaTrend::TrendType::MONTHLY) p monthly_trend.items p monthly_trend.new_items ``` ### キャッシュファイルからトレンドを取得する キャッシュファイルが存在しない場合は`NotExistsCacheError`の例外が発生します WeeklyもMonthlyの取得方法もDailyと同様です ```ruby # 2019年8月8日5時更新分のDailyのトレンドを取得する daily_trend_05 = QiitaTrend::Trend.new(QiitaTrend::TrendType::DAILY, '2019080805') p daily_trend_05.items p daily_trend_05.new_items # 2019年8月8日17時更新分のDailyのトレンドを取得する daily_trend_17 = QiitaTrend::Trend.new(QiitaTrend::TrendType::DAILY, '2019080817') p daily_trend_17.items p daily_trend_17.new_items ``` ### itemsメソッド、new_itemsメソッドについて itemsメソッド、new_itemsメソッドは`Array`を返します Array一つ一つは`Hash`になります ```shell irb(main):002:0> QiitaTrend::Trend.new.items.class => Array irb(main):003:0> QiitaTrend::Trend.new.items[0].class => Hash ``` Hashは以下の構成になっています ```shell irb(main):001:0> pp QiitaTrend::Trend.new.items[0] {"title"=>"2行でwebpack.config.jsで補完を効かせる方法", "user_name"=>"akameco", "user_image"=> "https://qiita-image-store.s3.amazonaws.com/0/15319/profile-images/1473684249", "user_page"=>"https://qiita.com/akameco", "article"=>"https://qiita.com/akameco/items/e12377e55e379d29636e", "created_at"=>"2019-08-05T01:17:34Z", "likes_count"=>158, "is_new_arrival"=>false} ```
key 内容 備考
title 記事タイトル
user_name ユーザー名
user_image ユーザー画像URL
user_page ユーザーページ
article 記事のURL
created_at 記事作成日
likes_count いいね数 数値が入ります
is_new_arrival 「NEW」のついている記事か TrueかFalseが入ります
### キャシュファイルの出力先を変更する キャッシュファイルはデフォルトだと`ユーザーのHOMEディレクトリ/qiita_cache/`に出力されます ``` /Users/dodonki1223/qiita_cache/2019080205_daily.html /Users/dodonki1223/qiita_cache/2019080205_weekly /Users/dodonki1223/qiita_cache/2019080205_monthly.html ``` プログラムで下記のように追記してください ```ruby # キャッシュの出力先ディレクトリを変更する # ユーザーのHOMEディレクトリ配下のhogeディレクトリに出力する設定 # /Users/dodonki1223/hoge/ QiitaTrend.configure do |config| config.cache_directory = Dir.home + '/hoge/' end ``` ## 注意 このgemは勉強用で作成したものでソースにはアンチパターンなコメント（処理を説明するようなコメントなど）が書かれています。そこはご容赦ください