trailer_vote-media_types 2.1.0 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1288d7dad9c97ecc0a247b2ea0e97080350de1d05f8d99e1b90ec1c701e2d6a6
-  data.tar.gz: af35a13402987a4377b6e1987203bc1e0cb4f3c90957e5e4a395ede1adef76ef
+  metadata.gz: 8d5fb985577a85efe9cea70dae0977968d35d11116b8305f7d0887f27e8cebe0
+  data.tar.gz: 606afe3ecef2b7b3892e37f3cd7350f2ba4ab2ce0b06223c54755d03f87ac90d
 SHA512:
-  metadata.gz: 8547e41d4e776751d4bc2432141f0e3e4ca35571593b691bcf761711c76fc1b369aaac36b128189fb79ce20115bf096648e8128e81ca3ee42ad481e1019f0db1
-  data.tar.gz: 83c2ca51ee349191ac9c5788481216a181c280c167e3a7cc4ccbddc6c1e58e1bd21a3129c02a737b183cb992bbe50915b92bc38407e1988d5ca9a15c358fa89f
+  metadata.gz: 0e64dafd643e022ac7e2fe9f2f1a47911ec31052031e7b0dcd2b3b2623ad33be21f57d5c0c9e5045c553c1c0d6045cdf3aedf6992dbd663e9f30731b8941fc86
+  data.tar.gz: 918b8c8a7d8214f1fb98c139164cbcacbf3991253efcfa84936275003e69bd5a36e2e49a1790f8678ea825927a88bbec72021b79a0d24fa6fd393198898142d9

data/.gitignore

@@ -1,12 +1,12 @@
-/.bundle/
-/.yardoc
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/test/reports/
-/tmp/
-
-/.byebug_history
-/.rakeTasks
-
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/test/reports/
+/tmp/
+
+/.byebug_history
+/.rakeTasks
+

data/.rubocop.yml

@@ -1,29 +1,29 @@
-AllCops:
-  Include:
-    - '**/Rakefile'
-    - 'lib/**/*.rb'
-  Exclude:
-    - 'Gemfile'
-    - 'bin/**/*'
-  TargetRubyVersion: 2.5
-
-Layout/EmptyLinesAroundClassBody:
-  Enabled: false
-
-Layout/EndOfLine:
-  Enabled: false
-
-Metrics/LineLength:
-  Max: 120
-
-Metrics/MethodLength:
-  Max: 15
-
-Style/Documentation:
-  Enabled: false
-
-Style/EmptyMethod:
-  EnforcedStyle: expanded
-
-Style/IfUnlessModifier:
-  Enabled: false
+AllCops:
+  Include:
+    - '**/Rakefile'
+    - 'lib/**/*.rb'
+  Exclude:
+    - 'Gemfile'
+    - 'bin/**/*'
+  TargetRubyVersion: 2.5
+
+Layout/EmptyLinesAroundClassBody:
+  Enabled: false
+
+Layout/EndOfLine:
+  Enabled: false
+
+Metrics/LineLength:
+  Max: 120
+
+Metrics/MethodLength:
+  Max: 15
+
+Style/Documentation:
+  Enabled: false
+
+Style/EmptyMethod:
+  EnforcedStyle: expanded
+
+Style/IfUnlessModifier:
+  Enabled: false

data/.travis.yml

@@ -1,18 +1,18 @@
-sudo: false
-language: ruby
-cache: bundler
-rvm:
-  - 2.5
-  - 2.6
-  - rbx-3
-  - ruby-head
-matrix:
-  allow_failures:
-    - rvm: ruby-head
-    - rvm: rbx-3
-    - rvm: 2.6
-before_install:
-  - gem update --system
-  - gem --version
-install:
-  - bundle install --with development --jobs=3 --retry=3 --path=${BUNDLE_PATH:-vendor/bundle}
+sudo: false
+language: ruby
+cache: bundler
+rvm:
+  - 2.5
+  - 2.6
+  - rbx-3
+  - ruby-head
+matrix:
+  allow_failures:
+    - rvm: ruby-head
+    - rvm: rbx-3
+    - rvm: 2.6
+before_install:
+  - gem update --system
+  - gem --version
+install:
+  - bundle install --with development --jobs=3 --retry=3 --path=${BUNDLE_PATH:-vendor/bundle}

data/CHANGELOG.md

@@ -1,82 +1,82 @@
-# Changelog
-
-## 0.9.2
-
-- Add vimeo as video handler
-
-## 0.9.1
-
-- Allow empty for various `index` and `collection` views
-
-## 0.9.0
-
-- Add `issue` media type
-- Update `trailer_vote-fixtures` to 1.2.0
-
-## 0.8.1
-
-- Use external `trailer_vote-fixtures`
-
-## 0.8.0
-
-- Add `Issue` media type
-- Add `issues` link to configuration media type
-
-## 0.7.6
-
-- Allow `content_*` to be `nil`
-
-## 0.7.5
-
-- Add `content_language` and `content_region` to assets
-
-## 0.7.4
-
-- Allow `type` on partial `image_links` (such as sentiment_feedback)
-
-## 0.7.3
-
-- Add `type` to image self link
-- Add `type` to image index links
-- Add `type` to video self link
-- Add `type` to video index links
-
-## 0.7.2
-
-- Allow for `content_digest` and dimensions on image links (output)
-
-## 0.7.1
-
-- Fix version 2 of sentiment feedback not registering
-- Change default version of sentiment feedback to v2
-
-## 0.7.0
-
-- Add `products` link to configuration v1
-- Add scheme validation for `data` property of products
-
-## 0.6.3
-
-- Fix `product_video` create root key
-
-## 0.6.2
-
-- Loosen Gem dependency versions to allow any minor update, except for dogfooded gems, which are allowed major updates, until they hit 1.0.0
-- Add metadata urls for gemspec
-
-## 0.6.1
-
-- Allow for http urls because not all services in all environments may operate with TLS enabled.
-
-## 0.6.0
-
-- Update `media_types` to `0.6.0` so that the integrations become available downstream.
-- Rename all `deleted_at` to `expires_at` (#1)
-- Add `Types::HttpsUrl`, `Types::InfluxDbConnectionUrl`, `Types.makeFormattedUrl`, `Types.Iso8601` to check format of string attributes. (#2)
-- Add documentation for `updated_at` fields (#4)
-- Add expected type for `ProductLookup` `identifier` (#5)
-- Remove optional nil for analytics and metrics url by changing the type (#3)
-
-## 0.5.0
-
-:baby: initial public release. Not considered stable until version 1.0.0.
+# Changelog
+
+## 0.9.2
+
+- Add vimeo as video handler
+
+## 0.9.1
+
+- Allow empty for various `index` and `collection` views
+
+## 0.9.0
+
+- Add `issue` media type
+- Update `trailer_vote-fixtures` to 1.2.0
+
+## 0.8.1
+
+- Use external `trailer_vote-fixtures`
+
+## 0.8.0
+
+- Add `Issue` media type
+- Add `issues` link to configuration media type
+
+## 0.7.6
+
+- Allow `content_*` to be `nil`
+
+## 0.7.5
+
+- Add `content_language` and `content_region` to assets
+
+## 0.7.4
+
+- Allow `type` on partial `image_links` (such as sentiment_feedback)
+
+## 0.7.3
+
+- Add `type` to image self link
+- Add `type` to image index links
+- Add `type` to video self link
+- Add `type` to video index links
+
+## 0.7.2
+
+- Allow for `content_digest` and dimensions on image links (output)
+
+## 0.7.1
+
+- Fix version 2 of sentiment feedback not registering
+- Change default version of sentiment feedback to v2
+
+## 0.7.0
+
+- Add `products` link to configuration v1
+- Add scheme validation for `data` property of products
+
+## 0.6.3
+
+- Fix `product_video` create root key
+
+## 0.6.2
+
+- Loosen Gem dependency versions to allow any minor update, except for dogfooded gems, which are allowed major updates, until they hit 1.0.0
+- Add metadata urls for gemspec
+
+## 0.6.1
+
+- Allow for http urls because not all services in all environments may operate with TLS enabled.
+
+## 0.6.0
+
+- Update `media_types` to `0.6.0` so that the integrations become available downstream.
+- Rename all `deleted_at` to `expires_at` (#1)
+- Add `Types::HttpsUrl`, `Types::InfluxDbConnectionUrl`, `Types.makeFormattedUrl`, `Types.Iso8601` to check format of string attributes. (#2)
+- Add documentation for `updated_at` fields (#4)
+- Add expected type for `ProductLookup` `identifier` (#5)
+- Remove optional nil for analytics and metrics url by changing the type (#3)
+
+## 0.5.0
+
+:baby: initial public release. Not considered stable until version 1.0.0.

data/Gemfile

@@ -1,6 +1,6 @@
-source 'https://rubygems.org'
-
-git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
-
-# Specify your gem's dependencies in trailer_vote-api.gemspec
-gemspec
+source 'https://rubygems.org'
+
+git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in trailer_vote-api.gemspec
+gemspec

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    trailer_vote-media_types (2.0.0)
+    trailer_vote-media_types (2.2.0)
       media_types (>= 0.6.0, < 1)
 
 GEM
@@ -29,7 +29,7 @@ GEM
       json (>= 1.8, < 3)
       simplecov-html (~> 0.10.0)
     simplecov-html (0.10.2)
-    trailer_vote-fixtures (1.14.0)
+    trailer_vote-fixtures (1.15.0)
 
 PLATFORMS
   ruby
@@ -37,15 +37,15 @@ PLATFORMS
 
 DEPENDENCIES
   awesome_print (~> 1.8)
-  bundler (~> 1.16)
+  bundler (~> 2.0)
   minitest (~> 5.0)
   minitest-ci (~> 3.4)
   minitest-reporters (~> 1.3)
   oj (~> 3.6)
   rake (~> 13.0)
   simplecov (~> 0.16)
-  trailer_vote-fixtures (~> 1.14.0)
+  trailer_vote-fixtures (~> 1.15.0)
   trailer_vote-media_types!
 
 BUNDLED WITH
-   1.17.3
+   2.1.0

data/README.md

@@ -1,118 +1,118 @@
-# TrailerVote::MediaTypes
-[![Build Status](https://travis-ci.com/TrailerVote/trailervote-media-types.svg?branch=master)](https://travis-ci.com/TrailerVote/trailervote-media-types)
-[![Gem Version](https://badge.fury.io/rb/trailer_vote-media_types.svg)](https://badge.fury.io/rb/trailer_vote-media_types)
-[![Maintainability](https://api.codeclimate.com/v1/badges/f5ea339bc868a4e3c362/maintainability)](https://codeclimate.com/github/TrailerVote/trailervote-media-types/maintainability)
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-```ruby
-gem 'trailer_vote-media_types'
-```
-
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
-
-    $ gem install trailer_vote-media_types
-    
-## Notes
-
-### `updated_at` vs `Last-Modified` headers
-
-When this is used in conjunction with a TrailerVote service, the `updated_at` attributes inside the body of a response will take precedence over any `Last-Modified` header. The `updated_at` value **SHOULD** reflect the last time the resource was updated, whereas the `Last-Modified` value may change when the representation is updated.
-
-### Are ids missing?
-
-No, the `id` or `uuid` attributes are not missing. As per the [TrailerVote API considerations](https://docs.trailervote.com/reference) clients **SHOULD** not need to construct URLs. Both internally and externally, where possible, we refer to resources by their fully qualified URL which _is_ their identifier, instead of something like a UUID.
-
-## Usage
-
-This gem is based on [`media_types`](https://github.com/SleeplessByte/media-types-ruby), and inherits all the functionality from that gem. In general, you can use `trailer_vote-media_types` in the following ways:
-
-### `Accept` and `Content-Type` construction
-
-All the media types can be turned into a header value, both acceptable for the `Accept` and `Content-Type` headers:
-
-```ruby
-TrailerVote::MediaTypes::Configuration.to_constructable.version(2).to_s
-# => "application/vnd.trailervote.configuration.v2+json"
-```
-
-The [`Constructable`](https://www.rubydoc.info/gems/media_types/MediaTypes/Constructable) result of `#to_constructable` allows for chaining the various options in our media types, namely `view` (e.g. `index`, `create`) and `version`. The default `suffix` is none for binary types and `json` for text type, as we don't support XML at the moment.
-
-It is **recommended** to always include `.version(n)`, otherwise you will get the newest version, which might not be what you support in the code.
-
-### `Accept` with quality parameter
-
-If you want to have multiple `Accept` values, but with different priorities, `Constructable#to_s` accepts an additional parameter to set this. For example, if you want to make a fully qualified `Accept` header and you prefer product version 2, but accept version 1 as well:
-
-```ruby
-[
-    TrailerVote::MediaTypes::Product.to_constructable.version(2).to_s,
-    TrailerVote::MediaTypes::Product.to_constructable.version(1).to_s(0.9),
-    TrailerVote::MediaTypes::Errors.to_constructable.version(1).to_s(0.1)
-].join(', ')
-# => "application/vnd.trailervote.configuration.product.v2+json,
-#       application/vnd.trailervote.configuration.product.v1+json; q=0.9,
-#       application/vnd.trailervote.errors.v1+json; q=0.1"
-```
-
-### Data validation
-
-All the media types come equipped with validations, for most known / expected permutations of views and versions. Validations are based on [`Scheme`](https://www.rubydoc.info/gems/media_types/MediaTypes/Scheme) from the [`media_types`](https://github.com/SleeplessByte/media-types-ruby) gem.
-
-```ruby
-media_type = TrailerVote::MediaTypes::ClientConfiguration.to_constructable.version(1)
-# => application/vnd.trailervote.client_configuration.v1+json
-
-media_type.valid?(
-    configuration: {
-        place: "https://fake.trailervote.com/api/places/435ec0b8-100d-4e92-8a17-04bc77e90880",
-        persona: "https://fake.trailervote.com/api/persona/e03a1c72-8bce-408c-a6e4-de215e73dd92"
-    }
-)
-# => true
-
-media_type.validate!(
-    configuration: {
-        place: "https://fake.trailervote.com/api/places/435ec0b8-100d-4e92-8a17-04bc77e90880",
-    }
-)
-# => raises MediaTypes::Scheme::ExhaustedOutputError: Missing keys in output: [:persona] at [.->configuration]
-```
-
-### `Mime::Type` registration
-
-In case you use `action_dispatch/http/mime_type`, you may register the TrailerVote Media Types into the `Mime::Type` registry like so:
-```ruby
-TrailerVote::MediaTypes::Persona.register
-# => [...] # Array of registered types, each version, each suffix permutation, all aliases
-```
-
-You can now look them up in the registry:
-
-```ruby
-media_type = TrailerVote::MediaTypes::Persona.to_constructable.version(1).to_s
-# => "application/vnd.trailervote.persona.v1+json"
-
-Mime::Type.lookup(media_type)
-# => Mime::Type entry
-```
-
-## Development
-
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can
-also run `bin/console` for an interactive prompt that will allow you to experiment.
-
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the
-version number in `version.rb`, and then run `bundle update trailer_vote-media_types` in any repository that depends on
-this gem. If you have permissions, you may call `bundle exec rake release` to create a new git tag, push
-git commits and tags, and push the `.gem` file to the rubygems gem server.
-
-## Contributing
-
-Bug reports and pull requests are welcome on GitHub at [TrailerVote/trailervote-media-types](https://github.com/TrailerVote/trailervote-media-types)
+# TrailerVote::MediaTypes
+[![Build Status](https://travis-ci.com/TrailerVote/trailervote-media-types.svg?branch=master)](https://travis-ci.com/TrailerVote/trailervote-media-types)
+[![Gem Version](https://badge.fury.io/rb/trailer_vote-media_types.svg)](https://badge.fury.io/rb/trailer_vote-media_types)
+[![Maintainability](https://api.codeclimate.com/v1/badges/f5ea339bc868a4e3c362/maintainability)](https://codeclimate.com/github/TrailerVote/trailervote-media-types/maintainability)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'trailer_vote-media_types'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install trailer_vote-media_types
+    
+## Notes
+
+### `updated_at` vs `Last-Modified` headers
+
+When this is used in conjunction with a TrailerVote service, the `updated_at` attributes inside the body of a response will take precedence over any `Last-Modified` header. The `updated_at` value **SHOULD** reflect the last time the resource was updated, whereas the `Last-Modified` value may change when the representation is updated.
+
+### Are ids missing?
+
+No, the `id` or `uuid` attributes are not missing. As per the [TrailerVote API considerations](https://docs.trailervote.com/reference) clients **SHOULD** not need to construct URLs. Both internally and externally, where possible, we refer to resources by their fully qualified URL which _is_ their identifier, instead of something like a UUID.
+
+## Usage
+
+This gem is based on [`media_types`](https://github.com/SleeplessByte/media-types-ruby), and inherits all the functionality from that gem. In general, you can use `trailer_vote-media_types` in the following ways:
+
+### `Accept` and `Content-Type` construction
+
+All the media types can be turned into a header value, both acceptable for the `Accept` and `Content-Type` headers:
+
+```ruby
+TrailerVote::MediaTypes::Configuration.to_constructable.version(2).to_s
+# => "application/vnd.trailervote.configuration.v2+json"
+```
+
+The [`Constructable`](https://www.rubydoc.info/gems/media_types/MediaTypes/Constructable) result of `#to_constructable` allows for chaining the various options in our media types, namely `view` (e.g. `index`, `create`) and `version`. The default `suffix` is none for binary types and `json` for text type, as we don't support XML at the moment.
+
+It is **recommended** to always include `.version(n)`, otherwise you will get the newest version, which might not be what you support in the code.
+
+### `Accept` with quality parameter
+
+If you want to have multiple `Accept` values, but with different priorities, `Constructable#to_s` accepts an additional parameter to set this. For example, if you want to make a fully qualified `Accept` header and you prefer product version 2, but accept version 1 as well:
+
+```ruby
+[
+    TrailerVote::MediaTypes::Product.to_constructable.version(2).to_s,
+    TrailerVote::MediaTypes::Product.to_constructable.version(1).to_s(0.9),
+    TrailerVote::MediaTypes::Errors.to_constructable.version(1).to_s(0.1)
+].join(', ')
+# => "application/vnd.trailervote.configuration.product.v2+json,
+#       application/vnd.trailervote.configuration.product.v1+json; q=0.9,
+#       application/vnd.trailervote.errors.v1+json; q=0.1"
+```
+
+### Data validation
+
+All the media types come equipped with validations, for most known / expected permutations of views and versions. Validations are based on [`Scheme`](https://www.rubydoc.info/gems/media_types/MediaTypes/Scheme) from the [`media_types`](https://github.com/SleeplessByte/media-types-ruby) gem.
+
+```ruby
+media_type = TrailerVote::MediaTypes::ClientConfiguration.to_constructable.version(1)
+# => application/vnd.trailervote.client_configuration.v1+json
+
+media_type.valid?(
+    configuration: {
+        place: "https://fake.trailervote.com/api/places/435ec0b8-100d-4e92-8a17-04bc77e90880",
+        persona: "https://fake.trailervote.com/api/persona/e03a1c72-8bce-408c-a6e4-de215e73dd92"
+    }
+)
+# => true
+
+media_type.validate!(
+    configuration: {
+        place: "https://fake.trailervote.com/api/places/435ec0b8-100d-4e92-8a17-04bc77e90880",
+    }
+)
+# => raises MediaTypes::Scheme::ExhaustedOutputError: Missing keys in output: [:persona] at [.->configuration]
+```
+
+### `Mime::Type` registration
+
+In case you use `action_dispatch/http/mime_type`, you may register the TrailerVote Media Types into the `Mime::Type` registry like so:
+```ruby
+TrailerVote::MediaTypes::Persona.register
+# => [...] # Array of registered types, each version, each suffix permutation, all aliases
+```
+
+You can now look them up in the registry:
+
+```ruby
+media_type = TrailerVote::MediaTypes::Persona.to_constructable.version(1).to_s
+# => "application/vnd.trailervote.persona.v1+json"
+
+Mime::Type.lookup(media_type)
+# => Mime::Type entry
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can
+also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the
+version number in `version.rb`, and then run `bundle update trailer_vote-media_types` in any repository that depends on
+this gem. If you have permissions, you may call `bundle exec rake release` to create a new git tag, push
+git commits and tags, and push the `.gem` file to the rubygems gem server.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at [TrailerVote/trailervote-media-types](https://github.com/TrailerVote/trailervote-media-types)

data/Rakefile

@@ -1,12 +1,12 @@
-# frozen_string_literal: true
-
-require 'bundler/gem_tasks'
-require 'rake/testtask'
-
-Rake::TestTask.new(:test) do |t|
-  t.libs << 'test'
-  t.libs << 'lib'
-  t.test_files = FileList['test/**/*_test.rb']
-end
-
-task default: :test
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task default: :test

data/bin/console

@@ -1,16 +1,16 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require 'bundler/setup'
-require 'trailer_vote/media_types'
-require 'awesome_print'
-
-# You can add fixtures and/or initialization code here to make experimenting
-# with your gem easier. You can also use a different console, if you like.
-
-# (If you use this, don't forget to add pry to your Gemfile!)
-# require "pry"
-# Pry.start
-
-require 'irb'
-IRB.start(__FILE__)
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'trailer_vote/media_types'
+require 'awesome_print'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start(__FILE__)

data/bin/setup

@@ -1,8 +1,8 @@
-#!/usr/bin/env bash
-set -euo pipefail
-IFS=$'\n\t'
-set -vx
-
-bundle install
-
-# Do any other automated setup that you need to do here
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here