amplitude-api 0.0.8 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 67727755b54bfef1fc3ffa5889e11c7931420a13
-  data.tar.gz: 52feec8f51522d7f2c17b0db39d4e033f76efe2b
+SHA256:
+  metadata.gz: 59e87e342af629c6e87369ef210a272186236ec4e4ef9f9a101a2a590da59204
+  data.tar.gz: 7e207b30db0550982c4280aa0da2d3c225b1598cfd2bcba1971e8a75238e142e
 SHA512:
-  metadata.gz: f3b3bf19725cda0082c7cf0acb7ca40614430a63ff5d929e803c3074955d9b35e5674987745a5fb17d2cc0e030fb7319a5903e012d40c98f5e171efea8f3b0f6
-  data.tar.gz: 09b6ca4ddb4ec2bdbed9980a41356b6f0096feace6819209c98ce37eb2a83722f509ca60762ccd7731a10308693bdce1eddf88f9e5cb27338fdf92be84dffd74
+  metadata.gz: 42aa5d35506dcaebb8a9db1e973081f38d0259eacc1da1eeeae6d530fc92055dfc70f749e4b19a4e28e3b726e92abae52e575207f1fadfa483bd2b6d6abba771
+  data.tar.gz: 7e97e56ac203bee46e1740e937c0869cb310d8c4edbc88ce6c2603446c5ad0989e52ffbf327be61680813ff2e92808a9ae91e09d0de9e4de5f4cedae590c2415

data/.gitignore

@@ -34,4 +34,5 @@ build/
 # unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
 .rvmrc
 
-.idea
+.idea
+amplitude-api.iml

data/.rubocop.yml

@@ -1,3 +1,35 @@
 require: rubocop-rspec
+
+AllCops:
+  TargetRubyVersion: 2.4
+
 Metrics/LineLength:
   Max: 120
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+  SupportedStyles:
+    - single_quotes
+    - double_quotes
+
+Style/BlockDelimiters:
+  Enabled: true
+  Exclude:
+    - spec/**/*
+
+# Disable some failing rspec cops that fail from upgrading gems until we can clean things up a bit.
+Naming/FileName:
+  Exclude:
+    - lib/amplitude-api.rb
+RSpec/ExampleLength:
+  Enabled: false
+Metrics/BlockLength:
+  Enabled: false
+RSpec/MultipleExpectations:
+  Enabled: false
+RSpec/NestedGroups:
+  Enabled: false
+RSpec/MessageSpies:
+  Enabled: false
+RSpec/ContextWording:
+  Enabled: false

data/.travis.yml

@@ -1,6 +1,5 @@
 language: ruby
 cache: bundler
 rvm:
-  - 2.3.1
-  - 2.2.2
-  - 2.1.6
+  - 2.6
+  - 2.4

data/Changelog.md

@@ -0,0 +1,34 @@
+# Amplitude API Changelog
+
+We would like to think our many [contributors](https://github.com/toothrot/amplitude-api/graphs/contributors) for
+suggestions, ideas and improvements to Amplitude API.
+
+## 0.3.0 (2021-02-22)
+
+* Changes Typhoeus to Faraday to launch requests
+* Adds new API fields to Event
+* Event can now include arbitrary properties, so it could be used if the API adds new ones.
+
+## 0.2.0 (2021-02-14)
+
+* Updates gem to use HTTP API V2.
+
+## 0.1.1 (2019-01-01)
+
+* Fix #41 - Delete API now correctly handles Arrays of IDs.
+
+## 0.1.0 (2019-01-01)
+
+* Update Gem dependencies (thanks @kolorahl, @itamar, @krettan)
+* Minimum ruby version is now 2.2
+* Support Delete API (thanks @samjohn)
+* Fix bundle Inline (thanks @jonduarte)
+* Many fixes from @kolorahl
+
+## 0.0.10 (2017-09-13)
+
+* Allow to use "Event Segmentation" via API ([#23](https://github.com/toothrot/amplitude-api/pull/23)).
+
+## Older releases
+
+Please see the v0.0.9 tag.

data/Gemfile

@@ -1,12 +1,14 @@
+# frozen_string_literal: true
+
 # Generated from /Users/alex/development/amplitude-api/amplitude-api.gemspec
-source 'https://rubygems.org'
+source "https://rubygems.org"
 
-gem 'typhoeus', '~> 1.0.2'
+gem "faraday", "~> 1.3"
 
 group :development, :test do
-  gem 'pry', '~> 0.9.12.6'
-  gem 'rake', '>= 10.0'
-  gem 'rspec', '>= 2.99.0'
-  gem 'rubocop', '~> 0.37.2', require: false
-  gem 'rubocop-rspec'
+  gem "pry", "~> 0.12.2"
+  gem "rake", ">= 12.0"
+  gem "rspec", ">= 2.99.0"
+  gem "rubocop", "~> 0.66.0", require: false
+  gem "rubocop-rspec"
 end

data/Gemfile.lock

@@ -1,58 +1,63 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    ast (2.2.0)
-    coderay (1.1.1)
-    diff-lcs (1.2.5)
-    ethon (0.9.0)
-      ffi (>= 1.3.0)
-    ffi (1.9.14)
-    method_source (0.8.2)
-    parser (2.3.0.6)
-      ast (~> 2.2)
-    powerpack (0.1.1)
-    pry (0.9.12.6)
-      coderay (~> 1.0)
-      method_source (~> 0.8)
-      slop (~> 3.4)
-    rainbow (2.1.0)
-    rake (10.5.0)
-    rspec (3.4.0)
-      rspec-core (~> 3.4.0)
-      rspec-expectations (~> 3.4.0)
-      rspec-mocks (~> 3.4.0)
-    rspec-core (3.4.3)
-      rspec-support (~> 3.4.0)
-    rspec-expectations (3.4.0)
+    ast (2.4.0)
+    coderay (1.1.2)
+    diff-lcs (1.3)
+    faraday (1.3.0)
+      faraday-net_http (~> 1.0)
+      multipart-post (>= 1.2, < 3)
+      ruby2_keywords
+    faraday-net_http (1.0.1)
+    jaro_winkler (1.5.2)
+    method_source (0.9.2)
+    multipart-post (2.1.1)
+    parallel (1.17.0)
+    parser (2.6.2.0)
+      ast (~> 2.4.0)
+    pry (0.12.2)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    psych (3.1.0)
+    rainbow (3.0.0)
+    rake (12.3.3)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-core (3.8.0)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.2)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.4.0)
-    rspec-mocks (3.4.1)
+      rspec-support (~> 3.8.0)
+    rspec-mocks (3.8.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.4.0)
-    rspec-support (3.4.1)
-    rubocop (0.37.2)
-      parser (>= 2.3.0.4, < 3.0)
-      powerpack (~> 0.1)
-      rainbow (>= 1.99.1, < 3.0)
+      rspec-support (~> 3.8.0)
+    rspec-support (3.8.0)
+    rubocop (0.66.0)
+      jaro_winkler (~> 1.5.1)
+      parallel (~> 1.10)
+      parser (>= 2.5, != 2.5.1.1)
+      psych (>= 3.1.0)
+      rainbow (>= 2.2.2, < 4.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (~> 0.3)
-    rubocop-rspec (1.4.0)
-    ruby-progressbar (1.7.5)
-    slop (3.6.0)
-    typhoeus (1.0.2)
-      ethon (>= 0.9.0)
-    unicode-display_width (0.3.1)
+      unicode-display_width (>= 1.4.0, < 1.6)
+    rubocop-rspec (1.32.0)
+      rubocop (>= 0.60.0)
+    ruby-progressbar (1.10.0)
+    ruby2_keywords (0.0.4)
+    unicode-display_width (1.5.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  pry (~> 0.9.12.6)
-  rake (>= 10.0)
+  faraday (~> 1.3)
+  pry (~> 0.12.2)
+  rake (>= 12.0)
   rspec (>= 2.99.0)
-  rubocop (~> 0.37.2)
+  rubocop (~> 0.66.0)
   rubocop-rspec
-  typhoeus (~> 1.0.2)
 
 BUNDLED WITH
-   1.10.6
+   1.17.3

data/Rakefile

@@ -1,14 +1,16 @@
-require 'bundler/gem_tasks'
-require 'rubocop/rake_task'
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rubocop/rake_task"
 
 RuboCop::RakeTask.new
 
 begin
-  require 'rspec/core/rake_task'
+  require "rspec/core/rake_task"
   RSpec::Core::RakeTask.new(:spec)
 rescue LoadError
-  puts 'Unable to load rspec. Have you run `bundle install`?'
+  puts "Unable to load rspec. Have you run `bundle install`?"
 end
 
 task(:default).clear
-task default: ['rubocop:auto_correct', :spec]
+task default: ["rubocop:auto_correct", :spec]

data/amplitude-api.gemspec

@@ -1,26 +1,27 @@
-# coding: utf-8
-lib = File.expand_path('../lib', __FILE__)
+# frozen_string_literal: true
+
+lib = File.expand_path("lib", __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'amplitude_api/version'
+require "amplitude_api/version"
 
 Gem::Specification.new do |spec|
-  spec.name          = 'amplitude-api'
+  spec.name          = "amplitude-api"
   spec.version       = AmplitudeAPI::VERSION
-  spec.authors       = ['Alex Rakoczy']
-  spec.email         = ['arakoczy@gmail.com']
-  spec.summary       = 'Send events to the Amplitude API'
-  spec.description   = 'Provides an integration for sending events to Amplitude'
-  spec.homepage      = 'https://github.com/toothrot/amplitude-api'
-  spec.license       = 'MIT'
+  spec.authors       = ["Alex Rakoczy"]
+  spec.email         = ["arakoczy@gmail.com"]
+  spec.summary       = "Send events to the Amplitude API"
+  spec.description   = "Provides an integration for sending events to Amplitude"
+  spec.homepage      = "https://github.com/toothrot/amplitude-api"
+  spec.license       = "MIT"
 
   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.require_paths = ["lib"]
 
-  spec.add_development_dependency 'rspec', '~> 2.99', '>= 2.99.0'
-  spec.add_development_dependency 'rake', '~> 10.0', '>= 10.0'
-  spec.add_development_dependency 'pry', '~> 0.9.12.6'
-  spec.add_dependency 'typhoeus', '~> 1.0.2'
-  spec.required_ruby_version = '~> 2.0'
+  spec.add_development_dependency "pry", "~> 0.12.2"
+  spec.add_development_dependency "rake", "~> 12.0", ">= 12.0"
+  spec.add_development_dependency "rspec", "~> 2.99", ">= 2.99.0"
+  spec.add_dependency "faraday", "~> 1.3"
+  spec.required_ruby_version = ">= 2.4"
 end

data/lib/amplitude-api.rb

@@ -1,4 +1,3 @@
-# rubocop:disable Style/FileName
-require_relative 'amplitude_api'
-# rubocop:enable Style/FileName
-# Whoops.
+# frozen_string_literal: true
+
+require_relative "amplitude_api"

data/lib/amplitude_api.rb

@@ -1,20 +1,37 @@
-require 'json'
-require 'bundler/setup'
-require 'typhoeus'
-require_relative 'amplitude_api/event'
-require_relative 'amplitude_api/identification'
+# frozen_string_literal: true
+
+require "json"
+require "faraday"
 
 # AmplitudeAPI
 class AmplitudeAPI
-  TRACK_URI_STRING = 'https://api.amplitude.com/httpapi'.freeze
-  IDENTIFY_URI_STRING = 'https://api.amplitude.com/identify'.freeze
+  require_relative "amplitude_api/config"
+  require_relative "amplitude_api/event"
+  require_relative "amplitude_api/identification"
+
+  TRACK_URI_STRING        = "https://api.amplitude.com/2/httpapi"
+  IDENTIFY_URI_STRING     = "https://api.amplitude.com/identify"
+  SEGMENTATION_URI_STRING = "https://amplitude.com/api/2/events/segmentation"
+  DELETION_URI_STRING     = "https://amplitude.com/api/2/deletions/users"
 
-  USER_WITH_NO_ACCOUNT = "user who doesn't have an account".freeze
+  USER_WITH_NO_ACCOUNT = "user who doesn't have an account"
 
   class << self
-    # @!attribute [ rw ] api_key
-    #   @return [ String ] an Amplitude API Key
-    attr_accessor :api_key
+    def config
+      Config.instance
+    end
+
+    def configure
+      yield config
+    end
+
+    def api_key
+      config.api_key
+    end
+
+    def secret_key
+      config.secret_key
+    end
 
     # ==== Event Tracking related methods
 
@@ -22,15 +39,17 @@ class AmplitudeAPI
     #
     # @param [ String ] event_name a string that describes the event, e.g. "clicked on Home"
     # @param [ String ] user a string or integer that uniquely identifies a user.
-    # @param [ Hash ] event_properties a hash that is serialized to JSON,
+    # @param [ String ] device a string that uniquely identifies the device.
+    # @option options [ Hash ] event_properties a hash that is serialized to JSON,
     # and can contain any other property to be stored on the Event
-    # @param [ Hash ] user_properties a hash that is serialized to JSON,
+    # @option options [ Hash ] user_properties a hash that is serialized to JSON,
     # and contains user properties to be associated with the user
     #
-    # @return [ Typhoeus::Response ]
-    def send_event(event_name, user, options = {})
+    # @return [ Faraday::Response ]
+    def send_event(event_name, user, device, options = {})
       event = AmplitudeAPI::Event.new(
         user_id: user,
+        device_id: device,
         event_type: event_name,
         event_properties: options.fetch(:event_properties, {}),
         user_properties: options.fetch(:user_properties, {})
@@ -51,10 +70,10 @@ class AmplitudeAPI
     def track_body(*events)
       event_body = events.flatten.map(&:to_hash)
 
-      {
+      JSON.generate(
         api_key: api_key,
-        event: JSON.generate(event_body)
-      }
+        events: event_body
+      )
     end
 
     # @overload track(event)
@@ -63,17 +82,21 @@ class AmplitudeAPI
     # @overload track([events])
     #   @param [ Array<AmplitudeAPI::Event> ] Send an array of events in a single request to Amplitude
     #
-    # @return [ Typhoeus::Response ]
+    # @return [ Faraday::Response ]
     #
     # Send one or more Events to the Amplitude API
     def track(*events)
-      Typhoeus.post(TRACK_URI_STRING, body: track_body(events))
+      Faraday.post(TRACK_URI_STRING, track_body(events), "Content-Type" => "application/json")
     end
 
     # ==== Identification related methods
 
-    def send_identify(user_id, user_properties = {})
-      identification = AmplitudeAPI::Identification.new(user_id: user_id, user_properties: user_properties)
+    def send_identify(user_id, device_id, user_properties = {})
+      identification = AmplitudeAPI::Identification.new(
+        user_id: user_id,
+        device_id: device_id,
+        user_properties: user_properties
+      )
       identify(identification)
     end
 
@@ -102,11 +125,89 @@ class AmplitudeAPI
     # @overload identify([identifications])
     #   @param [ Array<AmplitudeAPI::Identify> ] Send an array of identifications in a single request to Amplitude
     #
-    # @return [ Typhoeus::Response ]
+    # @return [ Faraday::Response ]
     #
     # Send one or more Identifications to the Amplitude Identify API
     def identify(*identifications)
-      Typhoeus.post(IDENTIFY_URI_STRING, body: identify_body(identifications))
+      Faraday.post(IDENTIFY_URI_STRING, identify_body(identifications))
+    end
+
+    # ==== Event Segmentation related methods
+
+    # Get metrics for an event with segmentation.
+    #
+    # @param [ Hash ] event a hash that defines event.
+    # @param [ Time ] start_time a start time.
+    # @param [ Time ] end_time a end time.
+    # @option options [ String ] m a string that defines aggregate function.
+    # For non-property metrics: "uniques", "totals", "pct_dau", or "average" (default: "uniques").
+    # For property metrics: "histogram", "sums", or "value_avg"
+    # (note: a valid "group_by" value is required in parameter e).
+    # @option options [ Integer ] i an integer that defines segmentation interval.
+    # Set to -300000, -3600000, 1, 7, or 30 for realtime, hourly, daily, weekly,
+    # and monthly counts, respectively (default: 1). Realtime segmentation is capped at 2 days,
+    # hourly segmentation is capped at 7 days, and daily at 365 days.
+    # @option options [ Array ] s an array that defines segment definitions.
+    # @option options [ String ] g a string that defines property to group by.
+    # @option options [ Integer ] limit an integer that defines number of Group By values
+    # returned (default: 100). The maximum limit is 1000.
+    #
+    # @return [ Faraday::Response ]
+    def segmentation(event, start_time, end_time, **options)
+      Faraday.get SEGMENTATION_URI_STRING, userpwd: "#{api_key}:#{secret_key}", params: {
+        e: event.to_json,
+        m: options[:m],
+        start: start_time.strftime("%Y%m%d"),
+        end: end_time.strftime("%Y%m%d"),
+        i: options[:i],
+        s: (options[:s] || []).map(&:to_json),
+        g: options[:g],
+        limit: options[:limit]
+      }.delete_if { |_, value| value.nil? }
+    end
+
+    # Delete a user from amplitude
+    #
+    # You must pass in either an array of user_ids or an array of amplitude_ids
+    #
+    # @param [ Array<String> ] (optional) the user_ids to delete
+    # based on your database
+    # @param [ Array<Integer> ] (optional) the amplitude_ids to delete
+    # based on the amplitude database
+    # @param [ String ] requester the email address of the person who
+    # is requesting the deletion, optional but useful for reporting
+    # @param [ Boolean ] (optional) ignore any invalid user IDs(users that do no
+    # exist in the project) that were passed in
+    # @param [ Boolean ] (optional) delete from the entire org rather than just
+    # this project.
+    # @return [ Faraday::Response ]
+    def delete(user_ids: nil, amplitude_ids: nil, requester: nil, ignore_invalid_id: nil, delete_from_org: nil)
+      user_ids = Array(user_ids)
+      amplitude_ids = Array(amplitude_ids)
+
+      faraday = Faraday.new do |conn|
+        conn.basic_auth config.api_key, config.secret_key
+      end
+
+      faraday.post(
+        DELETION_URI_STRING,
+        delete_body(user_ids, amplitude_ids, requester, ignore_invalid_id, delete_from_org),
+        "Content-Type" => "application/json"
+      )
+    end
+
+    private
+
+    def delete_body(user_ids, amplitude_ids, requester, ignore_invalid_id, delete_from_org)
+      body = {
+        amplitude_ids: amplitude_ids,
+        user_ids: user_ids,
+        requester: requester
+      }.delete_if { |_, value| value.nil? || value.empty? }
+
+      body[:ignore_invalid_id] = ignore_invalid_id.to_s if ignore_invalid_id
+      body[:delete_from_org] = delete_from_org.to_s if delete_from_org
+      JSON.generate(body)
     end
   end
 end