thirteen_f 0.2.7 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b0aff58ecaa4554c0b6f31db2fe9122303407b2673405b5352083bf3a110348d
-  data.tar.gz: ca603aaa800f2ca32c731cde1689a6c1e29c690586c2066ead541eb1e52df0d1
+  metadata.gz: 2eebea964d2903739ae01ced769bfc61a0df3df5115d027760ff41fa348573a1
+  data.tar.gz: 2b0a2f7f48a25d1eed4238acdb6371333c4b85435f06880dcfdaf87087454ecd
 SHA512:
-  metadata.gz: f3149f3063465dd32d32c5f54d375af276efe9c6e06d60b9f4457270f7cafbae16ff6bfa1f70aff3b792a98501ba48c2c523331dec88192d16dd9f6e7fa917f8
-  data.tar.gz: ca1a1f6b215a837b1c4aabec2b65990e1fc4055bc7facc9f1083807f5a63bd974f5ef87d66df4e142a3b73207f13b5821e97e148a7069f953b37f29ae985d210
+  metadata.gz: 55ad096c2c2100ef187a154f1def213a643317ec42cfa7146f69b1fccd7d336a2c1445cb1e1a01f2dfc6c7d14875a430af627dad16f8c83c972c991c72756035
+  data.tar.gz: 9745d3a78b459759d50933bd2ee5c167bf4b28a0fc7991aae8e8d38ec187b9a6d600a864b7f10d186a147354fde62a1306ee59ed7be92e7d3548d4c30598f28d

data/.gitignore

@@ -15,3 +15,4 @@ Gemfile.lock
 *.swp
 *.swo
 
+.DS_Store

data/Gemfile

@@ -3,5 +3,3 @@ source "https://rubygems.org"
 # Specify your gem's dependencies in thirteen_f.gemspec
 gemspec
 
-gem "rake", "~> 12.0"
-gem "minitest", "~> 5.0"

data/README.md

@@ -39,40 +39,38 @@ Or install it yourself as:
 
 ```ruby
 search = ThirteenF::Search.new('Berkshire Hathaway')
-search.get_companies
-search.companies
+search.get_results
+
+result = search.results.first
+result.get_entity
+entity = result.entity
 ```
 
-### Companies
+### Entities
 
 ```ruby
 cik_number = '0001061768'
-company = ThirteenF::Company.from_cik cik_number
-
-company = search.companies.first
-company.get_filings # grabs 10 13F filings by default which is the minimum
-company.get_filings(count: 20) # can supply an optional count keyword arg to get more filings
-company.most_recent_filing
-company.get_most_recent_holdings
-company.most_recent_holdings # returns positions from the most recent 13F filing
-
-company.cik # type: String | ex: "0001067983"
-company.name # type: String | ex: "BERKSHIRE HATHAWAY INC"
-company.state_or_country # type: String | ex: "NE"
+entity = ThirteenF::Entity.from_cik cik_number
+
+entity.most_recent_filing
+entity.get_most_recent_positions
+entity.most_recent_positions # returns positions from the most recent 13F filing
+
+entity.cik # type: String | ex: "0001067983"
+entity.name # type: String | ex: "BERKSHIRE HATHAWAY INC"
+entity.state_or_country # type: String | ex: "NE"
 ```
 
 ### Filings
 
 ```ruby
-company.get_filings
-filing = company.filings.first
-filing.company
+filing = entity.filings.first
+filing.entity
 filing.get_positions
-filing.positions # returns the US public securities held by the company at the
+filing.positions # returns the US public securities held by the entity at the
                  # time of the period of the report
 
 filing.index_url # type: String
-filing.response_status # type: String | ex: "200 OK"
 filing.period_of_report # type: Date or nil
 filing.time_accepted # type: DateTime or nil
 filing.table_html_url # type: String or nil
@@ -101,6 +99,15 @@ position.other_managers # type: String or nil | ex: "1,4,11"
 position.voting_authority # type: Hash | ex: { sole: 19994970, shared: 0, none: 0 }
 ```
 
+### Net Securities
+```ruby
+```
+
+### CUSIP Securities
+
+```ruby
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run
@@ -116,10 +123,10 @@ git commits and tags, and push the `.gem` file to
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at
-https://github.com/fordfischer/thirteen_f. This project is intended to be a safe,
+https://github.com/savfischer/thirteen_f. This project is intended to be a safe,
 welcoming space for collaboration, and contributors are expected to adhere to
 the [code of
-conduct](https://github.com/fordfischer/thirteen_f/blob/master/CODE_OF_CONDUCT.md).
+conduct](https://github.com/savfischer/thirteen_f/blob/master/CODE_OF_CONDUCT.md).
 
 
 ## License
@@ -131,4 +138,4 @@ License](https://opensource.org/licenses/MIT).
 
 Everyone interacting in the ThirteenF project's codebases, issue trackers, chat
 rooms and mailing lists is expected to follow the [code of
-conduct](https://github.com/fordfischer/thirteen_f/blob/master/CODE_OF_CONDUCT.md).
+conduct](https://github.com/savfischer/thirteen_f/blob/master/CODE_OF_CONDUCT.md).

data/lib/thirteen_f.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
-require "thirteen_f/company"
+require 'thirteen_f/sec_request'
+require "thirteen_f/entity"
 require "thirteen_f/search"
+require "thirteen_f/search_hit"
 require "thirteen_f/filing"
 require "thirteen_f/position"
 require "thirteen_f/net_position"

data/lib/thirteen_f/cusip_securities.rb

@@ -48,10 +48,11 @@ class ThirteenF
       reader.pages[2..-1].each do |page|
         lines = page.text.split("\n").reject(&:empty?)[3..-1]
         line_arrs = lines.map do |line|
-          next nil if line.include?('Total Count')
-          line.split('   ').reject(&:empty?).map(&:strip).reject { |text| text == '*' }
+          next nil if line.include?('Total Coun')
+          line.split(/\s{3}|( \* )/).reject(&:empty?).map(&:strip).reject { |text| text == '*' }
         end
         line_arrs.compact.each do |line_arr|
+          next unless line_arr.count > 1
           valid_entries.push ListEntry.new(line_arr)
         end
       end

data/lib/thirteen_f/entity.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+require 'thirteen_f/sec_request'
+
+class ThirteenF
+  class Entity
+    attr_reader :cik, :name, :tickers, :exchanges,
+      :sic, :sic_description,
+      :fiscal_year_end,
+      :business_state_or_country,
+      :filings, :most_recent_positions
+
+    BASE_URL = 'https://www.sec.gov'
+
+    def self.from_cik(cik)
+      entity_url = "https://data.sec.gov/submissions/CIK#{cik}.json"
+      new SecRequest.get entity_url
+    end
+
+    def initialize(sec_entity)
+      @name = sec_entity[:name]
+      @cik = cik_from_id sec_entity[:cik]
+      @tickers = sec_entity[:tickers]
+      @exchanges = sec_entity[:exchanges]
+      @sic = sec_entity[:sic]
+      @sic_description = sec_entity[:sicDescription]
+      @fiscal_year_end = sec_entity[:fiscalYearEnd]
+      @business_state_or_country = sec_entity[:addresses][:business][:stateOrCountry]
+      @filings = thirteen_f_filing_data sec_entity[:filings][:recent]
+      true
+    end
+
+
+    def human_fiscal_year_end
+      Time.strptime(@fiscal_year_end, '%m%d').strftime('%B %d')
+    end
+
+    def get_most_recent_positions
+      most_recent_filing.get_positions
+      @most_recent_positions =  most_recent_filing.positions
+      true
+    end
+
+    def most_recent_filing
+      filings.select(&:period_of_report).max_by(&:period_of_report)
+    end
+
+    def sec_filings_page_url
+      "#{BASE_URL}/cgi-bin/browse-edgar?CIK=#{cik}"
+    end
+
+    def thirteen_f_filings_url(count: 10)
+      "#{sec_filings_page_url}&type=13f&count=#{count}"
+    end
+
+    def self.sec_url_from_cik(cik)
+      "#{BASE_URL}/cgi-bin/browse-edgar?CIK=#{cik}"
+    end
+
+    def thirteen_f_urls(count: 10)
+      response = HTTP.get thirteen_f_filings_url(count: count)
+      page = Nokogiri::HTML response.to_s
+      page.search('#documentsbutton').map do |btn|
+        next nil unless btn.parent.previous.previous.text.include?('13F-HR')
+        "#{BASE_URL + btn.attributes['href'].value}"
+      end.compact
+    end
+
+    private
+      def cik_from_id(id)
+        id.prepend('0') until id.length >= 10
+        id
+      end
+
+      def thirteen_f_filing_data(filings_data)
+        indexes = thirteen_f_indexes(filings_data)
+        indexes.map do |index|
+          columnar_data = [
+            filings_data[:accessionNumber][index],
+            filings_data[:filingDate][index],
+            filings_data[:reportDate][index],
+            filings_data[:acceptanceDateTime][index],
+            filings_data[:act][index],
+            filings_data[:form][index],
+            filings_data[:fileNumber][index],
+            filings_data[:filmNumber][index],
+            filings_data[:items][index],
+            filings_data[:size][index],
+            filings_data[:isXBRL][index],
+            filings_data[:isInlineXBRL][index],
+            filings_data[:primaryDocument][index],
+            filings_data[:primaryDocDescription][index]
+          ]
+          Filing.new self, columnar_data
+        end
+      end
+
+      def thirteen_f_indexes(filings_data)
+        filings_data[:form].each_with_index.map do |form, i|
+          form.start_with?('13F') ? i : nil
+        end.compact
+      end
+  end
+end
+

data/lib/thirteen_f/filing.rb

@@ -1,80 +1,47 @@
 # frozen_string_literal: true
 
-require 'http'
 require 'date'
 
 class ThirteenF
   class Filing
-    attr_reader :index_url, :table_html_url, :table_xml_url,
+    attr_reader :entity, :index_url, :report_date, :time_accepted, :form_type,
+      :table_html_url, :table_xml_url,
       :cover_page_html_url, :cover_page_xml_url, :complete_text_file_url,
-      :period_of_report, :time_accepted, :response_status, :company, :positions
+      :positions
 
-    BASE_URL = 'https://www.sec.gov'
+    alias period_of_report report_date
 
-    def self.from_index_urls(urls, company)
-      redo_count = 0
-      urls.map do |index_url|
-        response = HTTP.get index_url
-        sleep 0.33
-        if response.status == 200
-          redo_count = 0
-          attributes = set_attributes(response, index_url, company)
-          new(**attributes)
-        else
-          redo_count += 1
-          redo unless redo_count > 1
-          attributes = bad_response_attributes(response, index_url, company)
-          new(**attributes)
-        end
-      end
-    end
+    BASE_URL = 'https://www.sec.gov'
 
-    def reset_attributes_from_index_url
-      return unless index_url
-      response = HTTP.get index_url
-      sleep 0.33
-      if response.status == 200
-        attributes = self.class.set_attributes(response, index_url)
-        assign_attributes(**attributes)
-        true
-      else
-        false
-      end
+    def initialize(entity, columnar_data)
+      @entity = entity
+      @index_url = assemble_index_url columnar_data[0]
+      @report_date = Date.parse columnar_data[2]
+      @time_accepted = DateTime.parse columnar_data[3]
+      @form_type = columnar_data[5]
+      true
     end
 
-    def initialize(response_status:, index_url:, company:,
-                   complete_text_file_url:, period_of_report:, time_accepted:,
-                   table_html_url: nil, table_xml_url: nil,
-                   cover_page_html_url: nil, cover_page_xml_url: nil)
-      @company = company
-      @response_status = response_status
-      @index_url = index_url
-      @table_html_url = table_html_url
-      @table_xml_url = table_xml_url
-      @cover_page_html_url = cover_page_html_url
-      @cover_page_xml_url = cover_page_xml_url
-      @complete_text_file_url = complete_text_file_url
-      @period_of_report = period_of_report
-      @time_accepted = time_accepted
-      true
+    def assemble_index_url(accession_number)
+      "#{BASE_URL}/Archives/edgar/data/#{entity.cik}/#{accession_number.delete('-')}/#{accession_number}-index.htm"
     end
 
     def get_positions
-      return false unless period_of_report
+      set_attributes_from_index_url unless table_xml_url
       @positions = Position.from_xml_filing self
       true
     end
 
+    def set_attributes_from_index_url
+      return unless index_url
+      response = SecRequest.get index_url, response_type: :html
+      assign_attributes(**set_attributes(response))
+    end
+
     private
-      def self.set_attributes(response, index_url, company)
-        page = Nokogiri::HTML response.to_s
+      def set_attributes(page)
         table_links = page.search('table.tableFile')[0].search('a')
         attributes = Hash.new
-        attributes[:company] = company
-        attributes[:response_status] = response.status.to_s
-        attributes[:index_url] = index_url
-        attributes[:period_of_report] = get_period_of_report page
-        attributes[:time_accepted] = get_time_accepted page
         attributes[:complete_text_file_url] = "#{BASE_URL + table_links[-1].attributes['href'].value}"
         if table_links.count == 5
           attributes = xml_present(attributes, table_links)
@@ -82,23 +49,7 @@ class ThirteenF
         attributes
       end
 
-      def self.get_period_of_report(page)
-        period_header_div = page.search('div.infoHead').find do |div|
-          div.text.include?('Period of Report')
-        end
-        period_string = period_header_div.next.next.text.strip
-        Date.parse period_string
-      end
-
-      def self.get_time_accepted(page)
-        accepted_header_div = page.search('div.infoHead').find do |div|
-          div.text.include?('Accepted')
-        end
-        accepted_string = accepted_header_div.next.next.text.strip
-        DateTime.parse accepted_string
-      end
-
-      def self.xml_present(attributes, table_links)
+      def xml_present(attributes, table_links)
         attributes[:table_html_url] = "#{BASE_URL + table_links[2].attributes['href'].value}"
         attributes[:table_xml_url] = "#{BASE_URL + table_links[3].attributes['href'].value}"
         attributes[:cover_page_html_url] = "#{BASE_URL + table_links[0].attributes['href'].value}"
@@ -106,30 +57,14 @@ class ThirteenF
         attributes
       end
 
-      def self.bad_response_attributes(response, index_url, company)
-        attributes = Hash.new
-        attributes[:company] = company
-        attributes[:response_status] = response.status.to_s
-        attributes[:index_url] = index_url
-        attributes[:period_of_report] = nil
-        attributes[:time_accepted] = nil
-        attributes[:complete_text_file_url] = nil
-        attributes
-      end
-
-      def assign_attributes(response_status:, index_url:, company:,
-                            complete_text_file_url:, period_of_report:,
-                            time_accepted:, table_html_url: nil, table_xml_url:
-                            nil, cover_page_html_url: nil,
+      def assign_attributes(complete_text_file_url:, table_html_url: nil,
+                            table_xml_url: nil, cover_page_html_url: nil,
                             cover_page_xml_url: nil)
-        @response_status = response_status
         @table_html_url = table_html_url
         @table_xml_url = table_xml_url
         @cover_page_html_url = cover_page_html_url
         @cover_page_xml_url = cover_page_xml_url
         @complete_text_file_url = complete_text_file_url
-        @period_of_report = period_of_report
-        @time_accepted = time_accepted
         true
       end
   end

data/lib/thirteen_f/position.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require 'http'
-
 class ThirteenF
   class Position
     attr_reader :name_of_issuer, :title_of_class, :cusip, :value_in_thousands,
@@ -10,20 +8,13 @@ class ThirteenF
 
     def self.from_xml_filing(filing)
       return nil unless filing.table_xml_url
-      response = HTTP.get filing.table_xml_url
-      xml_doc = Nokogiri::XML response.to_s
-      xml_doc.search('infoTable').map do |info_table|
-        position = new filing: filing
-        position.attributes_from_info_table(info_table)
-        position
-      end
+      from_xml_url(filing.table_xml_url, filing: filing)
     end
 
-    def self.from_xml_url(table_xml_url)
-      response = HTTP.get table_xml_url
-      xml_doc = Nokogiri::XML response.to_s
-      xml_doc.search('infoTable').map do |info_table|
-        position = new
+    def self.from_xml_url(table_xml_url, filing: nil)
+      xml_doc = SecRequest.get table_xml_url, response_type: :xml
+      xml_doc.search("//infoTable").map do |info_table|
+        position = new filing: filing
         position.attributes_from_info_table(info_table)
         position
       end

data/lib/thirteen_f/search.rb

@@ -1,42 +1,26 @@
 # frozen_string_literal: true
 
-require 'http'
-require 'nokogiri'
-
 class ThirteenF
   class Search
-    attr_reader :companies, :search_params
+    attr_reader :results, :search_params
 
-    BASE_URL = 'https://www.sec.gov'
-    SEARCH_URL = "#{BASE_URL}/cgi-bin/browse-edgar"
+    SEARCH_URL = 'https://efts.sec.gov/LATEST/search-index'
 
-    def initialize(search_string, count: 100)
-      @search_params = [SEARCH_URL, params: {
-        company: search_string,
-        count: count
-      }]
+    def initialize(search_string)
+      @search_params = [SEARCH_URL, { keysTyped: search_string, narrow: true }]
     end
 
-    def get_companies
-      response = HTTP.get(*search_params)
-      if response.status == 200
-        @companies = configure_search_results response
-      else
-        raise 'SEC results are not available right now'
-      end
+    def get_results
+      response = SecRequest.post(*search_params)
+      @results = configure_search_results response
       true
     end
 
     private
       def configure_search_results(response)
-        page = Nokogiri::HTML response.to_s
-        company_rows = page.search('table.tableFile2 > tr')[1..-1]
-        column_count = company_rows.first.search('td').count
-        if column_count == 3
-          company_rows.search('br').each { |n| n.replace("\n") }
-          Company.from_sec_search_rows company_rows
-        elsif column_count == 5
-          Company.from_company_page page
+        if response.dig(:hits, :hits)
+          SearchHit.from_search_hits response.dig(:hits, :hits)
+        else []
         end
       end
   end

data/lib/thirteen_f/search_hit.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+class ThirteenF
+  class SearchHit
+    attr_reader :cik, :name, :entity
+
+    def self.from_search_hits(hits)
+      hits.map { |hit| new hit }
+    end
+
+    def initialize(sec_hit)
+      @cik = cik_from_id sec_hit[:_id]
+      @name = sec_hit[:_source][:entity]
+      true
+    end
+
+    def get_entity
+      entity_url = "https://data.sec.gov/submissions/CIK#{cik}.json"
+      response = SecRequest.get entity_url
+      @entity = Entity.new response
+      true
+    end
+
+    private
+      def cik_from_id(id)
+        id.prepend('0') until id.length >= 10
+        id
+      end
+  end
+end
+

data/lib/thirteen_f/sec_request.rb

@@ -0,0 +1,44 @@
+require 'http'
+require 'nokogiri'
+
+class ThirteenF
+  class SecRequest
+    HEADERS = {
+      'User-Agent' => 'ThirteenF/v0.5.0 (Open Source Ruby Gem)',
+      'Accept-Encoding' => 'gzip, deflate',
+      'Accept' => '*/*'
+    }
+
+    def self.get(url, response_type: :json)
+      response = HTTP.use(:auto_inflate).headers(HEADERS).get(url)
+      handle_response response, response_type: response_type
+    end
+
+    def self.post(url, json)
+      response = HTTP.use(:auto_inflate).headers(HEADERS).post(url, json: json)
+      handle_response response
+    end
+
+    def self.handle_response(response, response_type: :json)
+      case response.status
+      when 200, 201, 202, 203, 204, 206
+        handle_response_type response.to_s, response_type
+      else
+        raise "Request failed with response #{response.status}, request url: #{response.uri.to_s}"
+      end
+    end
+
+    def self.handle_response_type(body, response_type)
+      case response_type
+      when :html
+        Nokogiri::HTML body
+      when :json
+        JSON.parse body, symbolize_names: true
+      when :xml
+        xml_doc = Nokogiri::XML body
+        xml_doc.remove_namespaces!
+      end
+    end
+  end
+end
+

data/lib/thirteen_f/version.rb

@@ -1,3 +1,3 @@
 class ThirteenF
-  VERSION = "0.2.7"
+  VERSION = "0.5.0"
 end

data/thirteen_f.gemspec

@@ -3,8 +3,8 @@ require_relative 'lib/thirteen_f/version'
 Gem::Specification.new do |spec|
   spec.name          = "thirteen_f"
   spec.version       = ThirteenF::VERSION
-  spec.authors       = ["fordfischer"]
-  spec.email         = ["fordfischer07@gmail.com"]
+  spec.authors       = ["Savannah Fischer"]
+  spec.email         = ["savannah.fischer@hey.com"]
 
   spec.summary       = %q{A ruby interface for S.E.C. 13F Data.}
 
@@ -12,14 +12,14 @@ Gem::Specification.new do |spec|
   filing data. The SEC is the U.S. Securities and Exchange Commission. 13F
   filings are disclosures large institutional investors in public securites have
   to provide and make public every quarter. It is a great way to follow what
-  different investors have been doing.}
-  spec.homepage      = "https://github.com/fordfischer/thirteen_f"
+  different investors have been doing in US regulated equity markets.}
+  spec.homepage      = "https://github.com/savfischer/thirteen_f"
   spec.license       = "MIT"
-  spec.required_ruby_version = Gem::Requirement.new(">= 2.5.0")
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.6.0")
 
   spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/fordfischer/thirteen_f"
-  spec.metadata["changelog_uri"] = "https://github.com/fordfischer/thirteen_f/commits/master"
+  spec.metadata["source_code_uri"] = "https://github.com/savfischer/thirteen_f"
+  spec.metadata["changelog_uri"] = "https://github.com/savfischer/thirteen_f/commits/master"
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
@@ -32,7 +32,8 @@ Gem::Specification.new do |spec|
 
   spec.add_development_dependency "minitest"
   spec.add_development_dependency "pry"
-  spec.add_dependency "http", ">= 4.4"
-  spec.add_dependency "nokogiri"
-  spec.add_dependency "pdf-reader"
+
+  spec.add_runtime_dependency "http", ">= 5.0"
+  spec.add_runtime_dependency "nokogiri", ">= 1.10"
+  spec.add_runtime_dependency "pdf-reader", ">= 2.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: thirteen_f
 version: !ruby/object:Gem::Version
-  version: 0.2.7
+  version: 0.5.0
 platform: ruby
 authors:
-- fordfischer
-autorequire: 
+- Savannah Fischer
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-03-31 00:00:00.000000000 Z
+date: 2021-07-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -44,50 +44,50 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4.4'
+        version: '5.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4.4'
+        version: '5.0'
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.10'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.10'
 - !ruby/object:Gem::Dependency
   name: pdf-reader
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.2'
 description: |-
   thirteen_f lets you easily search and retrieve SEC 13F
     filing data. The SEC is the U.S. Securities and Exchange Commission. 13F
     filings are disclosures large institutional investors in public securites have
     to provide and make public every quarter. It is a great way to follow what
-    different investors have been doing.
+    different investors have been doing in US regulated equity markets.
 email:
-- fordfischer07@gmail.com
+- savannah.fischer@hey.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -103,22 +103,24 @@ files:
 - bin/console
 - bin/setup
 - lib/thirteen_f.rb
-- lib/thirteen_f/company.rb
 - lib/thirteen_f/cusip_securities.rb
+- lib/thirteen_f/entity.rb
 - lib/thirteen_f/filing.rb
 - lib/thirteen_f/net_position.rb
 - lib/thirteen_f/position.rb
 - lib/thirteen_f/search.rb
+- lib/thirteen_f/search_hit.rb
+- lib/thirteen_f/sec_request.rb
 - lib/thirteen_f/version.rb
 - thirteen_f.gemspec
-homepage: https://github.com/fordfischer/thirteen_f
+homepage: https://github.com/savfischer/thirteen_f
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/fordfischer/thirteen_f
-  source_code_uri: https://github.com/fordfischer/thirteen_f
-  changelog_uri: https://github.com/fordfischer/thirteen_f/commits/master
-post_install_message: 
+  homepage_uri: https://github.com/savfischer/thirteen_f
+  source_code_uri: https://github.com/savfischer/thirteen_f
+  changelog_uri: https://github.com/savfischer/thirteen_f/commits/master
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -126,15 +128,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.5.0
+      version: 2.6.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 3.2.15
+signing_key:
 specification_version: 4
 summary: A ruby interface for S.E.C. 13F Data.
 test_files: []

data/lib/thirteen_f/company.rb

@@ -1,86 +0,0 @@
-# frozen_string_literal: true
-
-require 'http'
-
-class ThirteenF
-  class Company
-    attr_reader :cik, :name, :state_or_country, :filings, :most_recent_holdings
-
-    BASE_URL = 'https://www.sec.gov'
-
-    def self.from_sec_search_rows(rows)
-      rows.map do |row|
-        raise "Bad row" unless row.search('td').count == 3
-        cells = row.search('td')
-        cik = cells.first.text
-        name = parse_name cells[1]
-        state_or_country = cells.last.text
-        new cik, name, state_or_country
-      end
-    end
-
-    def self.from_company_page(page)
-      arr = page.search('.companyName').text.split('CIK#:')
-      name = arr.first.strip
-      cik = arr.last.strip.split(' ').first
-      state_or_country = page.search('.identInfo a').first.text
-      Array.new 1, new(cik, name, state_or_country)
-    end
-
-    def self.from_cik(cik)
-      response = HTTP.get sec_url_from_cik(cik)
-      return false unless response.status == 200
-      page = Nokogiri::HTML response.to_s
-      from_company_page(page).first
-    end
-
-    def initialize(cik, name, state_or_country)
-      @cik = cik
-      @name = name
-      @state_or_country = state_or_country
-      true
-    end
-
-    def get_most_recent_holdings
-      get_filings unless filings
-      most_recent_filing.get_positions
-      @most_recent_holdings =  most_recent_filing.positions
-      true
-    end
-
-    def most_recent_filing
-      filings.select(&:period_of_report).max_by(&:period_of_report)
-    end
-
-    def get_filings(count: 10)
-      @filings = Filing.from_index_urls thirteen_f_urls(count: count), self
-      true
-    end
-
-    def sec_filings_page_url
-      "#{BASE_URL}/cgi-bin/browse-edgar?CIK=#{cik}"
-    end
-
-    def thirteen_f_filings_url(count: 10)
-      "#{sec_filings_page_url}&type=13f&count=#{count}"
-    end
-
-    def self.sec_url_from_cik(cik)
-      "#{BASE_URL}/cgi-bin/browse-edgar?CIK=#{cik}"
-    end
-
-    def thirteen_f_urls(count: 100)
-      response = HTTP.get thirteen_f_filings_url(count: count)
-      page = Nokogiri::HTML response.to_s
-      page.search('#documentsbutton').map do |btn|
-        "#{BASE_URL + btn.attributes['href'].value}"
-      end
-    end
-
-    private
-      def self.parse_name(name_cell)
-        name_cell.text.split("\n").first
-      end
-  end
-end
-