histock-simplefilter 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e32979ce299039612c2aa20f15b18562e1dabdbdeec3a25b981f03c7ecab084c
-  data.tar.gz: fd56926c121afc019093988e891bb41c42437699ab28187de32ad825852d066f
+  metadata.gz: 367f02f9a46aa029be6e2b7db5069b8c55fcafa90078f6e4ac588d8df5fc76b9
+  data.tar.gz: b4e7ca90ac0e7c501c0d5fcf5ad4a64db359e84c0b98673766a611ab743cf405
 SHA512:
-  metadata.gz: 1c0412f9bb2c4861d66ad676024761804bc5ae0d62ce9b82f666dc7e328315ebb438be13bc426081ec89ab8ebefff3394a26e8f6f4daea7f6d2b64470a5c8fc5
-  data.tar.gz: f29c7bea0fe1f5b0dfa54dcee98031c607083232e61330547256f26617284aba0b17f64b64bfcd96e0a085c3f503850e54590f37d1df558b02061f78920b50fd
+  metadata.gz: c13e23dd5c5748724910857767f7756dadac5ab87c1faab2a017905f1784044c25a7610feb815e5a0c285eb4ee144d6b37bbd2f402191f13acf86115e63a600c
+  data.tar.gz: 7f5ab0cd11e0e578518c576a6f92a5bd0f529c53f0a2e97cf8a9ac4f49fcaaa25394efd2ef9b4d103d84c3b57319f282edc4af2770bbc4a98c89f56d65072257

data/.rspec

@@ -1,2 +1,3 @@
+--require spec_helper
 --format documentation
 --color

data/.travis.yml

@@ -4,3 +4,5 @@ cache: bundler
 rvm:
   - 2.5.8
 before_install: gem install bundler -v 2.1.4
+notifications:
+  email: false

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+## v0.3.0
+[full changelog](http://github.com/ysato5654/histock-simplefilter/compare/v0.2.0...v0.3.0)
+
+* change request name
+    - before: financial statements  
+      after: monthly revenue
+
 ## v0.2.0
 [full changelog](http://github.com/ysato5654/histock-simplefilter/compare/v0.1.2...v0.2.0)
 

data/Gemfile

@@ -2,3 +2,7 @@ source 'https://rubygems.org'
 
 # Specify your gem's dependencies in histock-simplefilter.gemspec
 gemspec
+
+group :test do
+    gem 'coveralls', require: false
+end

data/README.md

@@ -1,9 +1,13 @@
 [![Gem Version](https://badge.fury.io/rb/histock-simplefilter.svg)](https://badge.fury.io/rb/histock-simplefilter)
 [![Build Status](https://travis-ci.org/ysato5654/histock-simplefilter.svg?branch=master)](https://travis-ci.org/ysato5654/histock-simplefilter)
+[![Coverage Status](https://coveralls.io/repos/github/ysato5654/histock-simplefilter/badge.svg?branch=master)](https://coveralls.io/github/ysato5654/histock-simplefilter?branch=master)
 
 # Histock::Simplefilter
 
-[HiStock嗨投資理財社群](https://histock.tw/) filter by Ruby
+histock-simplefilter is Ruby library to get the finance data of listed stock on the Taiwan stock exchange market from [HiStock嗨投資理財社群](https://histock.tw/).
+The library provides you to basic output data.
+
+If you would like to get more organized data, refer to [histock-filter](https://github.com/ysato5654/histock-filter).
 
 ## Installation
 
@@ -27,11 +31,41 @@ $ gem install histock-simplefilter
 
 ## Usage
 
-### Dividend policy
+### Basic Financial Statements (基本財報)
+
+#### Monthly Revenue (每月營收)
 
 ```rb
+require 'histock/simplefilter'
+
 histock = Histock::Simplefilter.new
-histock.dividend_policy('2330')
+histock.monthly_revenue('2330') # code '2330' is TSMC
+# [
+#   ["年度/月份", "單月營收", "去年同月營收", "單月月增率", "單月年增率", "累計營收", "去年累計營收", "累積年增率"],
+#   ["2020/04", "96,001,568", "74,693,616", "-15.4%", "28.5%", "406,598,784", "293,398,112", "38.6%"],
+#   ["2020/03", "113,519,600", "79,721,584", "21.5%", "42.4%", "310,597,184", "218,704,496", "42%"],
+#   ["2020/02", "93,394,448", "60,889,060", "-9.9%", "53.4%", "197,077,600", "138,982,896", "41.8%"],
+#   ["2020/01", "103,683,104", "78,093,824", "0.3%", "32.8%", "103,683,104", "78,093,824", "32.8%"],
+#   ["2019/12", "103,313,104", "89,830,600", "-4.2%", "15%", "1,069,985,024", "1,031,473,984", "3.7%"],
+#   ["2019/11", "107,884,400", "98,389,424", "1.7%", "9.6%", "966,672,320", "941,642,880", "2.7%"],
+#   ["2019/10", "106,039,504", "101,550,200", "3.8%", "4.4%", "858,787,904", "843,253,632", "1.8%"],
+#   ["2019/09", "102,170,096", "94,921,920", "-3.7%", "7.6%", "752,748,416", "741,703,424", "1.5%"],
+#   ["2019/08", "106,117,600", "91,055,040", "25.2%", "16.5%", "650,578,304", "646,781,376", "0.6%"],
+#   ["2019/07", "84,757,728", "74,370,928", "-1.3%", "14%", "544,460,672", "555,726,400", "-2%"],
+#   ["2019/06", "85,867,928", "70,438,304", "6.8%", "21.9%", "459,702,912", "481,355,488", "-4.5%"],
+#   ["2019/05", "80,436,928", "80,968,736", "7.7%", "-0.6%", "373,835,008", "410,917,184", "-9%"]
+# ]
+```
+
+### Dividend Policy (股利政策)
+
+#### 除權除息
+
+```rb
+require 'histock/simplefilter'
+
+histock = Histock::Simplefilter.new
+histock.dividend_policy('2330') # code '2330' is TSMC
 # [
 #   ["所屬年度", "發放年度", "除權日", "除息日", "除權息前股價", "股票股利", "現金股利", "EPS", "配息率", "現金殖利率", "扣抵稅率", "增資配股率", "增資認購價"],
 #   ["2019", "2020", "-", "06/18", "297.5", "0", "2.5", "13.32", "0.1877", "0.0084", "0", "0", "0"],
@@ -52,25 +86,3 @@ histock.dividend_policy('2330')
 #   ["2007", "2008", "07/16", "07/16", "55.8", "0.05", "3.03", "-", "-", "0", "0.0186", "0.02", "0"]
 # ]
 ```
-
-### Financial statements
-
-```rb
-histock = Histock::Simplefilter.new
-histock.financial_statements('2330')
-# [
-#   ["年度/月份", "單月營收", "去年同月營收", "單月月增率", "單月年增率", "累計營收", "去年累計營收", "累積年增率"],
-#   ["2020/04", "96,001,568", "74,693,616", "-15.4%", "28.5%", "406,598,784", "293,398,112", "38.6%"],
-#   ["2020/03", "113,519,600", "79,721,584", "21.5%", "42.4%", "310,597,184", "218,704,496", "42%"],
-#   ["2020/02", "93,394,448", "60,889,060", "-9.9%", "53.4%", "197,077,600", "138,982,896", "41.8%"],
-#   ["2020/01", "103,683,104", "78,093,824", "0.3%", "32.8%", "103,683,104", "78,093,824", "32.8%"],
-#   ["2019/12", "103,313,104", "89,830,600", "-4.2%", "15%", "1,069,985,024", "1,031,473,984", "3.7%"],
-#   ["2019/11", "107,884,400", "98,389,424", "1.7%", "9.6%", "966,672,320", "941,642,880", "2.7%"],
-#   ["2019/10", "106,039,504", "101,550,200", "3.8%", "4.4%", "858,787,904", "843,253,632", "1.8%"],
-#   ["2019/09", "102,170,096", "94,921,920", "-3.7%", "7.6%", "752,748,416", "741,703,424", "1.5%"],
-#   ["2019/08", "106,117,600", "91,055,040", "25.2%", "16.5%", "650,578,304", "646,781,376", "0.6%"],
-#   ["2019/07", "84,757,728", "74,370,928", "-1.3%", "14%", "544,460,672", "555,726,400", "-2%"],
-#   ["2019/06", "85,867,928", "70,438,304", "6.8%", "21.9%", "459,702,912", "481,355,488", "-4.5%"],
-#   ["2019/05", "80,436,928", "80,968,736", "7.7%", "-0.6%", "373,835,008", "410,917,184", "-9%"],
-# ]
-```

data/lib/histock/simplefilter/fetch/{financial_statements.rb → basic_financial_statements.rb}

@@ -1,7 +1,7 @@
 module Histock
     module Fetch
-        module FinancialStatements
-            def financial_statements(code)
+        module BasicFinancialStatements
+            def monthly_revenue(code)
                 params = {:no => code, :t => 1}
                 parse(:query => __method__, :html => get('/financial.aspx', params))
             end

data/lib/histock/simplefilter/fetch.rb

@@ -1,11 +1,11 @@
 require 'nokogiri'
 require File.expand_path(File.dirname(__FILE__)) + '/fetch/dividend_policy'
-require File.expand_path(File.dirname(__FILE__)) + '/fetch/financial_statements'
+require File.expand_path(File.dirname(__FILE__)) + '/fetch/basic_financial_statements'
 
 module Histock
     module Fetch
         include DividendPolicy
-        include FinancialStatements
+        include BasicFinancialStatements
 
         private
 
@@ -47,7 +47,7 @@ module Histock
             end
 
             case query
-            when :financial_statements
+            when :monthly_revenue
                 header = array.delete_at(0)
                 header.delete_at(-1)
                 header.delete_at(-1)
@@ -79,26 +79,7 @@ module Histock
 end
 
 class Integer
-    def is_zero?
-        self == 0
-    end
-
     def is_one?
         self == 1
     end
 end
-
-class String
-    def is_currency?
-        (self =~ /^[+-]?[0-9]*[\,]?[0-9]*[\.]?[0-9]+$/).nil? ? false : true
-    end
-
-    def to_currency
-        unless self.is_currency?
-            STDERR.puts "#{__FILE__}:#{__LINE__}: argument - #{self}"
-            raise ArgumentError
-        end
-
-        self.gsub(/[\,]/, '').to_f
-    end
-end

data/lib/histock/simplefilter/version.rb

@@ -1,5 +1,5 @@
 module Histock
     class Simplefilter
-        VERSION = '0.2.0'
+        VERSION = '0.3.0'
     end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: histock-simplefilter
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Yuya Sato
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-05-08 00:00:00.000000000 Z
+date: 2020-05-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -102,8 +102,8 @@ files:
 - lib/histock/simplefilter/connection.rb
 - lib/histock/simplefilter/error.rb
 - lib/histock/simplefilter/fetch.rb
+- lib/histock/simplefilter/fetch/basic_financial_statements.rb
 - lib/histock/simplefilter/fetch/dividend_policy.rb
-- lib/histock/simplefilter/fetch/financial_statements.rb
 - lib/histock/simplefilter/version.rb
 homepage: https://github.com/ysato5654/histock-simplefilter
 licenses: