tpt-rails 1.6.2 → 1.6.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7a7e431aaf9c9d3546eb414ab15564aba43048d9a3b64104671a1dd589bdc61f
-  data.tar.gz: 4ecdc856396d0d987e8e847694534b620b5140a442714f5f6e7e236f2625f869
+  metadata.gz: 0f941f7fce901677f655f42b56d87869e4dde19545e0547ba27d54ff1875604d
+  data.tar.gz: 79f31a854f4b9baea66dbf5d45e85332426e2061350e66cd3ad770195743e9d8
 SHA512:
-  metadata.gz: 71faac471d35a3e67356427581afdac4f44fcb66c5840b9a8d06571b15e4e47672e36c252352787be31bd5da35e53d69eff3901c79a6c5685abaa49b0c575057
-  data.tar.gz: 68670905648c6cb7456768e0805e04b4c904cd808ada80db3961a73ad35e961f0c51ed597c06b25d2b307fca91822b33998caead07b9b7bf998837d01a65f933
+  metadata.gz: d7132817e8d53a875af5d13f74b1b8c8dba725aaac5b8bad18615e15342c4ca5615002226c5d8cb250bc3dd8423da5b019c13013a9f82ca9b3b1afcbf48c6e15
+  data.tar.gz: 4aaf53023b9a035e0a13f65b380c2f9046718667d73f7663c935674c21165e77c2402f2f79c6bb15f7a1c9d5139988b25a84fb8b8bd7396998eada8090bc022c

data/README.md

@@ -74,25 +74,47 @@ See the documentation in [lib/tpt/rails.rb](lib/tpt/rails.rb).
    gem "aws-sdk-eventbridge", "~> 1.3.0"
    ```
 
-2. In an initializer, pass in the `Datadog::Statsd` object you're using to the class method ::set_metrics.
-   (Failure to do so will result in an error.) When testing, you can pass in a local Statsd, eg:
+2. Instantiate with
 
    ```ruby
-   Tpt::Rails::EventBridgePublisher.set_metrics(
-      Datadog::Statsd.new('localhost', 8125)
-   )
+   Tpt::Rails::EventBridgePublisher.new
    ```
 
 3. By default (#new with no arguments) EventBridgePublisher will try to use the following environment
    variables: `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `TPT_EVENT_SOURCE`, `TPT_SHARED_EVENT_BUS_NAME`.
 
    Additional configuration can be set as part of the constructor;
-   [see event_bridge_publisher.rb implementation](https://github.com/TeachersPayTeachers/tpt-rails/blob/ad768d3bac0c8bd28e60a48a89aed36f01c4e17b/app/models/tpt/rails/event_bridge_publisher.rb) for more details.
+   [see event_bridge_publisher.rb implementation](https://github.com/TeachersPayTeachers/tpt-rails/blob/master/app/models/tpt/rails/event_bridge_publisher.rb) for more details.
 
 4. Create events by instantiating or inheriting from `Tpt::Rails::ApplicationEvent`. Event types are derived from the text before
    "Event", so ResourceEvent has the event_type "Resource". Pass in an event or an array of events to EventBridgePublisher#publish
    and they will be published immediately. Large arrays will be batched (default 10 per batch).
 
+5. EventBridgePublisher uses Tpt::Rails.statsd as its datadog instance by default. If you want to change that behavior, call `Tpt::Rails::EventBridgePublisher.set_metrics`
+   with the statsd you want to use inside an initializer, as part of a `reloader.to_prepare` call:
+
+   ```ruby
+   Rails.application.reloader.to_prepare do
+     Tpt::Rails::EventBridgePublisher.set_metrics(
+       # your statsd here
+     )
+   end
+   ```
+
+   You can also do this when testing by using the default test publisher (see below).
+
+### EventBridge Testing
+
+1. To create a ready-made test publisher, use
+
+   ```ruby
+   Tpt::Rails::EventBridgeTestHelper.publisher
+   ```
+
+   This method accepts two parameters, batch_size and stub_responses. [See implementation docs](https://github.com/TeachersPayTeachers/tpt-rails/blob/master/app/helpers/tpt/rails/event_bridge_test_helper.rb) for more details.
+
+2. The test publisher overwrites statsd that EventBridgePublisher uses to be a dummy statsd when called.
+
 ### Error reporting (e.g. Bugsnag/Rollbar)
 
 If you configure `rollbar_access_token` & `rollbar_enabled`, or `bugsnag_api_key` then your project

data/app/helpers/tpt/rails/event_bridge_test_helper.rb

@@ -0,0 +1,27 @@
+module Tpt::Rails
+  module EventBridgeTestHelper
+    ###
+    # @description: Instantiates an EventBridgePublisher ready for testing. AWS and DataDog info is faked. Note that this sets the
+    #               metrics object for the class to be a stub. The AWS EventBridge gem will never actually be called as the gem's
+    #               #put_events method is replaced with a stub.
+    # @param {batch_size}: The number of events to send per batch.
+    # @param {stub_responses}: Responses to stub, eg. { put_events: { failed_entry_count: 0, entries: [{ event_id: "1" }, { event_id: "2" }] } }
+    # @return {EventBridgePublisher}: The EventBridgePublisher object.
+    ###
+    def self.publisher(batch_size: 10, stub_responses: {})
+      Tpt::Rails::EventBridgePublisher.set_metrics(
+        Datadog::Statsd.new('localhost', 8125)
+      )
+
+      Tpt::Rails::EventBridgePublisher.new(
+        event_source: ENV.fetch('TPT_EVENT_SOURCE', 'test-source'),
+        batch_size: batch_size,
+        client_options: {
+          access_key_id: '1234',
+          secret_access_key: 'abcd',
+          stub_responses: stub_responses
+        }
+      )
+    end
+  end
+end

data/app/models/tpt/rails/event_bridge_publisher.rb

@@ -3,6 +3,7 @@ module Tpt::Rails
     class NoEntriesInResponseData < StandardError; end
 
     attr_accessor :batch_size
+    attr_reader :client
 
     def initialize(
       event_bus_name: default_event_bus_name,
@@ -32,7 +33,7 @@ module Tpt::Rails
 
     private
 
-    attr_reader :client, :event_bus_name, :event_source
+    attr_reader :event_bus_name, :event_source
 
     def publish_batch(events)
       metrics.time('tpt.event_bridge.publish_batch') do
@@ -137,8 +138,9 @@ module Tpt::Rails
     end
 
     def metrics
-      raise "metrics object not set; use EventBridgePublisher#set_metrics" unless @@statsd
+      @@statsd ||= Tpt::Rails.statsd
 
+      raise "metrics object not set and no default found; use EventBridgePublisher#set_metrics" unless @@statsd
       @@statsd
     end
   end

data/lib/tpt/rails/version.rb

@@ -1,6 +1,6 @@
 module Tpt
   module Rails
     # Do not change this manually. Our tooling will do it automatically.
-    VERSION = '1.6.2'
+    VERSION = '1.6.4'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tpt-rails
 version: !ruby/object:Gem::Version
-  version: 1.6.2
+  version: 1.6.4
 platform: ruby
 authors:
 - TpT
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-01-05 00:00:00.000000000 Z
+date: 2022-06-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -114,6 +114,7 @@ files:
 - app/controllers/tpt/rails/error_tests_controller.rb
 - app/controllers/tpt/rails/health_checks_controller.rb
 - app/helpers/tpt/rails/application_helper.rb
+- app/helpers/tpt/rails/event_bridge_test_helper.rb
 - app/jobs/tpt/rails/application_job.rb
 - app/mailers/tpt/rails/application_mailer.rb
 - app/models/tpt/rails/application_event.rb