virustotal_api 0.3.0 → 0.5.2

data/test/fixtures/user_find.yml

@@ -0,0 +1,213 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://www.virustotal.com/api/v3/users/testapikey
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - "*/*"
+      User-Agent:
+      - rest-client/2.1.0 (linux-gnu x86_64) ruby/2.5.1p57
+      X-Apikey:
+      - testapikey
+      Content-Length:
+      - '0'
+      Content-Type:
+      - application/x-www-form-urlencoded
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Host:
+      - www.virustotal.com
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Cache-Control:
+      - no-cache
+      Content-Type:
+      - application/json; charset=utf-8
+      X-Cloud-Trace-Context:
+      - 4ad711d6d44ea44146d4c06cb76589b1
+      Date:
+      - Mon, 05 Oct 2020 10:19:46 GMT
+      Server:
+      - Google Frontend
+      Content-Length:
+      - '5145'
+    body:
+      encoding: UTF-8
+      string: |-
+        {
+            "data": {
+                "attributes": {
+                    "apikey": "testapikey",
+                    "email": "granville@okeefehomenick.co",
+                    "first_name": "Valdo",
+                    "has_2fa": false,
+                    "last_login": 1601883978,
+                    "last_name": "Donati",
+                    "preferences": {
+                        "ui": {
+                            "last_read_notification_date": 1599481553
+                        }
+                    },
+                    "privileges": {
+                        "cases": {
+                            "granted": false
+                        },
+                        "click_to_accept": {
+                            "granted": false
+                        },
+                        "creditcards": {
+                            "granted": false
+                        },
+                        "dogfooder": {
+                            "granted": false
+                        },
+                        "downloads-tier-1": {
+                            "granted": false
+                        },
+                        "downloads-tier-2": {
+                            "granted": false
+                        },
+                        "file-behaviour-feed": {
+                            "granted": false
+                        },
+                        "file-feed": {
+                            "granted": false
+                        },
+                        "file-feed-without-av-results": {
+                            "granted": false
+                        },
+                        "intelligence": {
+                            "granted": false
+                        },
+                        "intelligence-search-tier-1": {
+                            "granted": false
+                        },
+                        "intelligence-search-tier-2": {
+                            "granted": false
+                        },
+                        "intelligence-search-tier-3": {
+                            "granted": false
+                        },
+                        "monitor": {
+                            "granted": false
+                        },
+                        "monitor-partner": {
+                            "granted": false
+                        },
+                        "private": {
+                            "granted": false
+                        },
+                        "retrohunt-tier-1": {
+                            "granted": false
+                        },
+                        "retrohunt-tier-2": {
+                            "granted": false
+                        },
+                        "retrohunt-tier-3": {
+                            "granted": false
+                        },
+                        "sales-staff": {
+                            "granted": false
+                        },
+                        "staff": {
+                            "granted": false
+                        },
+                        "url-feed": {
+                            "granted": false
+                        },
+                        "vtalerts": {
+                            "granted": false
+                        },
+                        "vtdiff-api": {
+                            "granted": false
+                        },
+                        "vtdiff-ui": {
+                            "granted": false
+                        },
+                        "vtgrep": {
+                            "granted": false
+                        },
+                        "widget": {
+                            "granted": false
+                        }
+                    },
+                    "profile_phrase": "",
+                    "quotas": {
+                        "api_requests_daily": {
+                            "allowed": 5760,
+                            "used": 102
+                        },
+                        "api_requests_hourly": {
+                            "allowed": 240,
+                            "used": 0
+                        },
+                        "api_requests_monthly": {
+                            "allowed": 1000000000,
+                            "used": 105
+                        },
+                        "cases_creation_monthly": {
+                            "allowed": 20,
+                            "used": 0
+                        },
+                        "intelligence_downloads_monthly": {
+                            "allowed": 0,
+                            "used": 0
+                        },
+                        "intelligence_graphs_private": {
+                            "allowed": 0,
+                            "used": 0
+                        },
+                        "intelligence_hunting_rules": {
+                            "allowed": 0,
+                            "used": 0
+                        },
+                        "intelligence_retrohunt_jobs_monthly": {
+                            "allowed": 0,
+                            "used": 0
+                        },
+                        "intelligence_searches_monthly": {
+                            "allowed": 0,
+                            "used": 0
+                        },
+                        "intelligence_vtdiff_creation_monthly": {
+                            "allowed": 0,
+                            "used": 0
+                        },
+                        "monitor_storage_bytes": {
+                            "allowed": 0,
+                            "used": 0
+                        },
+                        "monitor_storage_files": {
+                            "allowed": 0,
+                            "used": 0
+                        },
+                        "monitor_uploaded_bytes": {
+                            "allowed": 0,
+                            "used": 0
+                        },
+                        "monitor_uploaded_files": {
+                            "allowed": 0,
+                            "used": 0
+                        }
+                    },
+                    "reputation": 1,
+                    "status": "active",
+                    "user_since": 1512986169
+                },
+                "id": "granville",
+                "links": {
+                    "self": "https://www.virustotal.com/api/v3/users/granville"
+                },
+                "type": "user"
+            }
+        }
+    http_version: 
+  recorded_at: Mon, 05 Oct 2020 10:19:46 GMT
+recorded_with: VCR 5.0.0

data/test/group_test.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require './test/test_helper'
+
+class VirustotalAPIGroupReportTest < Minitest::Test
+  def setup
+    @group_id = 'GROUP_us'
+    @api_key  = 'testapikey'
+  end
+
+  def test_class_exists
+    assert VirustotalAPI::Group
+  end
+
+  def test_report_response
+    VCR.use_cassette('group_find') do
+      vtgroup_report = VirustotalAPI::Group.find(@group_id, @api_key)
+
+      # Make sure that the JSON was parsed
+      assert vtgroup_report.is_a?(VirustotalAPI::Group)
+      assert vtgroup_report.report.is_a?(Hash)
+    end
+  end
+
+  def test_find
+    VCR.use_cassette('group_find') do
+      vtgroup_report = VirustotalAPI::Group.find(@group_id, @api_key)
+
+      assert vtgroup_report.report_url.is_a?(String)
+    end
+  end
+end

data/test/{ip_report_test.rb → ip_test.rb}

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 
 require './test/test_helper'
 
@@ -8,15 +9,15 @@ class VirustotalAPIIPReportTest < Minitest::Test
   end
 
   def test_class_exists
-    assert VirustotalAPI::IPReport
+    assert VirustotalAPI::IP
   end
 
   def test_report_response
-    VCR.use_cassette('ip_report') do
-      vtip_report = VirustotalAPI::IPReport.find(@ip, @api_key)
+    VCR.use_cassette('ip') do
+      vtip_report = VirustotalAPI::IP.find(@ip, @api_key)
 
       # Make sure that the JSON was parsed
-      assert vtip_report.is_a?(VirustotalAPI::IPReport)
+      assert vtip_report.is_a?(VirustotalAPI::IP)
       assert vtip_report.report.is_a?(Hash)
     end
   end

data/test/test_helper.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 
 require './lib/virustotal_api'
 require 'minitest/autorun'

data/test/uri_test.rb

@@ -1,9 +1,10 @@
+# frozen_string_literal: true
 
 require './test/test_helper'
 
 class VirustotalAPIVTReportTest < Minitest::Test
   def test_api_base_uri
     assert VirustotalAPI::URI.is_a?(String)
-    assert VirustotalAPI::URI, 'https://www.virustotal.com/vtapi/v2'
+    assert_equal 'https://www.virustotal.com/api/v3', VirustotalAPI::URI
   end
 end

data/test/url_test.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require './test/test_helper'
+
+class VirustotalAPIURLReportTest < Minitest::Test
+  def setup
+    @unscanned_url = 'http://www.unscanned.com'
+    @url           = 'http://www.google.com'
+    @api_key       = 'testapikey'
+  end
+
+  def test_class_exists
+    assert VirustotalAPI::URL
+  end
+
+  def test_report_response
+    VCR.use_cassette('url_find') do
+      vturl_report = VirustotalAPI::URL.find(@url, @api_key)
+
+      # Make sure that the JSON was parsed
+      assert vturl_report.is_a?(VirustotalAPI::URL)
+      assert vturl_report.report.is_a?(Hash)
+    end
+  end
+
+  def test_find
+    VCR.use_cassette('url_find') do
+      vturl_report = VirustotalAPI::URL.find(@url, @api_key)
+
+      assert vturl_report.report_url.is_a?(String)
+    end
+  end
+
+  def test_scan_url
+    VCR.use_cassette('url_find') do
+      vturl_report = VirustotalAPI::URL.find(@url, @api_key)
+
+      assert vturl_report.id.is_a?(String)
+    end
+  end
+
+  def test_scan_unscanned_url
+    VCR.use_cassette('unscanned_url_find') do
+      vturl_report = VirustotalAPI::URL.find(@unscanned_url, @api_key)
+
+      assert_empty vturl_report.report
+    end
+  end
+
+  def test_analyse
+    VCR.use_cassette('url_analyse') do
+      vturl_scan = VirustotalAPI::URL.analyse(@url, @api_key)
+
+      assert vturl_scan.report.is_a?(Hash)
+    end
+  end
+
+  def test_analyse_id
+    VCR.use_cassette('url_analyse') do
+      vturl_scan = VirustotalAPI::URL.analyse(@url, @api_key)
+
+      assert vturl_scan.id.is_a?(String)
+    end
+  end
+end

data/test/user_test.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require './test/test_helper'
+
+class VirustotalAPIUserReportTest < Minitest::Test
+  def setup
+    @api_key = 'testapikey'
+  end
+
+  def test_class_exists
+    assert VirustotalAPI::User
+  end
+
+  def test_report_response
+    VCR.use_cassette('user_find') do
+      vtuser_report = VirustotalAPI::User.find(@api_key, @api_key)
+
+      # Make sure that the JSON was parsed
+      assert vtuser_report.is_a?(VirustotalAPI::User)
+      assert vtuser_report.report.is_a?(Hash)
+    end
+  end
+
+  def test_find
+    VCR.use_cassette('user_find') do
+      vtuser_report = VirustotalAPI::User.find(@api_key, @api_key)
+
+      assert vtuser_report.report_url.is_a?(String)
+    end
+  end
+end

data/test/version_test.rb

@@ -1,9 +1,9 @@
+# frozen_string_literal: true
 
 require './test/test_helper'
 
-class VirustotalAPIVTReportTest < Minitest::Test
+class VirustotalAPIVersionTest < Minitest::Test
   def test_version
     assert VirustotalAPI::VERSION.is_a?(String)
-    assert VirustotalAPI::VERSION, '0.2.0'
   end
 end

data/virustotal_api.gemspec

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 
 lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
@@ -9,24 +10,26 @@ Gem::Specification.new do |spec|
   spec.authors       = ['pwelch']
   spec.email         = ['paul@pwelch.net']
   spec.summary       = 'Gem for VirusTotal.com API'
-  spec.description   = 'Gem for VirusTotal.com API'
+  spec.description   = 'Gem for VirusTotal.com API, supporting API V3'
   spec.homepage      = 'https://github.com/pwelch/virustotal_api'
   spec.license       = 'MIT'
 
+  spec.required_ruby_version = '>= 2.5'
+
   spec.files         = `git ls-files -z`.split("\x0")
   spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ['lib']
 
-  spec.add_dependency 'json'
-  spec.add_dependency 'rest-client'
+  spec.add_dependency 'json', '~> 2.3', '>= 2.3.1'
+  spec.add_dependency 'rest-client', '~> 2.1', '>= 2.1.0'
 
-  spec.add_development_dependency 'bundler', '~> 1.16'
-  spec.add_development_dependency 'minitest'
-  spec.add_development_dependency 'pry'
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'minitest', '~> 5.14', '>= 5.14.1'
+  spec.add_development_dependency 'pry', '~> 0.13.1'
   spec.add_development_dependency 'rake', '~> 12.3'
-  spec.add_development_dependency 'rubocop'
-  spec.add_development_dependency 'vcr'
-  spec.add_development_dependency 'webmock'
+  spec.add_development_dependency 'rubocop', '~> 0.91'
+  spec.add_development_dependency 'vcr', '~> 6.0', '>= 6.0.0'
+  spec.add_development_dependency 'webmock', '~> 3.9'
   spec.add_development_dependency 'yard', '~> 0.9'
 end

metadata

@@ -1,85 +1,103 @@
 --- !ruby/object:Gem::Specification
 name: virustotal_api
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.2
 platform: ruby
 authors:
 - pwelch
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2018-03-31 00:00:00.000000000 Z
+date: 2020-10-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
     requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.3.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.3.1
 - !ruby/object:Gem::Dependency
   name: rest-client
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.1.0
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.1.0
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.14'
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 5.14.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.14'
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 5.14.1
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.13.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.13.1
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -98,44 +116,50 @@ dependencies:
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.91'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.91'
 - !ruby/object:Gem::Dependency
   name: vcr
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 6.0.0
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 6.0.0
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.9'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.9'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
@@ -150,7 +174,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.9'
-description: Gem for VirusTotal.com API
+description: Gem for VirusTotal.com API, supporting API V3
 email:
 - paul@pwelch.net
 executables: []
@@ -160,50 +184,59 @@ files:
 - ".github/CODE_OF_CONDUCT.md"
 - ".github/CONTRIBUTING.md"
 - ".github/ISSUE_TEMPLATE.md"
+- ".github/workflows/ruby.yml"
 - ".gitignore"
 - ".rubocop.yml"
-- ".travis.yml"
 - CHANGELOG.md
 - Gemfile
 - LICENSE.txt
 - README.md
 - Rakefile
 - lib/virustotal_api.rb
+- lib/virustotal_api/analysis.rb
 - lib/virustotal_api/base.rb
-- lib/virustotal_api/domain_report.rb
+- lib/virustotal_api/domain.rb
 - lib/virustotal_api/exceptions.rb
-- lib/virustotal_api/file_report.rb
-- lib/virustotal_api/file_scan.rb
-- lib/virustotal_api/ip_report.rb
+- lib/virustotal_api/file.rb
+- lib/virustotal_api/group.rb
+- lib/virustotal_api/ip.rb
 - lib/virustotal_api/uri.rb
-- lib/virustotal_api/url_report.rb
+- lib/virustotal_api/url.rb
+- lib/virustotal_api/user.rb
 - lib/virustotal_api/version.rb
+- test/analysis_test.rb
 - test/base_test.rb
-- test/domain_report_test.rb
+- test/domain_test.rb
 - test/exceptions_test.rb
-- test/file_report_test.rb
-- test/file_scan_test.rb
-- test/fixtures/domain_report.yml
-- test/fixtures/ip_report.yml
+- test/file_test.rb
+- test/fixtures/analysis.yml
+- test/fixtures/domain.yml
+- test/fixtures/file_analyse.yml
+- test/fixtures/file_find.yml
+- test/fixtures/file_not_found.yml
+- test/fixtures/file_rate_limit.yml
+- test/fixtures/file_unauthorized.yml
+- test/fixtures/file_upload.yml
+- test/fixtures/group_find.yml
+- test/fixtures/ip.yml
 - test/fixtures/null_file
-- test/fixtures/queue_unscanned_url_report.yml
-- test/fixtures/report.yml
-- test/fixtures/report_not_found.yml
-- test/fixtures/request_forbidden.yml
-- test/fixtures/scan.yml
-- test/fixtures/unscanned_url_report.yml
-- test/fixtures/url_report.yml
-- test/ip_report_test.rb
+- test/fixtures/unscanned_url_find.yml
+- test/fixtures/url_analyse.yml
+- test/fixtures/url_find.yml
+- test/fixtures/user_find.yml
+- test/group_test.rb
+- test/ip_test.rb
 - test/test_helper.rb
 - test/uri_test.rb
-- test/url_report_test.rb
+- test/url_test.rb
+- test/user_test.rb
 - test/version_test.rb
 - virustotal_api.gemspec
 homepage: https://github.com/pwelch/virustotal_api
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -211,36 +244,42 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
-signing_key: 
+rubygems_version: 3.0.3
+signing_key:
 specification_version: 4
 summary: Gem for VirusTotal.com API
 test_files:
+- test/analysis_test.rb
 - test/base_test.rb
-- test/domain_report_test.rb
+- test/domain_test.rb
 - test/exceptions_test.rb
-- test/file_report_test.rb
-- test/file_scan_test.rb
-- test/fixtures/domain_report.yml
-- test/fixtures/ip_report.yml
+- test/file_test.rb
+- test/fixtures/analysis.yml
+- test/fixtures/domain.yml
+- test/fixtures/file_analyse.yml
+- test/fixtures/file_find.yml
+- test/fixtures/file_not_found.yml
+- test/fixtures/file_rate_limit.yml
+- test/fixtures/file_unauthorized.yml
+- test/fixtures/file_upload.yml
+- test/fixtures/group_find.yml
+- test/fixtures/ip.yml
 - test/fixtures/null_file
-- test/fixtures/queue_unscanned_url_report.yml
-- test/fixtures/report.yml
-- test/fixtures/report_not_found.yml
-- test/fixtures/request_forbidden.yml
-- test/fixtures/scan.yml
-- test/fixtures/unscanned_url_report.yml
-- test/fixtures/url_report.yml
-- test/ip_report_test.rb
+- test/fixtures/unscanned_url_find.yml
+- test/fixtures/url_analyse.yml
+- test/fixtures/url_find.yml
+- test/fixtures/user_find.yml
+- test/group_test.rb
+- test/ip_test.rb
 - test/test_helper.rb
 - test/uri_test.rb
-- test/url_report_test.rb
+- test/url_test.rb
+- test/user_test.rb
 - test/version_test.rb