qiita_trend 0.2.7 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9430a869aefef938378e0c222578100dbd2b0d741e9dc72456785a9af315233d
-  data.tar.gz: 3f338bddc0525275dc6238a16ff33cf872f732afe11a1b945ab7f0618149317a
+  metadata.gz: 86c478970ed3fc2c6b1d85799568243708a808abcf4bff7ecaf580a4746777ff
+  data.tar.gz: 1e8d0f15b5fbf4827b6f00e713cbdeb282ca454f0580341df52d2e43f1b14c79
 SHA512:
-  metadata.gz: 642c8ebfc58b9816b694d18ce5d32cd4c37c390c2fde42b559eb20cd732c262f7cb9b7c3caee82e3924a87bfe1d5ebef08383befa88bd61ca533f70137a28205
-  data.tar.gz: 35415ff58aa1923a2a2cfbde6607b0e2a9dafa21a1ccfcf70977f709d109574b677ff1ca5632dbc543fa6114b77859b611efc4fe7ad2bf8846681830af22e911
+  metadata.gz: 23fd963cf5d79abf44f61411207aff1fed090e70a4a0b7478e0456f19bfef324fe723134562afdf0115b41d70a507f72eddfbb7410009e8561d7d02959417923
+  data.tar.gz: 64c83098b9e44e58b1b3108d935e940095b7a9f58b628bff412e8c1d33a0098edc78826140e4775c84226629771ccddf5a4459914c14f4185eaadf4f3c1ee8e7

data/.circleci/config.yml

@@ -6,54 +6,59 @@ version: 2
 jobs:
   build:
     docker:
-      # specify the version you desire here
-      - image: circleci/ruby:2.6.0-node-browsers
+      - image: circleci/ruby:2.6.0
         environment:
-          BUNDLER_VERSION: 2.0.1
-
-      # Specify service dependencies here if necessary
-      # CircleCI maintains a library of pre-built images
-      # documented at https://circleci.com/docs/2.0/circleci-images/
-      # - image: circleci/postgres:9.4
+          BUNDLE_PATH: vendor/bundle
 
     working_directory: ~/repo
 
     steps:
       - checkout
-      # Download and cache dependencies
+
+      # Install Bundler
+      # ref:https://discuss.circleci.com/t/using-bundler-2-0-during-ci-fails/27411
+      - run:
+          name: Install Bundler
+          command: |
+            echo 'export BUNDLER_VERSION=$(cat Gemfile.lock | tail -1 | tr -d " ")' >> $BASH_ENV
+            source $BASH_ENV
+            gem install bundler
+
+      # Which version of bundler?
+      - run:
+          name: Which bundler?
+          command: bundle -v
+
+      # Restore bundle cache
+      # Read about caching dependencies: https://circleci.com/docs/2.0/caching/
       - restore_cache:
           keys:
             - v1-dependencies-{{ checksum "Gemfile.lock" }}
             # fallback to using the latest cache if no exact match is found
             - v1-dependencies-
-      # install Bundler!
-      # ref:https://discuss.circleci.com/t/using-bundler-2-0-during-ci-fails/27411
-      - run:
-          name: install bundler
-          command: |
-            sudo gem update --system
-            sudo gem uninstall bundler
-            sudo rm /usr/local/bin/bundle
-            sudo rm /usr/local/bin/bundler
-            sudo gem install bundler
-      # install gem!
+
+      # Install gem
       - run:
-          name: install gem
+          name: Install gem
           command: |
             # jobs=4は並列処理をして高速化するための設定（４つのjobで実行するって意味）
             bundle check --path=vendor/bundle || bundle install --path=vendor/bundle --jobs=4 --retry=3
+
+      # Store bundle cache for Ruby dependencies
       - save_cache:
           paths:
             - ./vendor/bundle
           key: v1-dependencies-{{ checksum "Gemfile.lock" }}
-      # run rubocop!
+
+      # Run RuboCop
       - run:
-          name: run rubocop
+          name: Run RuboCop
           command: |
             bundle exec rubocop
-      # run tests!
+
+      # Run tests
       - run:
-          name: run tests
+          name: Run tests
           command: |
             TEST_FILES="$(circleci tests glob "spec/**/*_spec.rb" | circleci tests split --split-by=timings)"
             bundle exec rspec \
@@ -62,7 +67,14 @@ jobs:
               --out test_results/rspec.xml \
               --format progress \
               $TEST_FILES
-      # collect reports
+
+      # Create document
+      - run:
+          name: Create document
+          command: |
+            bundle exec yard
+
+      # Collect Reports
       - store_test_results:
           path: test_results
       - store_artifacts:
@@ -73,14 +85,68 @@ jobs:
           # カバレッジの結果をcoverage-resultsディレクトリに吐き出す
           path: coverage
           destination: coverage-results
-      # deploy RubyGems
-      - deploy:
+      - store_artifacts:
+          # ドキュメントの結果をyard-resultsディレクトリに吐き出す
+          path: ./doc
+          destination: yard-results
+
+  deploy:
+    docker:
+      - image: circleci/ruby:2.6.0
+
+    steps:
+      - checkout
+
+      # Install Bundler
+      # ref:https://discuss.circleci.com/t/using-bundler-2-0-during-ci-fails/27411
+      - run:
+          name: install Bundler
           command: |
-            if [ "${CIRCLE_BRANCH}" == "master" ]; then
-              mkdir ~/.gem
-              curl -u dodonki1223:$RUBYGEMS_PASSWORD https://rubygems.org/api/v1/api_key.yaml > ~/.gem/credentials; chmod 0600 ~/.gem/credentials
-              git config user.name dodonki1223
-              git config user.email $RUBYGEMS_EMAIL
-              bundle exec rake build
-              bundle exec rake release
-            fi
+            echo 'export BUNDLER_VERSION=$(cat Gemfile.lock | tail -1 | tr -d " ")' >> $BASH_ENV
+            source $BASH_ENV
+            gem install bundler
+
+      # Which version of bundler?
+      - run:
+          name: Which bundler?
+          command: bundle -v
+
+      # Restore bundle cache
+      # Read about caching dependencies: https://circleci.com/docs/2.0/caching/
+      - restore_cache:
+          keys:
+            - v1-dependencies-{{ checksum "Gemfile.lock" }}
+            - v1-dependencies-
+
+      # Install gem
+      - run:
+          name: Install gem
+          command: bundle check --path vendor/bundle || bundle install
+
+      # Store bundle cache for Ruby dependencies
+      - save_cache:
+          key: v1-dependencies-{{ checksum "Gemfile.lock" }}
+          paths:
+            - vendor/bundle
+
+      # Deploy RubyGems
+      - run:
+          name: Deploy RubyGems
+          command: |
+            curl -u dodonki1223:$RUBYGEMS_PASSWORD https://rubygems.org/api/v1/api_key.yaml > ~/.gem/credentials; chmod 0600 ~/.gem/credentials
+            git config user.name dodonki1223
+            git config user.email $RUBYGEMS_EMAIL
+            bundle exec rake build
+            bundle exec rake release
+
+workflows:
+  version: 2
+  build-and-deploy:
+    jobs:
+      - build
+      - deploy:
+          requires:
+            - build
+          filters:
+            branches:
+              only: master # masterブランチの時だけDeployJobを実行するようにする

data/.gitignore

@@ -6,9 +6,11 @@
 /pkg/
 /spec/reports/
 /tmp/
+/vendor/
 
 # rspec failure tracking
 .rspec_status
 
 /cache/
-/spec/vcr/
+/spec/vcr/
+/vendor/

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    qiita_trend (0.2.7)
+    qiita_trend (0.3.2)
       mechanize
       nokogiri (~> 1.9)
 
@@ -39,7 +39,7 @@ GEM
     net-http-digest_auth (1.4.1)
     net-http-persistent (3.1.0)
       connection_pool (~> 2.2)
-    nokogiri (1.10.3)
+    nokogiri (1.10.4)
       mini_portile2 (~> 2.4.0)
     ntlm-http (0.1.1)
     parallel (1.17.0)
@@ -89,6 +89,7 @@ GEM
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
     webrobots (0.1.2)
+    yard (0.9.20)
 
 PLATFORMS
   ruby
@@ -104,6 +105,7 @@ DEPENDENCIES
   simplecov
   vcr
   webmock
+  yard
 
 BUNDLED WITH
    2.0.2

data/README.md

@@ -14,37 +14,23 @@ Qiitaのトレンドを10秒で取得することができます
 - 過去のトレンドを取得することができます（**あくまでもキャッシュファイルから復元するためキャッシュファイルの無い過去のトレンドは取得することができません**）
 - いいね数は性質上取得した時の時間に依存します。どうしても現在時刻のいいね数が欲しい場合はキャシュファイルを手動で削除してもう一度実行してください
 
-## インストール
+## ドキュメント
 
-Add this line to your application's Gemfile:
+[RubyDoc.info](https://rubydoc.info/github/dodonki1223/qiita_trend)
 
-```ruby
-gem 'qiita_trend'
-```
-
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
+## 使用方法
 
-    $ gem install qiita_trend
+`gem install qiita_trend`を実行する
 
-## 使用方法
+```shell
+$ gem install qiita_trend
+```
 
 ### QiitaのDailyのトレンドを10秒で取得する
 
-ターミナルでコマンド`gem install qiita_trend`、`ruby -r qiita_trend -e "pp QiitaTrend::Trend.new.items"`を実行することでQiitaのトレンドを10秒で取得できます  
+ターミナルで`ruby -r qiita_trend -e "pp QiitaTrend::Trend.new.items"`を実行することでQiitaのトレンドを10秒（**gem install qiita_trendも含めて**）で取得できます  
 
 ```shell
-$ gem install qiita_trend
-Fetching qiita_trend-0.2.3.gem
-Successfully installed qiita_trend-0.2.3
-Parsing documentation for qiita_trend-0.2.3
-Installing ri documentation for qiita_trend-0.2.3
-Done installing documentation for qiita_trend after 0 seconds
-1 gem installed
-
 $ ruby -r qiita_trend -e "pp QiitaTrend::Trend.new.items"
 [{"title"=>"2行でwebpack.config.jsで補完を効かせる方法",
   "user_name"=>"akameco",
@@ -66,11 +52,7 @@ $ ruby -r qiita_trend -e "pp QiitaTrend::Trend.new.items"
   ...
 ```
 
-### ワンライナーで使ってみる
-
-先に`gem install qiita_trend`を実行しておくこと
-
-#### Dailyのトレンドの簡易表示
+### Dailyのトレンドの簡易表示
 
 index + タイトル名 + いいね数 + ユーザー名
 
@@ -85,7 +67,7 @@ $ ruby -r qiita_trend -e "QiitaTrend::Trend.new.items.each_with_index {|t, i| pu
 [5]畳み込みニューラルネットワークは何を見ているか(69) - okn-yu
 ```
 
-#### Dailyのトレンドのタイトル一覧
+### Dailyのトレンドのタイトル一覧
 
 ```shell
 $ ruby -r qiita_trend -e "QiitaTrend::Trend.new.items.each {|t| puts t['title']}"
@@ -98,7 +80,7 @@ KAGGLEでどこから手を付けていいか分からず学ぶことが多す
 畳み込みニューラルネットワークは何を見ているか
 ```
 
-#### Dailyのトレンドのうち`new`がついているものをブラウザで一括で開く
+### Dailyのトレンドのうち`new`がついているものをブラウザで一括で開く
 
 ```shell
 $ ruby -r qiita_trend -e "QiitaTrend::Trend.new.new_items.each {|t| system('open ' + t['article'])}"
@@ -129,6 +111,7 @@ p daily_trend.new_items
 ### Weekly、Monthlyのトレンドを取得する
 
 WeeklyとMonthlyのトレンドを取得する時はQiitaにログインしている必要があるため、ログイン出来るユーザーとパスワードの設定が必要です
+ログインできないユーザー名とパスワードを指定している時は`LoginFailureError`の例外が発生します
 
 ```ruby
 # Qiitaにログインするためのユーザーとパスワードの設定をする
@@ -148,6 +131,25 @@ 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`を返します
@@ -175,16 +177,57 @@ irb(main):001:0> pp QiitaTrend::Trend.new.items[0]
  "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が入ります |
+<table>
+  <thead>
+    <tr>
+      <th>key</th>
+      <th>内容</th>
+      <th>備考</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>title</td>
+      <td>記事タイトル</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td>user_name</td>
+      <td>ユーザー名</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td>user_image</td>
+      <td>ユーザー画像URL</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td>user_page</td>
+      <td>ユーザーページ</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td>article</td>
+      <td>記事のURL</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td>created_at</td>
+      <td>記事作成日</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td>likes_count</td>
+      <td>いいね数</td>
+      <td>数値が入ります</td>
+    </tr>
+    <tr>
+      <td>is_new_arrival</td>
+      <td>「NEW」のついている記事か</td>
+      <td>TrueかFalseが入ります</td>
+    </tr>
+  </tbody>
+</table>
 
 ### キャシュファイルの出力先を変更する
 

data/lib/qiita_trend.rb

@@ -7,6 +7,9 @@ require 'qiita_trend/cache'
 require 'qiita_trend/configuration'
 require 'qiita_trend/trend_type'
 require 'qiita_trend/target'
+require 'qiita_trend/error/syntax_error'
+require 'qiita_trend/error/login_failure_error'
+require 'qiita_trend/error/not_exists_cache_error'
 
 module QiitaTrend
 end

data/lib/qiita_trend/cache.rb

@@ -1,14 +1,23 @@
 # frozen_string_literal: true
 
 module QiitaTrend
+  # Qiitaのトレンドをキャッシュする機能を提供する
   class Cache
-    attr_reader :file_name, :directory, :full_path
+    # @return [String] ファイル名
+    attr_reader :file_name
+    # @return [String] キャッシュファイルを格納するディレクトリ（デフォルト値はDEFAULT_CACHE_DIRECTORYになります）
+    attr_reader :directory
+    # @return [String] キャッシュファイルへのフルパス
+    attr_reader :full_path
 
     # キャッシュファイルが格納されるデフォルトのディレクトリ
     DEFAULT_CACHE_DIRECTORY = Dir.home + '/qiita_cache/'
 
     # コンストラクタ
-    #   クラス内で使用するインスタンス変数をセットする
+    # Cacheクラスのインスタンスを返します
+    #
+    # @param [String] file_name ファイル名
+    # @param [String] directory キャッシュが格納する・されているディレクトリ
     def initialize(file_name, directory = DEFAULT_CACHE_DIRECTORY)
       @file_name = file_name
       @directory = directory
@@ -16,7 +25,9 @@ module QiitaTrend
     end
 
     # キャッシュファイルを作成する
-    #   キャッシュフォルダが存在しない時は作成する
+    # ※キャッシュフォルダが存在しない場合は作成します
+    #
+    # @param [String] content 書き込む内容
     def create_cache(content)
       Dir.mkdir(@directory) unless Dir.exist?(@directory)
       File.open(@full_path, 'wb') do |file|
@@ -25,20 +36,18 @@ module QiitaTrend
     end
 
     # キャッシュファイルを読み込む
+    # File.openを使用しファイルを読み込みます
+    #
+    # @return [Object]
     def load_cache
       File.open(@full_path, 'r', &:read)
     end
 
-    # キャッシュファイルが存在するか？
+    # キャッシュファイルが存在するかどうかを判定します
+    #
+    # @return [Boolean]
     def cached?
       File.exist?(@full_path)
     end
-
-    # キャッシュファイルをクリアする
-    def clear_cache
-      File.delete(@full_path) if cached?
-    rescue StandardError => e
-      raise e.class, 'キャッシュファイルの削除に失敗しました'
-    end
   end
 end

data/lib/qiita_trend/configuration.rb

@@ -11,9 +11,17 @@ module QiitaTrend
     end
   end
 
+  # QiitaTrendのConfigの設定する機能を提供する
   class Configuration
-    attr_accessor :user_name, :password, :cache_directory
+    # @return [String] Qiitaにログインするためのユーザー名
+    attr_accessor :user_name
+    # @return [String] Qiitaにログインするためのパスワード
+    attr_accessor :password
+    # @return [String] キャッシュファイルを保存するディレクトリ
+    attr_accessor :cache_directory
 
+    # コンストラクタ
+    # Configurationクラスのインスタンスを返します
     def initialize
       @user_name = nil
       @password = nil

data/lib/qiita_trend/error/login_failure_error.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module QiitaTrend
+  module Error
+    # Qiitaへログイン失敗時に発生するエラークラス
+    class LoginFailureError < ::QiitaTrend::Error::SyntaxError
+      # エラーメッセージを返します
+      # ログインに失敗した時のユーザー名とパスワードを含んだ形でメッセージを返します
+      #
+      # @return [String] エラーメッセージ
+      def message
+        "Login failed, Please confilm user_name and password(user:#{user_name},password:#{password})"
+      end
+
+      # ログインに失敗した時のユーザー名を返します
+      #
+      # @return [String] ユーザー名(Configの設定したユーザー名)
+      def user_name
+        QiitaTrend.configuration.user_name
+      end
+
+      # ログインに失敗した時のパスワードを返します
+      #
+      # @return [String] パスワード(Configの設定したパスワード)
+      def password
+        QiitaTrend.configuration.password
+      end
+    end
+  end
+end

data/lib/qiita_trend/error/not_exists_cache_error.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module QiitaTrend
+  module Error
+    # キャッシュファイルが存在しない時に発生するエラークラス
+    # キャッシュファイルからトレンドを取得する時、存在しないキャッシュファイルを指定した時に発生する
+    class NotExistsCacheError < ::QiitaTrend::Error::SyntaxError
+      # @return [Cache] Cacheクラス
+      attr_reader :cache
+
+      # コンストラクタ
+      #
+      # @param [Cache] cache キャッシュクラス
+      def initialize(cache)
+        @cache = cache
+      end
+
+      # エラーメッセージを返します
+      # 読み込もうとしたキャッシュファイルのフルパス含んだ形でメッセージを返します
+      #
+      # @return [String] エラーメッセージ
+      def message
+        "Does not exist cache file #{@cache.full_path}"
+      end
+    end
+  end
+end

data/lib/qiita_trend/error/syntax_error.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module QiitaTrend
+  module Error
+    # qiita_trendのエラーの機能を提供する
+    class SyntaxError < ::StandardError
+    end
+  end
+end

data/lib/qiita_trend/page.rb

@@ -3,12 +3,26 @@
 require 'mechanize'
 
 module QiitaTrend
+  # Qiitaのページをスクレイピングしページ情報を取得する機能を提供する
   class Page
-    attr_reader :target, :html, :cache
+    # @return [TrendType] トレンドタイプ（TrendType::DAILY,TrendType::WEEKLY,TrendType::MONTHLY）
+    attr_reader :target
+    # @return [String] Qiitaページのスクレイピング結果
+    attr_reader :html
+    # @return [Cache] Cacheクラス
+    attr_reader :cache
 
+    # QiitaのTOPページURL
     QIITA_URI = 'https://qiita.com/'
+    # QiitaのログインページURL
     QIITA_LOGIN_URI = 'https://qiita.com/login'
 
+    # コンストラクタ
+    #
+    # @param [TrendType] trend_type トレンドタイプ
+    # @param [String] date 「YYYYMMDD05」,「YYYYMMDD17」形式のどちらか
+    # @raise [LoginFailureError] ログインに失敗した時に発生する
+    # @raise [NotExistsCacheError] 存在しないキャッシュファイルを指定した時に発生する
     def initialize(trend_type = TrendType::DAILY, date = nil)
       @target = Target.new(trend_type, date)
       save_cache_directory = QiitaTrend.configuration.cache_directory.nil? ? Cache::DEFAULT_CACHE_DIRECTORY : QiitaTrend.configuration.cache_directory
@@ -16,7 +30,7 @@ module QiitaTrend
 
       # 指定されたキャッシュファイルが存在しない場合は処理を終了
       unless date.nil?
-        raise StandardError, '指定されたキャッシュファイルが存在しません' unless @cache.cached?
+        raise Error::NotExistsCacheError, @cache unless @cache.cached?
       end
 
       # キャッシュが存在する場合はキャッシュから取得
@@ -28,20 +42,30 @@ module QiitaTrend
 
     private
 
+    # Qiitaのページをスクレイピングした結果を取得します
+    #
+    # @param [Target] target Targetクラス
+    # @raise [LoginFailureError] ログインに失敗した時に発生する
+    # @return [String] Qiitaをスクレイピングした結果
     def create_html(target)
       agent = Mechanize.new
       agent.user_agent_alias = 'Mac Safari'
+      login_qiita(agent) if target.need_login
+      agent.get(target.url).body
+    end
 
-      # ログイン処理
-      if target.need_login
-        form = agent.get(QIITA_LOGIN_URI).forms.first
-        form['identity'] = QiitaTrend.configuration.user_name
-        form['password'] = QiitaTrend.configuration.password
-        logged_page = form.submit
-        raise StandardError, 'ログインに失敗しました（ユーザー名とパスワードでログインできることを確認してください）' if logged_page.title.include?('Login')
-      end
+    # Qiitaへログインする
+    #
+    # @param [Mechanize] agent Mechanizeクラス
+    # @raise [LoginFailureError] ログインに失敗した時に発生する
+    def login_qiita(agent)
+      form = agent.get(QIITA_LOGIN_URI).forms.first
+      form['identity'] = QiitaTrend.configuration.user_name
+      form['password'] = QiitaTrend.configuration.password
+      logged_page = form.submit
 
-      agent.get(target.url).body
+      # ページのタイトルにLoginが含まれていたらログイン失敗とする
+      raise Error::LoginFailureError if logged_page.title.include?('Login')
     end
   end
 end

data/lib/qiita_trend/target.rb

@@ -1,9 +1,21 @@
 # frozen_string_literal: true
 
 module QiitaTrend
+  # Qiitaの対象のトレンドの機能を提供する
   class Target
-    attr_reader :type, :url, :need_login, :cache
+    # @return [TrendType] トレンドタイプ（TrendType::DAILY,TrendType::WEEKLY,TrendType::MONTHLY）
+    attr_reader :type
+    # @return [String] トレンドを取得するQiitaのページURL
+    attr_reader :url
+    # @return [Boolean] Qiitaへのログインが必要かどうか
+    attr_reader :need_login
+    # @return [String] キャッシュファイル名
+    attr_reader :cache
 
+    # コンストラクタ
+    #
+    # @param [TrendType] trend_type トレンドタイプ
+    # @param [String] date 「YYYYMMDD05」,「YYYYMMDD17」形式のどちらか
     def initialize(trend_type = TrendType::DAILY, date = nil)
       @type = trend_type
       @url = trend_url(trend_type)
@@ -13,6 +25,10 @@ module QiitaTrend
 
     private
 
+    # トレンドのURLを取得する
+    #
+    # @param [TrendType] type トレンドタイプ
+    # @return [String] トレンドを取得するQiitaのページURL
     def trend_url(type)
       case type
       when TrendType::DAILY then 'https://qiita.com/'
@@ -21,6 +37,12 @@ module QiitaTrend
       end
     end
 
+    # キャッシュ名を取得する
+    # キャシュ名はYYYYMMDD05_daily.html,YYYYMMDD17_weekly.htmlなどの形式になります
+    # dateが指定されていなかったら現在時刻からキャッシュファイル名を作成し指定されていたらそのdateからキャッシュ名を取得する
+    #
+    # @param [TrendType] type トレンドタイプ
+    # @param [String] date 「YYYYMMDD05」,「YYYYMMDD17」形式のどちらか
     def cache_name(type, date)
       return "#{date}_#{type}.html" unless date.nil?
 

data/lib/qiita_trend/trend.rb

@@ -3,11 +3,20 @@
 require 'nokogiri'
 require 'open-uri'
 require 'json'
+require 'uri'
 
 module QiitaTrend
+  # Qiitaのトレンドの機能を提供する
   class Trend
+    # @return [Array] トレンドデータ
     attr_reader :data
 
+    # コンストラクタ
+    #
+    # @param [TrendType] trend_type トレンドタイプ
+    # @param [String] date 「YYYYMMDD05」,「YYYYMMDD17」形式のどちらか
+    # @raise [LoginFailureError] ログインに失敗した時に発生する
+    # @raise [NotExistsCacheError] 存在しないキャッシュファイルを指定した時に発生する
     def initialize(trend_type = TrendType::DAILY, date = nil)
       page = Page.new(trend_type, date)
       parsed_html = Nokogiri::HTML.parse(page.html)
@@ -16,12 +25,15 @@ module QiitaTrend
       @data = trends_data['trend']['edges']
     end
 
+    # Qiitaの対象のトレンドをすべて取得
+    #
+    # @return [Array] Qiitaの対象のトレンドすべて
     def items
       @data.each_with_object([]) do |trend, value|
         result = {}
         result['title'] = trend['node']['title']
         result['user_name'] = trend['node']['author']['urlName']
-        result['user_image'] = trend['node']['author']['profileImageUrl']
+        result['user_image'] = user_image(trend['node']['author']['profileImageUrl'])
         result['user_page'] = "#{Page::QIITA_URI}#{trend['node']['author']['urlName']}"
         result['article'] = "#{Page::QIITA_URI}#{trend['node']['author']['urlName']}/items/#{trend['node']['uuid']}"
         result['created_at'] = trend['node']['createdAt']
@@ -31,10 +43,30 @@ module QiitaTrend
       end
     end
 
+    # Qiitaの対象のトレンドからNEWのものだけ取得
+    #
+    # @return [Array] Qiitaの対象のトレンドからNEWのものだけ
     def new_items
       items.select do |trend|
         trend['is_new_arrival'] == true
       end
     end
+
+    private
+
+    # ユーザーの画像のURLを取得する
+    # URLデコードしimgix(画像ファイルの配信向けに特化したCDNサービス)のURLを排除する
+    # クエリーパラメータも排除する
+    #
+    # @return [String] ユーザーの画像のURL
+    def user_image(url)
+      # URLデコード
+      unescape_url = CGI.unescape(url)
+      # imgixのURLからユーザーの画像のURLへ変換する
+      exclusion_imgix = unescape_url.gsub!('https://qiita-user-profile-images.imgix.net/', '')
+      # クエリパラーメーを除いた形で返す
+      parse_url = URI.parse(exclusion_imgix)
+      "#{parse_url.host}#{parse_url.path}"
+    end
   end
 end

data/lib/qiita_trend/trend_type.rb

@@ -1,9 +1,13 @@
 # frozen_string_literal: true
 
 module QiitaTrend
+  # トレンドタイプの機能を提供する
   class TrendType
+    # トレンドタイプ：Daily
     DAILY = 'daily'
+    # トレンドタイプ：Weekly
     WEEKLY = 'weekly'
+    # トレンドタイプ：Monthly
     MONTHLY = 'monthly'
   end
 end

data/lib/qiita_trend/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module QiitaTrend
-  VERSION = '0.2.7'
+  VERSION = '0.3.2'
 end

data/qiita_trend.gemspec

@@ -10,8 +10,8 @@ Gem::Specification.new do |spec|
   spec.authors       = ['dodonki1223']
   spec.email         = ['make.an.effort.wish.come.true@gmail.com']
 
-  spec.summary       = 'Get Qiita Trend'
-  spec.description   = 'Get Qiita Trend'
+  spec.summary       = 'Easy to get trend for Qiita in 10 seconds'
+  spec.description   = 'Easy to get trend for Qiita in 10 seconds'
   spec.homepage      = 'https://github.com/dodonki1223/qiita_trend'
   spec.license       = 'MIT'
 
@@ -50,4 +50,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'simplecov'
   spec.add_development_dependency 'vcr'
   spec.add_development_dependency 'webmock'
+  spec.add_development_dependency 'yard'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: qiita_trend
 version: !ruby/object:Gem::Version
-  version: 0.2.7
+  version: 0.3.2
 platform: ruby
 authors:
 - dodonki1223
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-08-06 00:00:00.000000000 Z
+date: 2019-08-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mechanize
@@ -164,7 +164,21 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Get Qiita Trend
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Easy to get trend for Qiita in 10 seconds
 email:
 - make.an.effort.wish.come.true@gmail.com
 executables: []
@@ -186,6 +200,9 @@ files:
 - lib/qiita_trend.rb
 - lib/qiita_trend/cache.rb
 - lib/qiita_trend/configuration.rb
+- lib/qiita_trend/error/login_failure_error.rb
+- lib/qiita_trend/error/not_exists_cache_error.rb
+- lib/qiita_trend/error/syntax_error.rb
 - lib/qiita_trend/page.rb
 - lib/qiita_trend/target.rb
 - lib/qiita_trend/trend.rb
@@ -212,8 +229,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.4
+rubygems_version: 3.0.1
 signing_key: 
 specification_version: 4
-summary: Get Qiita Trend
+summary: Easy to get trend for Qiita in 10 seconds
 test_files: []