govuk_ab_testing 1.0.2 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2b77eb483d96fe7cf122323876be63428b7acd7e
-  data.tar.gz: 3dc5d675e80993664b6b17f70b59f6758150face
+  metadata.gz: d5f92347d47df5e991b1a05be1d87635ea828ad6
+  data.tar.gz: b4e1a666f672b5a06937fbc11480270c2df4c22d
 SHA512:
-  metadata.gz: d8bb081b41576da8edcfab5f9883e037b3b48046e3c78a33df4f8cbca945a3a95b270f77f75281b973c5716574bf7b9ec488c70a051d0b12cdf6349079b5c3e5
-  data.tar.gz: 161c6619457164b03af84126fdd8c6df48f700a82b9bbac26cfc3315f84284389f4689245f1ec20ef00392d35172c6d0b5d9264f4dfad5dd39508312e0e532df
+  metadata.gz: cec68a1ce03789b854cf129061f0fd85b73b816b1fbf86877d68142ccdadebf458a24f324f3ce6acd7b19f3a29addb365811299eda58abcb6c71e3fbfdf0366d
+  data.tar.gz: 6ece6addd993e5a06448b8e02a0db285a91ee4445cb2e0db23d3bf6aa775e88edf788d76ca770591f6137af777f198a8d54081b6bbb8817e519d6a45f0e0743a

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 1.0.3
+
+* Add more Minitest helpers with more fine-grained assertions
+
 ## 1.0.2
 
 * Ensure `assert_response_not_modified_for_ab_test` test helper works with all

data/README.md

@@ -127,7 +127,7 @@ To test the negative case in which a page is unaffected by the A/B test:
 class PartyControllerTest < ActionController::TestCase
   include GovukAbTesting::MinitestHelpers
 
-  should "show the original " do
+  should "show the original" do
     setup_ab_variant("your_ab_test_name", "B") # optionally pass in a analytics dimension as the third argument
 
     get :show
@@ -137,6 +137,26 @@ class PartyControllerTest < ActionController::TestCase
 end
 ```
 
+There are some more fine-grained assertions which you can use to test a page
+with A/B variants which should be cached separately, but which should be
+excluded from the analytics:
+
+```ruby
+# test/controllers/party_controller_test.rb
+class PartyControllerTest < ActionController::TestCase
+  include GovukAbTesting::MinitestHelpers
+
+  should "cache each variant but not add analytics" do
+    setup_ab_variant("your_ab_test_name", "B")
+
+    get :show
+
+    assert_response_is_cached_by_variant("your_ab_test_name")
+    assert_page_not_tracked_in_ab_test
+  end
+end
+```
+
 ##### RSpec
 
 It is also possible to use `with_variant` in RSpec tests. Here is an example of

data/lib/govuk_ab_testing/minitest_helpers.rb

@@ -55,10 +55,22 @@ module GovukAbTesting
       acceptance_test_framework.set_header(ab_test.request_header, variant)
     end
 
+    def assert_response_is_cached_by_variant(ab_test_name)
+      ab_test = GovukAbTesting::AbTest.new(ab_test_name, dimension: 123)
+
+      vary_header_value = acceptance_test_framework.vary_header(response)
+      assert_match ab_test.response_header, vary_header_value,
+        "You probably forgot to use `configure_response`"
+    end
+
     def assert_response_not_modified_for_ab_test
       assert_nil acceptance_test_framework.vary_header(response),
         "`Vary` header is being added to a page which should not be modified by the A/B test"
 
+      assert_page_not_tracked_in_ab_test
+    end
+
+    def assert_page_not_tracked_in_ab_test
       meta_tags = acceptance_test_framework.analytics_meta_tags
       assert_equal(0, meta_tags.count,
         "A/B meta tag is being added to a page which should not be modified by the A/B test")

data/lib/govuk_ab_testing/version.rb

@@ -1,3 +1,3 @@
 module GovukAbTesting
-  VERSION = "1.0.2".freeze
+  VERSION = "1.0.3".freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: govuk_ab_testing
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.0.3
 platform: ruby
 authors:
 - GOV.UK Dev