poms 2.3.1 → 2.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 645a283cdf22cf6bf5ee6d01140c7e3d0981f277
-  data.tar.gz: 30c1d1656d2c7d98605f34a05e176e412f2af559
+  metadata.gz: ca74a26e7ddddcefe3cf672fb7a5503f9c89d519
+  data.tar.gz: 26b66cddf53204d26e438fa59f05b9dfa80e8dfc
 SHA512:
-  metadata.gz: 4b2bd125936c59c1840e215ea9c410e1cd355b0fdbdbc23252eaee2726368853ec44b548d24d0a2ff3dee45e6e3efe7b277e6eced5d1495b46a7a98378d2b763
-  data.tar.gz: b4fad474ea904415dedf6a11708a1ea6fb0ede925f6407b396e8bed4058e0c736697faedc5e8f3ea6b5bc8c217d9516eb886d1a1aad36c519b781b8949d909e9
+  metadata.gz: 5ca9b10cc25fa8e2c7ca97bedf79945ddea44d411b19f9fbbb2acf38774ffbccd9053ae2e958c62ce030d248cafc0c2636c0ea1d776218662ca7bc6a4369745d
+  data.tar.gz: fbf4ddc8db109d6d7b2fcea5e3ae7203a9a6d5662290e567e60b22ef57f5e55e24b9a2714f3687bbdd718254f3dc720955051f9f6ec90237771bb0fa5ada607e

data/.gitignore

@@ -16,3 +16,4 @@ test/tmp
 test/version_tmp
 tmp
 .ruby-version
+.rbenv-vars

data/.rubocop.yml

@@ -30,6 +30,9 @@ Style/AndOr:
 Style/FrozenStringLiteralComment:
   Enabled: false
 
+Style/ModuleFunction:
+  Enabled: false
+
 ModuleLength:
   Exclude:
     - spec/**/*_spec.rb # specs are only in module for easier access to functions

data/CHANGELOG.md

@@ -4,6 +4,10 @@
 
 * Add `Poms::Fields.descendants_of` which returns all descendantOf's of specific type.
 
+## 2.3.0
+
+* Make `members` run as a POST request.
+
 ## 2.2.1
 
 * Add `Poms::Fields.broadcasts` which returns the associated broadcasters in an Array

data/README.md

@@ -84,3 +84,7 @@ Gem | API
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create new Pull Request
+
+## Releasing
+
+Make sure to use [Semantic Versioning](https://semver.org/) when bumping the version. To release tag the master branch with the version and then push to rubygems. `rake release` does this for you.

data/lib/poms/fields.rb

@@ -1,167 +1,13 @@
-require 'poms/timestamp'
+require 'poms/fields/details'
+require 'poms/fields/media'
+require 'poms/fields/schedule'
 
 module Poms
-  # This module contains functions to extract things from a Poms hash that may
-  # be harder to access, or are accessed in multiple places.
+  # Collection module that import the various field modules to the higher
+  # Poms::Fields level
   module Fields
-    module_function
-
-    IMAGE_TYPE_PRIORITY = %w[PROMO_LANDSCAPE PICTURE].freeze
-
-    # Returns the title, main by default
-    def title(item, type = 'MAIN')
-      value_of_type(item, 'titles', type)
-    end
-
-    # Returns the description, main by default
-    def description(item, type = 'MAIN')
-      value_of_type(item, 'descriptions', type)
-    end
-
-    # Returns all the descendantOfs of the type given.
-    # @param item The Poms Hash
-    # @param type The type of descendantOfs we want
-    def descendants_of(item, type)
-      item['descendantOf'].select { |descendant| descendant['type'] == type }
-    end
-
-    def broadcasters(item)
-      Array(item['broadcasters']).map do |key_value_pair|
-        key_value_pair['value']
-      end
-    end
-
-    # Returns the images from the hash
-    def images(item)
-      item['images'].try(:sort_by) do |i|
-        image_order_index(i)
-      end
-    end
-
-    # Extracts the image id from an image hash
-    # Expects a hash of just an image from POMS
-    def image_id(image)
-      return unless image['imageUri']
-      image['imageUri'].split(':').last
-    end
-
-    def image_order_index(image)
-      IMAGE_TYPE_PRIORITY.index(image['type']) || IMAGE_TYPE_PRIORITY.size
-    end
-
-    # Returns the id of the first image or nil if there are none.
-    def first_image_id(item)
-      return unless images(item)
-      image_id(images(item).first)
-    end
-
-    def mid(item)
-      item['mid']
-    end
-
-    # Returns an array of odi stream types.
-    # Note: this code is copied from Broadcast and it is assumed it was working
-    # there.
-    def odi_streams(item)
-      locations = item['locations']
-      return [] if locations.nil? || locations.empty?
-      odi_streams = locations.select { |l| l['programUrl'].match(/^odi/) }
-      streams = odi_streams.map do |l|
-        l['programUrl'].match(%r{^[\w+]+\:\/\/[\w\.]+\/video\/(\w+)\/\w+})[1]
-      end
-      streams.uniq
-    end
-
-    # Returns the enddate of the publication of an internet vod if present.
-    def available_until(item)
-      return if item['predictions'].blank?
-      internetvod = item['predictions']
-        .find { |p| p['platform'] == 'INTERNETVOD' }
-      return unless internetvod
-      Timestamp.to_datetime(internetvod['publishStop'])
-    end
-
-    # Returns the index at which it is in the parent. When no
-    # :member_of keyword is given, it will return the first found
-    # index. Else, when a parent is found with matching member_of
-    # midref, it returns that index. Else returns nil.
-    # @param item The Poms Hash
-    # @param optional :member_of The midref of parent for which we
-    # seek the index
-    def position(item, member_of: nil)
-      parent(item, midref: member_of).try(:[], 'index')
-    end
-
-    # Finds a parent the data is "member of". If :midref is given, it
-    # will look for the parent that matches that mid and return nil if
-    # not found. Without the :midref it will return the first parent.
-    # @param item The Poms Hash
-    # @param optional midref The midref of parent we seek.
-    def parent(item, midref: nil)
-      if midref
-        parents(item).find { |parent| parent['midRef'] == midref }
-      else
-        parents(item).first
-      end
-    end
-
-    # Returns the parents that the element is member of. Will always
-    # return an array.
-    def parents(item)
-      Array(item['memberOf'])
-    end
-
-    # Returns the NICAM age rating of the item or ALL if no age rating exists
-    def age_rating(item)
-      item.fetch('ageRating', 'ALL')
-    end
-
-    # Returns an array containing zero or more content ratings of the item
-    # Possible content ratings are:
-    # ANGST, DISCRIMINATIE, DRUGS_EN_ALCOHOL, GEWELD, GROF_TAALGEBRUIK and SEKS
-    def content_ratings(item)
-      item.fetch('contentRatings', [])
-    end
-
-    # Returns an array of start and end times for the  scheduled events for
-    # this item. It returns an empty array if no events are found. You can pass
-    # in a block to filter the events on data that is not returned, like
-    # channel.
-    #
-    # @param item The Poms hash
-    def schedule_events(item)
-      events = item.fetch('scheduleEvents', [])
-      events = yield(events) if block_given?
-      events.map { |event| hash_event(event) }
-    end
-
-    # Turns the event into a hash.
-    def hash_event(event)
-      {
-        'starts_at' => Timestamp.to_datetime(event.fetch('start')),
-        'ends_at' => Timestamp.to_datetime(event.fetch('start') +
-          event.fetch('duration'))
-      }
-    end
-    private_class_method :hash_event
-
-    # Poms has arrays of hashes for some types that have a value and type. This
-    # is a way to access those simply.
-    #
-    # Example:
-    #    item = {'titles' => [{'value' => 'Main title', 'type' => 'MAIN'},
-    #           {'value' => 'Subtitle', 'type' => 'SUB'}] }
-    #    value_of_type(item, 'titles', 'MAIN') => 'Main title'
-    #
-    # @param item The Poms hash
-    # @param key The key of the array we want to look in
-    # @param type The type to select
-    def value_of_type(item, key, type)
-      return unless item && item[key]
-      res = item[key].find { |value| value['type'] == type }
-      return unless res
-      res['value']
-    end
-    private_class_method :value_of_type
+    extend Poms::Fields::Details
+    extend Poms::Fields::Media
+    extend Poms::Fields::Schedule
   end
 end

data/lib/poms/fields/details.rb

@@ -0,0 +1,98 @@
+require 'poms/timestamp'
+module Poms
+  module Fields
+    # Module to find details from for ex. attributes on poms items.
+    module Details
+      extend self
+
+      # Returns the title, main by default
+      def title(item, type = 'MAIN')
+        value_of_type(item, 'titles', type)
+      end
+
+      # Returns the description, main by default
+      def description(item, type = 'MAIN')
+        value_of_type(item, 'descriptions', type)
+      end
+
+      # Returns all the descendantOfs of the type given.
+      # @param item The Poms Hash
+      # @param type The type of descendantOfs we want
+      def descendants_of(item, type)
+        item['descendantOf'].select { |descendant| descendant['type'] == type }
+      end
+
+      def broadcasters(item)
+        Array(item['broadcasters']).map do |key_value_pair|
+          key_value_pair['value']
+        end
+      end
+
+      def mid(item)
+        item['mid']
+      end
+
+      # Returns the index at which it is in the parent. When no
+      # :member_of keyword is given, it will return the first found
+      # index. Else, when a parent is found with matching member_of
+      # midref, it returns that index. Else returns nil.
+      # @param item The Poms Hash
+      # @param optional :member_of The midref of parent for which we
+      # seek the index
+      def position(item, member_of: nil)
+        parent(item, midref: member_of).try(:[], 'index')
+      end
+
+      # Finds a parent the data is "member of". If :midref is given, it
+      # will look for the parent that matches that mid and return nil if
+      # not found. Without the :midref it will return the first parent.
+      # @param item The Poms Hash
+      # @param optional midref The midref of parent we seek.
+      def parent(item, midref: nil)
+        if midref
+          parents(item).find { |parent| parent['midRef'] == midref }
+        else
+          parents(item).first
+        end
+      end
+
+      # Returns the parents that the element is member of. Will always
+      # return an array.
+      def parents(item)
+        Array(item['memberOf'])
+      end
+
+      # Returns the NICAM age rating of the item or ALL if no age rating exists
+      def age_rating(item)
+        item.fetch('ageRating', 'ALL')
+      end
+
+      # Returns an array containing zero or more content ratings of the item
+      # Possible content ratings are:
+      # ANGST, DISCRIMINATIE, DRUGS_EN_ALCOHOL, GEWELD, GROF_TAALGEBRUIK and
+      # SEKS
+      def content_ratings(item)
+        item.fetch('contentRatings', [])
+      end
+
+      # Poms has arrays of hashes for some types that have a value and type.
+      # This is a way to access those simply.
+      #
+      # Example:
+      #    item = {'titles' => [{'value' => 'Main title', 'type' => 'MAIN'},
+      #           {'value' => 'Subtitle', 'type' => 'SUB'}] }
+      #    value_of_type(item, 'titles', 'MAIN') => 'Main title'
+      #
+      # @param item The Poms hash
+      # @param key The key of the array we want to look in
+      # @param type The type to select
+      def value_of_type(item, key, type)
+        return unless item && item[key]
+        res = item[key].find { |value| value['type'] == type }
+        return unless res
+        res['value']
+      end
+      private_class_method :value_of_type
+    end
+  end
+end

data/lib/poms/fields/media.rb

@@ -0,0 +1,34 @@
+module Poms
+  module Fields
+    # Module to retrieve media related information from poms items.
+    module Media
+      extend self
+
+      IMAGE_TYPE_PRIORITY = %w[PROMO_LANDSCAPE PICTURE].freeze
+
+      # Returns the images from the hash
+      def images(item)
+        item['images'].try(:sort_by) do |i|
+          image_order_index(i)
+        end
+      end
+
+      # Extracts the image id from an image hash
+      # Expects a hash of just an image from POMS
+      def image_id(image)
+        return unless image['imageUri']
+        image['imageUri'].split(':').last
+      end
+
+      def image_order_index(image)
+        IMAGE_TYPE_PRIORITY.index(image['type']) || IMAGE_TYPE_PRIORITY.size
+      end
+
+      # Returns the id of the first image or nil if there are none.
+      def first_image_id(item)
+        return unless images(item)
+        image_id(images(item).first)
+      end
+    end
+  end
+end

data/lib/poms/fields/schedule.rb

@@ -0,0 +1,78 @@
+require 'poms/timestamp'
+
+module Poms
+  module Fields
+    # modeule to retrieve scheduling/timtable related information from
+    # poms items.
+    module Schedule
+      extend self
+
+      # Returns an array of odi stream types.
+      # Note: this code is copied from Broadcast
+      # and it is assumed it was working there.
+      def odi_streams(item)
+        locations = item['locations']
+        return [] if locations.nil? || locations.empty?
+        odi_streams = locations.select { |l| l['programUrl'].match(/^odi/) }
+        streams = odi_streams.map do |l|
+          l['programUrl'].match(%r{^[\w+]+\:\/\/[\w\.]+\/video\/(\w+)\/\w+})[1]
+        end
+        streams.uniq
+      end
+
+      # Returns an array of start and end times for the  scheduled events for
+      # this item. It returns an empty array if no events are found.
+      # You can pass in a block to filter the events on data that is not
+      # returned, like channel.
+      #
+      # @param item The Poms hash
+      def schedule_events(item)
+        events = item.fetch('scheduleEvents', [])
+        events = yield(events) if block_given?
+        events.map { |event| hash_event(event) }
+      end
+
+      # Returns the first publication from an items location array which has
+      # INTERNETVOD and is PUBLISHED
+      def publication(poms_item)
+        return if poms_item['locations'].blank?
+        poms_item['locations'].find do |item|
+          item['platform'] == 'INTERNETVOD' && item['workflow'] == 'PUBLISHED'
+        end
+      end
+
+      # Return the publishStop datetime from a publication
+      def publish_stop(poms_item)
+        published_item = publication(poms_item)
+        return unless published_item
+        Timestamp.to_datetime(published_item['publishStop'])
+      end
+
+      # Return the publishStart datetime from a publication
+      def publish_start(poms_item)
+        published_item = publication(poms_item)
+        return unless published_item
+        Timestamp.to_datetime(published_item['publishStart'])
+      end
+
+      # Returns the enddate of the publication of an internet vod if present.
+      def available_until(item)
+        return if item['predictions'].blank?
+        internetvod = item['predictions']
+          .find { |p| p['platform'] == 'INTERNETVOD' }
+        return unless internetvod
+        Timestamp.to_datetime(internetvod['publishStop'])
+      end
+
+      # Turns the event into a hash.
+      def hash_event(event)
+        {
+          'starts_at' => Timestamp.to_datetime(event.fetch('start')),
+          'ends_at' => Timestamp.to_datetime(event.fetch('start') +
+            event.fetch('duration'))
+        }
+      end
+      private_class_method :hash_event
+    end
+  end
+end

data/lib/poms/version.rb

@@ -1,4 +1,4 @@
 # The version
 module Poms
-  VERSION = '2.3.1'.freeze
+  VERSION = '2.4.0'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: poms
 version: !ruby/object:Gem::Version
-  version: 2.3.1
+  version: 2.4.0
 platform: ruby
 authors:
 - Tom Kruijsen
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-10-24 00:00:00.000000000 Z
+date: 2018-12-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -228,6 +228,9 @@ files:
 - lib/poms/configuration.rb
 - lib/poms/errors.rb
 - lib/poms/fields.rb
+- lib/poms/fields/details.rb
+- lib/poms/fields/media.rb
+- lib/poms/fields/schedule.rb
 - lib/poms/timestamp.rb
 - lib/poms/version.rb
 - poms.gemspec