imgix 3.3.0

data/test/units/domains_test.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require 'test_helper'
+
+class DomainsTest < Imgix::Test
+  def test_invalid_domain_append_slash
+    assert_raises(ArgumentError) {Imgix::Client.new(host: "assets.imgix.net/")}
+  end
+
+  def test_invalid_domain_prepend_scheme
+    assert_raises(ArgumentError) {Imgix::Client.new(host: "https://assets.imgix.net")}
+  end
+
+  def test_invalid_domain_append_dash
+    assert_raises(ArgumentError) {Imgix::Client.new(host: "assets.imgix.net-")}
+  end
+end

data/test/units/param_helpers_test.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'test_helper'
+
+class ParamHelpers < Imgix::Test
+  def test_param_helpers_emits_dep_warning
+    host_warn = "Warning: The identifier `host' has been deprecated and " \
+                "will\nappear as `domain' in the next major version, e.g. " \
+                "`@host'\nbecomes `@domain', `options[:host]' becomes " \
+                "`options[:domain]'.\n"
+
+    assert_output(nil, host_warn) {
+        client = Imgix::Client.new(host: 'test.imgix.net')
+
+        rect_warn = "Warning: `ParamHelpers.rect` has been deprecated and " \
+                    "will be removed in the next major version.\n"
+
+        assert_output(nil, rect_warn){
+            client.path('/images/demo.png').rect(x: 0, y: 50, width: 200, height: 300)
+        }
+    }
+  end
+end

data/test/units/path_test.rb

@@ -0,0 +1,182 @@
+# frozen_string_literal: true
+
+require 'test_helper'
+
+class PathTest < Imgix::Test
+  def test_prefix_with_arg_warns
+    prefix_warn = "Warning: `Client::prefix' will take zero arguments " \
+      "in the next major version.\n"
+
+    assert_output(nil, prefix_warn) {
+      Imgix::Client.new(
+        domain: 'test.imgix.net',
+        include_library_param: false
+      ).prefix("")
+    }
+
+    # `new_prefix' is a placeholder until the bump, when it will become
+    # `prefix`.
+    assert_output(nil, nil) {
+      Imgix::Client.new(
+        domain: 'test.imgix.net',
+        include_library_param: false
+      ).new_prefix
+    }
+  end
+
+  def test_creating_a_path
+    path = client.path('/images/demo.png')
+    assert_equal 'https://demo.imgix.net/images/demo.png?s=2c7c157eaf23b06a0deb2f60b81938c4', path.to_url
+
+    path = client.path('images/demo.png')
+    assert_equal 'https://demo.imgix.net/images/demo.png?s=2c7c157eaf23b06a0deb2f60b81938c4', path.to_url
+  end
+
+  def test_signing_path_with_param
+    url = 'https://demo.imgix.net/images/demo.png?w=200&s=da421114ca238d1f4a927b889f67c34e'
+    path = client.path('/images/demo.png')
+
+    assert_output(nil, "Warning: `Path.width=' has been deprecated and " \
+      "will be removed in the next major version (along " \
+      "with all parameter `ALIASES`).\n") {
+        path.width = 200
+    }
+
+    assert_equal url, path.to_url
+
+    path = client.path('/images/demo.png')
+    assert_equal url, path.to_url(w: 200)
+
+    path = client.path('/images/demo.png')
+
+    assert_output(nil, "Warning: `Path.width' has been deprecated and " \
+      "will be removed in the next major version (along " \
+      "with all parameter `ALIASES`).\n") {
+        assert_equal url, path.width(200).to_url
+    }
+  end
+
+  def test_resetting_defaults
+    url = 'https://demo.imgix.net/images/demo.png?w=200&s=da421114ca238d1f4a927b889f67c34e'
+    path = client.path('/images/demo.png')
+    
+    assert_output(nil, "Warning: `Path.height=' has been deprecated and " \
+      "will be removed in the next major version (along " \
+      "with all parameter `ALIASES`).\n") {
+        path.height = 300
+    }
+
+    assert_equal url, path.defaults.to_url(w: 200)
+  end
+
+  def test_path_with_multiple_params
+    url = 'https://demo.imgix.net/images/demo.png?h=200&w=200&s=d570a1ecd765470f7b34a69b56718a7a'
+    path = client.path('/images/demo.png')
+
+    assert_equal url, path.to_url(h: 200, w: 200)
+
+    path = client.path('/images/demo.png')
+
+    assert_output(nil, "Warning: `Path.height' has been deprecated and " \
+      "will be removed in the next major version (along " \
+      "with all parameter `ALIASES`).\n") {
+        path.height(200)
+    }
+
+
+    assert_output(nil, "Warning: `Path.width' has been deprecated and " \
+      "will be removed in the next major version (along " \
+      "with all parameter `ALIASES`).\n") {
+        path.width(200)
+    }
+
+    assert_equal url, path.to_url
+  end
+
+  def test_path_with_multi_value_param_safely_encoded
+    url = 'https://demo.imgix.net/images/demo.png?markalign=middle%2Ccenter&s=f0d0e28a739f022638f4ba6dddf9b694'
+    path = client.path('/images/demo.png')
+
+    assert_equal url, path.markalign('middle', 'center').to_url
+  end
+
+  def test_param_keys_are_escaped
+    ix_url = unsigned_client.path('demo.png').to_url({
+      :'hello world' => 'interesting'
+    })
+
+    assert_equal "https://demo.imgix.net/demo.png?hello%20world=interesting", ix_url
+  end
+
+  def test_param_values_are_escaped
+    ix_url = unsigned_client.path('demo.png').to_url({
+      hello_world: '/foo"> <script>alert("hacked")</script><'
+    })
+
+    assert_equal "https://demo.imgix.net/demo.png?hello_world=%2Ffoo%22%3E%20%3Cscript%3Ealert%28%22hacked%22%29%3C%2Fscript%3E%3C", ix_url
+  end
+
+  def test_base64_param_variants_are_base64_encoded
+    ix_url = unsigned_client.path('~text').to_url({
+      txt64: 'I cannøt belîév∑ it wors! 😱'
+    })
+
+    assert_equal "https://demo.imgix.net/~text?txt64=SSBjYW5uw7h0IGJlbMOuw6l24oiRIGl0IHdvcu-jv3MhIPCfmLE", ix_url
+  end
+
+  def test_host_is_required
+    assert_raises(ArgumentError) {Imgix::Client.new}
+  end
+
+  def test_token_is_optional
+    client = Imgix::Client.new(host: 'demo.imgix.net', include_library_param: false)
+    url = 'https://demo.imgix.net/images/demo.png'
+    path = client.path('/images/demo.png')
+
+    assert_equal url, path.to_url
+  end
+
+  def test_https_is_optional
+    client = Imgix::Client.new(host: 'demo.imgix.net', include_library_param: false, use_https: false)
+    url = 'http://demo.imgix.net/images/demo.png'
+    path = client.path('/images/demo.png')
+
+    assert_equal url, path.to_url
+  end
+
+  def test_full_url
+    path = 'https://google.com/cats.gif'
+
+    assert_equal "https://demo.imgix.net/#{CGI.escape(path)}?s=e686099fbba86fc2b8141d3c1ff60605", client.path(path).to_url
+  end
+
+  def test_full_url_with_a_space
+    path = 'https://my-demo-site.com/files/133467012/avatar icon.png'
+    assert_equal "https://demo.imgix.net/#{CGI.escape(path)}?s=35ca40e2e7b6bd208be2c4f7073f658e", client.path(path).to_url
+  end
+
+  def test_include_library_param
+    client = Imgix::Client.new(host: 'demo.imgix.net') # enabled by default
+    url = client.path('/images/demo.png').to_url
+
+    assert_equal "ixlib=rb-#{Imgix::VERSION}", URI(url).query
+  end
+
+  def test_configure_library_param
+    library = "sinatra"
+    version = Imgix::VERSION
+    client = Imgix::Client.new(host: 'demo.imgix.net', library_param: library, library_version: version) # enabled by default
+    url = client.path('/images/demo.png').to_url
+
+    assert_equal "ixlib=#{library}-#{version}", URI(url).query
+  end
+
+private
+  def client
+    @client ||= Imgix::Client.new(host: 'demo.imgix.net', secure_url_token: '10adc394', include_library_param: false)
+  end
+
+  def unsigned_client
+    @unsigned_client ||= Imgix::Client.new(host: 'demo.imgix.net', include_library_param: false)
+  end
+end

data/test/units/purge_test.rb

@@ -0,0 +1,25 @@
+require 'test_helper'
+
+class PurgeTest < Imgix::Test
+  def test_runtime_error_without_api_key
+    assert_raises(RuntimeError) {
+      Imgix::Client.new(host: 'demo.imgix.net', include_library_param: false)
+      .purge('https://demo.imgix.net/images/demo.png')
+    }
+  end
+  
+  def test_successful_purge
+    stub_request(:post, "https://api.imgix.com/v2/image/purger").
+      with(
+        body: {"url"=>"https://demo.imgix.net/images/demo.png"}).
+      to_return(status: 200)
+
+    Imgix::Client.new(host: 'demo.imgix.net', api_key: '10adc394')
+    .purge('/images/demo.png')
+    
+    assert_requested :post, 'https://api.imgix.com/v2/image/purger',
+      body:  'url=https%3A%2F%2Fdemo.imgix.net%2Fimages%2Fdemo.png',
+      headers: {'Accept'=>'*/*', 'Accept-Encoding'=>'gzip;q=1.0,deflate;q=0.6,identity;q=0.3', 'Authorization'=>'Basic MTBhZGMzOTQ6', 'Content-Type'=>'application/x-www-form-urlencoded', 'User-Agent'=>"imgix rb-#{ Imgix::VERSION}"},
+      times: 1
+  end
+end

data/test/units/srcset_test.rb

@@ -0,0 +1,755 @@
+# frozen_string_literal: true
+
+require 'test_helper'
+
+module SrcsetTest
+  RESOLUTIONS = [
+    100, 116, 135, 156, 181, 210, 244, 283,
+    328, 380, 441, 512, 594, 689, 799, 927,
+    1075, 1247, 1446, 1678, 1946, 2257, 2619,
+    3038, 3524, 4087, 4741, 5500, 6380, 7401, 8192
+  ].freeze
+
+  DPR_QUALITY = [75, 50, 35, 23, 20].freeze
+
+  DOMAIN = 'testing.imgix.net'
+  TOKEN = 'MYT0KEN'
+  JPG_PATH = 'image.jpg'
+
+  def mock_client
+    Imgix::Client.new(
+      host: DOMAIN,
+      include_library_param: false
+    ).path(JPG_PATH)
+  end
+
+  def mock_signed_client
+    Imgix::Client.new(
+      host: DOMAIN,
+      secure_url_token: TOKEN,
+      include_library_param: false
+    ).path(JPG_PATH)
+  end
+
+  def signature_base(params)
+    TOKEN + '/' + JPG_PATH + params
+  end
+
+  def get_sig_from(src)
+    src.slice(src.index('s=') + 2, src.length)
+  end
+
+  def get_params_from(src)
+    src[src.index('?')..src.index('s=') - 2]
+  end
+
+  def get_expected_signature(src)
+    # Ensure signature param exists.
+    assert_includes src, 's='
+
+    params = get_params_from(src)
+    signature_base = signature_base(params)
+
+    Digest::MD5.hexdigest(signature_base)
+  end
+
+  class SrcsetDefault < Imgix::Test
+    include SrcsetTest
+
+    def test_no_parameters
+      srcset = path.to_srcset
+
+      expected_number_of_pairs = 31
+      assert_equal expected_number_of_pairs, srcset.split(',').length
+    end
+
+    def test_srcset_pair_values
+      resolutions = RESOLUTIONS
+      srcset = path.to_srcset
+      srclist = srcset.split(',').map do |srcset_split|
+        srcset_split.split(' ')[1].to_i
+      end
+
+      for i in 0..srclist.length - 1
+        assert_equal(srclist[i], resolutions[i])
+      end
+    end
+
+    private
+
+    def path
+      @client ||= mock_signed_client
+    end
+  end
+
+  class SrcsetGivenWidth < Imgix::Test
+    include SrcsetTest
+
+    def test_srcset_in_dpr_form
+      device_pixel_ratio = 1
+
+      srcset.split(',').map do |src|
+        ratio = src.split(' ')[1]
+        assert_equal "#{device_pixel_ratio}x", ratio
+        device_pixel_ratio += 1
+      end
+    end
+
+    def test_srcset_has_dpr_params
+      i = 1
+      srcset.split(',').map do |srcset_split|
+        src = srcset_split.split(' ')[0]
+        assert_includes src, "dpr=#{i}"
+        i += 1
+      end
+    end
+
+    def test_srcset_signs_urls
+      srcset.split(',').map do |srcset_split|
+        src = srcset_split.split(' ')[0]
+        expected_signature = get_expected_signature(src)
+
+        assert_includes src, expected_signature
+      end
+    end
+
+    def test_srcset_has_variable_qualities
+      i = 0
+      srcset.split(',').map do |src|
+        assert_includes src, "q=#{DPR_QUALITY[i]}"
+        i += 1
+      end
+    end
+
+    def test_srcset_respects_overriding_quality
+      quality_override = 100
+      srcset = mock_signed_client.to_srcset(w: 100, q: quality_override)
+
+      srcset.split(',').map do |src|
+        assert_includes src, "q=#{quality_override}"
+      end
+    end
+
+    def test_disable_variable_quality
+      srcset = mock_signed_client.to_srcset(
+        w: 100,
+        options: { disable_variable_quality: true }
+      )
+
+      srcset.split(',').map do |src|
+        assert(not(src.include?('q=')))
+      end
+    end
+
+    def test_respects_quality_param_when_disabled
+      quality_override = 100
+      srcset = mock_signed_client.to_srcset(
+        w: 100, q: 100,
+        options: { disable_variable_quality: true }
+      )
+
+      srcset.split(',').map do |src|
+        assert_includes src, "q=#{quality_override}"
+      end
+    end
+
+    private
+
+    def srcset
+      @client ||= mock_signed_client.to_srcset(w: 100)
+    end
+  end
+
+  class SrcsetGivenHeight < Imgix::Test
+    include SrcsetTest
+
+    def test_srcset_generates_width_pairs
+      expected_number_of_pairs = 31
+      assert_equal expected_number_of_pairs, srcset.split(',').length
+    end
+
+    def test_srcset_pair_values
+      resolutions = RESOLUTIONS
+      srclist = srcset.split(',').map do |srcset_split|
+        srcset_split.split(' ')[1].to_i
+      end
+
+      for i in 0..srclist.length - 1
+        assert_equal(srclist[i], resolutions[i])
+      end
+    end
+
+    def test_srcset_respects_height_parameter
+      srcset.split(',').map do |src|
+        assert_includes src, 'h='
+      end
+    end
+
+    def test_srcset_within_bounds
+      min, *max = srcset.split(',')
+
+      # parse out the width descriptor as an integer
+      min = min.split(' ')[1].to_i
+      max = max[max.length - 1].split(' ')[1].to_i
+
+      assert_operator min, :>=, 100
+      assert_operator max, :<=, 8192
+    end
+
+    # a 17% testing threshold is used to account for rounding
+    def test_srcset_iterates_17_percent
+      increment_allowed = 0.17
+
+      # create an array of widths
+      widths = srcset.split(',').map do |src|
+        src.split(' ')[1].to_i
+      end
+
+      prev = widths[0]
+
+      for i in 1..widths.length - 1
+        element = widths[i]
+        assert_operator (element.to_f / prev.to_f), :<, (1 + increment_allowed)
+        prev = element
+      end
+    end
+
+    def test_srcset_signs_urls
+      srcset.split(',').map do |srcset_split|
+        src = srcset_split.split(' ')[0]
+        expected_signature = get_expected_signature(src)
+
+        assert_includes src, expected_signature
+      end
+    end
+
+    private
+
+    def srcset
+      @client ||= mock_signed_client.to_srcset(h: 100)
+    end
+  end
+
+  class SrcsetGivenWidthAndHeight < Imgix::Test
+    include SrcsetTest
+
+    def test_srcset_in_dpr_form
+      device_pixel_ratio = 1
+      srcset.split(',').map do |src|
+        ratio = src.split(' ')[1]
+        assert_equal "#{device_pixel_ratio}x", ratio
+        device_pixel_ratio += 1
+      end
+    end
+
+    def test_srcset_has_dpr_params
+      i = 1
+      srcset.split(',').map do |srcset_split|
+        src = srcset_split.split(' ')[0]
+        assert_includes src, "dpr=#{i}"
+        i += 1
+      end
+    end
+
+    def test_srcset_signs_urls
+      srcset.split(',').map do |srcset_split|
+        src = srcset_split.split(' ')[0]
+        expected_signature = get_expected_signature(src)
+
+        assert_includes src, expected_signature
+      end
+    end
+
+    def test_srcset_has_variable_qualities
+      i = 0
+      srcset.split(',').map do |src|
+        assert_includes src, "q=#{DPR_QUALITY[i]}"
+        i += 1
+      end
+    end
+
+    def test_srcset_respects_overriding_quality
+      quality_override = 100
+      srcset = mock_signed_client.to_srcset(w: 100, h: 100, q: quality_override)
+
+      srcset.split(',').map do |src|
+        assert_includes src, "q=#{quality_override}"
+      end
+    end
+
+    def test_disable_variable_quality
+      srcset = mock_signed_client.to_srcset(
+        w: 100, h: 100,
+        options: { disable_variable_quality: true }
+      )
+
+      srcset.split(',').map do |src|
+        assert(not(src.include?('q=')))
+      end
+    end
+
+    def test_respects_quality_param_when_disabled
+      quality_override = 100
+      srcset = mock_signed_client.to_srcset(
+        w: 100, h: 100, q: 100,
+        options: { disable_variable_quality: true }
+      )
+
+      srcset.split(',').map do |src|
+        assert_includes src, "q=#{quality_override}"
+      end
+    end
+
+    private
+
+    def srcset
+      @client ||= mock_signed_client.to_srcset(w: 100, h: 100)
+    end
+  end
+
+  class SrcsetGivenAspectRatio < Imgix::Test
+    include SrcsetTest
+
+    def test_srcset_generates_width_pairs
+      expected_number_of_pairs = 31
+      assert_equal expected_number_of_pairs, srcset.split(',').length
+    end
+
+    def test_srcset_pair_values
+      srclist = srcset.split(',').map do |srcset_split|
+        srcset_split.split(' ')[1].to_i
+      end
+
+      for i in 0..srclist.length - 1
+        assert_equal(srclist[i], RESOLUTIONS[i])
+      end
+    end
+
+    def test_srcset_within_bounds
+      min, *max = srcset.split(',')
+
+      # parse out the width descriptor as an integer
+      min = min.split(' ')[1].to_i
+      max = max[max.length - 1].split(' ')[1].to_i
+
+      assert_operator min, :>=, 100
+      assert_operator max, :<=, 8192
+    end
+
+    # a 17% testing threshold is used to account for rounding
+    def test_srcset_iterates_17_percent
+      increment_allowed = 0.17
+
+      # create an array of widths
+      widths = srcset.split(',').map do |src|
+        src.split(' ')[1].to_i
+      end
+
+      prev = widths[0]
+
+      for i in 1..widths.length - 1
+        element = widths[i]
+        assert_operator (element.to_f / prev.to_f), :<, (1 + increment_allowed)
+        prev = element
+      end
+    end
+
+    def test_srcset_signs_urls
+      srcset.split(',').map do |srcset_split|
+        src = srcset_split.split(' ')[0]
+        expected_signature = get_expected_signature(src)
+
+        assert_includes src, expected_signature
+      end
+    end
+
+    private
+
+    def srcset
+      @client ||= mock_signed_client.to_srcset(ar: '3:2')
+    end
+  end
+
+  class SrcsetGivenAspectRatioAndHeight < Imgix::Test
+    include SrcsetTest
+
+    def test_srcset_in_dpr_form
+      device_pixel_ratio = 1
+
+      srcset.split(',').map do |src|
+        ratio = src.split(' ')[1]
+        assert_equal "#{device_pixel_ratio}x", ratio
+        device_pixel_ratio += 1
+      end
+    end
+
+    def test_srcset_has_dpr_params
+      i = 1
+      srcset.split(',').map do |srcset_split|
+        src = srcset_split.split(' ')[0]
+        assert_includes src, "dpr=#{i}"
+        i += 1
+      end
+    end
+
+    def test_srcset_signs_urls
+      srcset.split(',').map do |srcset_split|
+        src = srcset_split.split(' ')[0]
+        expected_signature = get_expected_signature(src)
+
+        assert_includes src, expected_signature
+      end
+    end
+
+    def test_srcset_has_variable_qualities
+      i = 0
+      srcset.split(',').map do |src|
+        assert_includes src, "q=#{DPR_QUALITY[i]}"
+        i += 1
+      end
+    end
+
+    def test_srcset_respects_overriding_quality
+      quality_override = 100
+      srcset = mock_signed_client.to_srcset(
+        w: 100, ar: '3:2', q: quality_override
+      )
+
+      srcset.split(',').map do |src|
+        assert_includes src, "q=#{quality_override}"
+      end
+    end
+
+    def test_disable_variable_quality
+      srcset = mock_signed_client.to_srcset(
+        w: 100, ar: '3:2',
+        options: { disable_variable_quality: true }
+      )
+
+      srcset.split(',').map do |src|
+        assert(not(src.include?('q=')))
+      end
+    end
+
+    def test_respects_quality_param_when_disabled
+      quality_override = 100
+      srcset = mock_signed_client.to_srcset(
+        w: 100, h: 100, q: 100,
+        options: { disable_variable_quality: true }
+      )
+
+      srcset.split(',').map do |src|
+        assert_includes src, "q=#{quality_override}"
+      end
+    end
+
+    private
+
+    def srcset
+      @client ||= mock_signed_client.to_srcset({ h: 100, ar: '3:2' })
+    end
+  end
+
+  class SrcsetWidthTolerance < Imgix::Test
+    include SrcsetTest
+
+    def test_srcset_generates_width_pairs
+      expected_number_of_pairs = 15
+      assert_equal expected_number_of_pairs, srcset.split(',').length
+    end
+
+    def test_srcset_pair_values
+      resolutions = [100, 140, 196, 274, 384,
+                     538, 753, 1054, 1476, 2066,
+                     2893, 4050, 5669, 7937, 8192]
+
+      srclist = srcset.split(',').map do |srcset_split|
+        srcset_split.split(' ')[1].to_i
+      end
+
+      for i in 0..srclist.length - 1
+        assert_equal(srclist[i], resolutions[i])
+      end
+    end
+
+    def test_srcset_within_bounds
+      min, *max = srcset.split(',')
+
+      # parse out the width descriptor as an integer
+      min = min.split(' ')[1].to_i
+      max = max[max.length - 1].split(' ')[1].to_i
+      assert_operator min, :>=, 100
+      assert_operator max, :<=, 8192
+    end
+
+    # a 41% testing threshold is used to account for rounding
+    def test_srcset_iterates_41_percent
+      increment_allowed = 0.41
+
+      # create an array of widths
+      widths = srcset.split(',').map do |src|
+        src.split(' ')[1].to_i
+      end
+
+      prev = widths[0]
+
+      for i in 1..widths.length - 1
+        element = widths[i]
+        assert_operator (element.to_f / prev.to_f), :<, (1 + increment_allowed)
+        prev = element
+      end
+    end
+
+    def test_invalid_tolerance_emits_error
+      assert_raises(ArgumentError) do
+        mock_client.to_srcset(options: { width_tolerance: 'abc' })
+      end
+    end
+
+    def test_negative_tolerance_emits_error
+      assert_raises(ArgumentError) do
+        mock_client.to_srcset(options: { width_tolerance: -0.10 })
+      end
+    end
+
+    def test_with_param_after
+      srcset = mock_signed_client.to_srcset(
+        options: { width_tolerance: 0.20 },
+        h: 1000, fit: 'clip'
+      )
+
+      assert_includes(srcset, 'h=')
+      assert(not(srcset.include?('width_tolerance=')))
+    end
+
+    def test_with_param_before
+      srcset = mock_signed_client.to_srcset(
+        h: 1000, fit: 'clip',
+        options: { width_tolerance: 0.20 }
+      )
+
+      assert_includes(srcset, 'h=')
+      assert(not(srcset.include?('width_tolerance=')))
+    end
+
+    private
+
+    def srcset
+      @client ||= mock_signed_client.to_srcset(
+        options: { width_tolerance: 0.20 }
+      )
+    end
+  end
+
+  class SrcsetCustomWidths < Imgix::Test
+    include SrcsetTest
+
+    def test_srcset_generates_width_pairs
+      expected_number_of_pairs = 4
+      assert_equal expected_number_of_pairs, srcset.split(',').length
+    end
+
+    def test_srcset_pair_values
+      resolutions = [100, 500, 1000, 1800]
+      srclist = srcset.split(',').map do |srcset_split|
+        srcset_split.split(' ')[1].to_i
+      end
+
+      for i in 0..srclist.length - 1
+        assert_equal(srclist[i], resolutions[i])
+      end
+    end
+
+    def test_srcset_within_bounds
+      min, *max = srcset.split(',')
+
+      # parse out the width descriptor as an integer
+      min = min.split(' ')[1].to_i
+      max = max[max.length - 1].split(' ')[1].to_i
+
+      assert_operator min, :>=, @widths[0]
+      assert_operator max, :<=, @widths[-1]
+    end
+
+    def test_invalid_widths_input_emits_error
+      assert_raises(ArgumentError) do
+        mock_client.to_srcset(options: { widths: 'abc' })
+      end
+    end
+
+    def test_non_integer_array_emits_error
+      assert_raises(ArgumentError) do
+        mock_client.to_srcset(options: { widths: [100, 200, false] })
+      end
+    end
+
+    def test_negative_integer_array_emits_error
+      assert_raises(ArgumentError) do
+        mock_client.to_srcset(options: { widths: [100, 200, -100] })
+      end
+    end
+
+    def test_with_param_after
+      srcset = mock_signed_client.to_srcset(
+        options: { widths: [100, 200, 300] },
+        h: 1000, fit: 'clip'
+      )
+
+      assert_includes(srcset, 'h=')
+      assert(not(srcset.include?('widths=')))
+    end
+
+    def test_with_param_before
+      srcset = mock_client.to_srcset(
+        h: 1000, fit: 'clip',
+        options: { widths: [100, 200, 300] }
+      )
+      assert_includes(srcset, 'h=')
+      assert(not(srcset.include?('widths=')))
+    end
+
+    private
+
+    def srcset
+      @widths = [100, 500, 1000, 1800]
+      @client ||= mock_signed_client.to_srcset(options: { widths: @widths })
+    end
+  end
+
+  class SrcsetMinMaxWidths < Imgix::Test
+    include SrcsetTest
+
+    def test_srcset_generates_width_pairs
+      expected_number_of_pairs = 11
+      assert_equal expected_number_of_pairs, srcset.split(',').length
+    end
+
+    def test_srcset_pair_values
+      resolutions = [500, 580, 673, 780, 905, 1050,
+        1218, 1413, 1639, 1901, 2000]
+      srclist = srcset.split(',').map do |srcset_split|
+        srcset_split.split(' ')[1].to_i
+      end
+
+      for i in 0..srclist.length - 1
+        assert_equal(srclist[i], resolutions[i])
+      end
+    end
+
+    def test_srcset_within_bounds
+      min, *max = srcset.split(',')
+
+      # parse out the width descriptor as an integer
+      min = min.split(' ')[1].to_i
+      max = max[max.length - 1].split(' ')[1].to_i
+
+      assert_operator min, :>=, @MIN
+      assert_operator max, :<=, @MAX
+    end
+
+    # a 41% testing threshold is used to account for rounding
+    def test_with_custom_width_tolerance
+      srcset = mock_client.to_srcset(
+        options: { min_width: 500, max_width: 2000, width_tolerance: 0.20 }
+      )
+
+      increment_allowed = 0.41
+
+      # create an array of widths
+      widths = srcset.split(',').map do |src|
+        src.split(' ')[1].to_i
+      end
+
+      prev = widths[0]
+
+      for i in 1..widths.length - 1
+        element = widths[i]
+        assert_operator (element.to_f / prev.to_f), :<, (1 + increment_allowed)
+        prev = element
+      end
+    end
+
+    def test_invalid_min_emits_error
+      assert_raises(ArgumentError) do
+        mock_client.to_srcset(options: { min_width: 'abc' })
+      end
+    end
+
+    def test_negative_max_emits_error
+      assert_raises(ArgumentError) do
+        mock_client.to_srcset(options: { max_width: -100 })
+      end
+    end
+
+    def test_with_param_after
+      srcset = mock_client.to_srcset(
+        options: { min_width: 500, max_width: 2000 },
+        h: 1000, fit: 'clip'
+      )
+
+      assert_includes(srcset, 'h=')
+      assert(not(srcset.include?('min_width=')))
+      assert(not(srcset.include?('max_width=')))
+    end
+
+    def test_with_param_before
+      srcset = mock_client.to_srcset(
+        h: 1000, fit: 'clip',
+        options: { min_width: 500, max_width: 2000 }
+      )
+
+      assert_includes(srcset, 'h=')
+      assert(not(srcset.include?('min_width=')))
+      assert(not(srcset.include?('max_width=')))
+    end
+
+    def test_only_min
+      min_width = 1000
+      max_width = 8192
+      srcset = mock_client.to_srcset(options: { min_width: min_width })
+
+      min, *max = srcset.split(',')
+
+      # parse out the width descriptor as an integer
+      min = min.split(' ')[1].to_i
+      max = max[max.length - 1].split(' ')[1].to_i
+
+      assert_operator min, :>=, min_width
+      assert_operator max, :<=, max_width
+    end
+
+    def test_only_max
+      min_width = 100
+      max_width = 1000
+      srcset = mock_client.to_srcset(options: { max_width: max_width })
+      min, *max = srcset.split(',')
+
+      # parse out the width descriptor as an integer
+      min = min.split(' ')[1].to_i
+      max = max[max.length - 1].split(' ')[1].to_i
+
+      assert_operator min, :>=, min_width
+      assert_operator max, :<=, max_width
+    end
+
+    def test_max_as_100
+      srcset = mock_client.to_srcset(options: { max_width: 100 })
+      assert_equal(srcset, 'https://testing.imgix.net/image.jpg?w=100 100w')
+    end
+
+    def test_min_as_8192
+      srcset = mock_client.to_srcset(options: { min_width: 8192 })
+      assert_equal(srcset, 'https://testing.imgix.net/image.jpg?w=8192 8192w')
+    end
+
+    private
+
+    def srcset
+      @MIN = 500
+      @MAX = 2000
+      @client ||= mock_client.to_srcset(
+        options: { min_width: @MIN, max_width: @MAX }
+      )
+    end
+  end
+end