parliament-grom-decorators 0.27.0 → 0.27.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9420b51cfdc70c699ffbda37e7e4875c11ddc0d8
-  data.tar.gz: 83d3202ecace607648a92282e1d7228c8645061f
+  metadata.gz: 2c866a69215ac0adf7a90e112020a6172133b5ba
+  data.tar.gz: 15fd269735a2616a26b5fb105d8ab7ea5493137b
 SHA512:
-  metadata.gz: a61e8879c6ae40bf635066cb0e0f937cbbc94cb4f88d67d08195853c3f9f8fc73a6f883c5d4815e13d9c2209c2511621add79f3dd693c54686e300a78a5c2ea4
-  data.tar.gz: e38fe70757aad8f58e196443dcb148e4ae0fcb235744807069d5dabcb2d48f143657868433905945bc03683f29f7201358c8d6521d09d4ed1efbd1cb936f8ff1
+  metadata.gz: a7a09452f95927c69bfced55d6ed1d54fd03dc9f34725aaeb663514f62a6687dfb53bfe82572259f27ea7f81e3c3b1f0dec33d2e1c393b968d263168cef9b54d
+  data.tar.gz: 6383d980a79169160f2f7f50b213776fbf30e77f1eb24b9a4784537ab4651405272ac8abca7e630934c199b6f975c8058e56024aa603b721273baa26d0b8175d

data/lib/parliament/grom/decorator.rb

@@ -1,41 +1,47 @@
 require 'parliament/grom/decorator/version'
 require 'parliament/grom/decorator/helpers'
+require 'parliament/grom/decorator/answer'
+require 'parliament/grom/decorator/answering_body_allocation'
+require 'parliament/grom/decorator/article_type'
+require 'parliament/grom/decorator/audience'
+require 'parliament/grom/decorator/business_item'
+require 'parliament/grom/decorator/collection'
+require 'parliament/grom/decorator/concept'
 require 'parliament/grom/decorator/constituency_area'
 require 'parliament/grom/decorator/constituency_group'
 require 'parliament/grom/decorator/contact_point'
 require 'parliament/grom/decorator/european_region'
+require 'parliament/grom/decorator/formal_body'
+require 'parliament/grom/decorator/formal_body_chair'
+require 'parliament/grom/decorator/formal_body_membership'
+require 'parliament/grom/decorator/formal_body_type'
 require 'parliament/grom/decorator/gender'
 require 'parliament/grom/decorator/gender_identity'
+require 'parliament/grom/decorator/government_incumbency'
+require 'parliament/grom/decorator/government_position'
+require 'parliament/grom/decorator/gov_register_government_organisation'
+require 'parliament/grom/decorator/group'
 require 'parliament/grom/decorator/house'
 require 'parliament/grom/decorator/house_seat'
+require 'parliament/grom/decorator/incumbency'
+require 'parliament/grom/decorator/member_image'
 require 'parliament/grom/decorator/parliamentary_incumbency'
+require 'parliament/grom/decorator/parliaments'
 require 'parliament/grom/decorator/party'
 require 'parliament/grom/decorator/party_membership'
 require 'parliament/grom/decorator/person'
+require 'parliament/grom/decorator/position'
 require 'parliament/grom/decorator/postal_address'
+require 'parliament/grom/decorator/procedure_route'
+require 'parliament/grom/decorator/procedure_step'
+require 'parliament/grom/decorator/procedure'
+require 'parliament/grom/decorator/question'
 require 'parliament/grom/decorator/seat_incumbency'
-require 'parliament/grom/decorator/parliaments'
-require 'parliament/grom/decorator/member_image'
-require 'parliament/grom/decorator/formal_body_membership'
-require 'parliament/grom/decorator/formal_body'
-require 'parliament/grom/decorator/formal_body_type'
-require 'parliament/grom/decorator/government_incumbency'
-require 'parliament/grom/decorator/government_position'
 require 'parliament/grom/decorator/opposition_incumbency'
 require 'parliament/grom/decorator/opposition_position'
 require 'parliament/grom/decorator/web_article'
-require 'parliament/grom/decorator/audience'
-require 'parliament/grom/decorator/article_type'
-require 'parliament/grom/decorator/collection'
-require 'parliament/grom/decorator/concept'
-require 'parliament/grom/decorator/incumbency'
-require 'parliament/grom/decorator/group'
-require 'parliament/grom/decorator/gov_register_government_organisation'
-require 'parliament/grom/decorator/position'
-require 'parliament/grom/decorator/formal_body_chair'
-require 'parliament/grom/decorator/question'
-require 'parliament/grom/decorator/answer'
-require 'parliament/grom/decorator/answering_body_allocation'
+require 'parliament/grom/decorator/work_package'
+require 'parliament/grom/decorator/work_packageable_thing'
 
 # Namespace for classes and modules that handle connections to, and processing of data from the parliamentary API.
 # @since 0.1.0
@@ -46,42 +52,48 @@ module Parliament
     # @since 0.1.0
     module Decorator
       MAPPING = {
+        'Answer'                            => Answer,
+        'AnsweringBodyAllocation'           => AnsweringBodyAllocation,
+        'ArticleType'                       => ArticleType,
+        'Audience'                          => Audience,
+        'BusinessItem'                      => BusinessItem,
+        'Collection'                        => Collection,
+        'Concept'                           => Concept,
         'ConstituencyArea'                  => ConstituencyArea,
         'ConstituencyGroup'                 => ConstituencyGroup,
         'ContactPoint'                      => ContactPoint,
         'EuropeanRegion'                    => EuropeanRegion,
+        'FormalBodyChair'                   => FormalBodyChair,
+        'FormalBodyMembership'              => FormalBodyMembership,
+        'FormalBodyType'                    => FormalBodyType,
+        'FormalBody'                        => FormalBody,
         'Gender'                            => Gender,
         'GenderIdentity'                    => GenderIdentity,
+        'GovernmentIncumbency'              => GovernmentIncumbency,
+        'GovernmentPosition'                => GovernmentPosition,
+        'GovRegisterGovernmentOrganisation' => GovRegisterGovernmentOrganisation,
+        'Group'                             => Group,
         'House'                             => House,
         'HouseSeat'                         => HouseSeat,
+        'Incumbency'                        => Incumbency,
         'MemberImage'                       => MemberImage,
+        'OppositionIncumbency'              => OppositionIncumbency,
+        'OppositionPosition'                => OppositionPosition,
         'ParliamentPeriod'                  => ParliamentPeriod,
         'ParliamentaryIncumbency'           => ParliamentaryIncumbency,
         'Party'                             => Party,
         'PartyMembership'                   => PartyMembership,
         'Person'                            => Person,
+        'Position'                          => Position,
+        'Procedure'                         => Procedure,
+        'ProcedureRoute'                    => ProcedureRoute,
+        'ProcedureStep'                     => ProcedureStep,
         'PostalAddress'                     => PostalAddress,
+        'Question'                          => Question,
         'SeatIncumbency'                    => SeatIncumbency,
-        'FormalBodyMembership'              => FormalBodyMembership,
-        'FormalBody'                        => FormalBody,
-        'FormalBodyType'                    => FormalBodyType,
-        'GovernmentIncumbency'              => GovernmentIncumbency,
-        'GovernmentPosition'                => GovernmentPosition,
-        'OppositionIncumbency'              => OppositionIncumbency,
-        'OppositionPosition'                => OppositionPosition,
         'WebArticle'                        => WebArticle,
-        'Audience'                          => Audience,
-        'ArticleType'                       => ArticleType,
-        'Collection'                        => Collection,
-        'Concept'                           => Concept,
-        'Incumbency'                        => Incumbency,
-        'Group'                             => Group,
-        'GovRegisterGovernmentOrganisation' => GovRegisterGovernmentOrganisation,
-        'Position'                          => Position,
-        'FormalBodyChair'                   => FormalBodyChair,
-        'Question'                          => Question,
-        'Answer'                            => Answer,
-        'AnsweringBodyAllocation'           => AnsweringBodyAllocation
+        'WorkPackage'                       => WorkPackage,
+        'WorkPackageableThing'              => WorkPackageableThing
       }.freeze
 
       class << self

data/lib/parliament/grom/decorator/business_item.rb

@@ -0,0 +1,45 @@
+module Parliament
+  module Grom
+    module Decorator
+      # Decorator namespace for Grom::Node instances with type: https://id.parliament.uk/schema/BusinessItem
+      module BusinessItem
+        include Helpers::DateHelper
+        # Alias businessItemHasProcedureStep with fallback.
+        #
+        # @return [Array, Array] an array of ProcedureStep Grom::Nodes of the Grom::Node or an empty array.
+        def procedure_steps
+          respond_to?(:businessItemHasProcedureStep) ? businessItemHasProcedureStep : []
+        end
+
+        # Each procedure step has a distance from origin
+        #
+        # @return [Array] an array of ProcedureStep Grom::Nodes sorted by distance from origin.
+        def sorted_procedure_steps_by_distance
+          procedure_steps.sort_by(&:distance_from_origin)
+        end
+
+        # Alias businessItemDate with fallback.
+        #
+        # @return [Date, nil] a laying date or nil.
+        def date
+          respond_to?(:businessItemDate) ? DateTime.parse(businessItemDate) : nil
+        end
+
+        # Alias businessItemHasBusinessItemWebLink with fallback.
+        #
+        # @return [String, String] a web link to view business item Grom::Node or an empty string.
+        def weblink
+          respond_to?(:businessItemHasBusinessItemWebLink) ? businessItemHasBusinessItemWebLink : ''
+        end
+
+        # Alias layingHasLayingBody with fallback.
+        # NB. One and only one group has to lay, so it will always be the first laying body
+        #
+        # @return [Grom::Node, nil] a Grom::Node representing the group that did the laying.
+        def laying_body
+          respond_to?(:layingHasLayingBody) ? layingHasLayingBody.first : nil
+        end
+      end
+    end
+  end
+end

data/lib/parliament/grom/decorator/procedure.rb

@@ -0,0 +1,22 @@
+module Parliament
+  module Grom
+    module Decorator
+      # Decorator namespace for Grom::Node instances with type: https://id.parliament.uk/schema/Procedure
+      module Procedure
+        # Alias procedureName with fallback.
+        #
+        # @return [String, String] the name of the Grom::Node or an empty string.
+        def name
+          respond_to?(:procedureName) ? procedureName : ''
+        end
+
+        # Alias procedureHasWorkPackage with fallback.
+        #
+        # @return [Array, Array] an array of WorkPackage Grom::Nodes or an empty array.
+        def work_packages
+          respond_to?(:procedureHasWorkPackage) ? procedureHasWorkPackage : []
+        end
+      end
+    end
+  end
+end

data/lib/parliament/grom/decorator/procedure_route.rb

@@ -0,0 +1,15 @@
+module Parliament
+  module Grom
+    module Decorator
+      # Decorator namespace for Grom::Node instances with type: https://id.parliament.uk/schema/ProcedureRoute
+      module ProcedureRoute
+        # Alias procedureRouteIsToProcedureStep with fallback.
+        #
+        # @return [Array, Array] an array of ProcedureStep Grom::Nodes or an empty array.
+        def steps
+          respond_to?(:procedureRouteIsToProcedureStep) ? procedureRouteIsToProcedureStep : []
+        end
+      end
+    end
+  end
+end

data/lib/parliament/grom/decorator/procedure_step.rb

@@ -0,0 +1,29 @@
+module Parliament
+  module Grom
+    module Decorator
+      # Decorator namespace for Grom::Node instances with type: https://id.parliament.uk/schema/ProcedureStep
+      module ProcedureStep
+        # Alias procedureStepName with fallback.
+        #
+        # @return [String, String] the name of the Grom::Node or an empty string.
+        def name
+          respond_to?(:procedureStepName) ? procedureStepName : ''
+        end
+
+        # Alias procedureStepHasHouse with fallback.
+        #
+        # @return [Array, Array] an array of House Grom::Nodes or an empty array.
+        def houses
+          respond_to?(:procedureStepHasHouse) ? procedureStepHasHouse : []
+        end
+
+        # Alias distance with fallback.
+        #
+        # @return [Integer, Integer] an array of House Grom::Nodes or an empty array.
+        def distance_from_origin
+          respond_to?(:distance) ? distance.to_i : 0
+        end
+      end
+    end
+  end
+end

data/lib/parliament/grom/decorator/version.rb

@@ -1,7 +1,7 @@
 module Parliament
   module Grom
     module Decorator
-      VERSION = '0.27.0'.freeze
+      VERSION = '0.27.1'.freeze
     end
   end
 end

data/lib/parliament/grom/decorator/work_package.rb

@@ -0,0 +1,42 @@
+module Parliament
+  module Grom
+    module Decorator
+      # Decorator namespace for Grom::Node instances with type: https://id.parliament.uk/schema/WorkPackage
+      module WorkPackage
+        # Alias workPackageHasProcedure with fallback.
+        # NB: Currently, work packages only have one procedure
+        #
+        # @return [Grom::Node, nil] a Procedure Grom::Node of the Grom::Node or nil.
+        def procedure
+          respond_to?(:workPackageHasProcedure) ? workPackageHasProcedure.first : nil
+        end
+
+        # Alias workPackageHasWorkPackageableThing with fallback.
+        # NB: Currently, work packages only have one work packageable thing
+        #
+        # @return [Grom::Node, nil] a Procedure Grom::Node of the Grom::Node or nil.
+        def work_packageable_thing
+          respond_to?(:workPackageHasWorkPackageableThing) ? workPackageHasWorkPackageableThing.first : nil
+        end
+
+        # Alias workPackageHasBusinessItem with fallback.
+        #
+        # @return [Array, Array] an array of BusinessItem Grom::Nodes or an empty array.
+        def business_items
+          respond_to?(:workPackageHasBusinessItem) ? workPackageHasBusinessItem : []
+        end
+
+        # @return [Grom::Node, nil] a BusinessItem Grom::Node or nil.
+        def oldest_business_item
+          return unless business_items.any?
+          business_items.sort_by(&:date).last
+        end
+
+        # @return [Date, nil] an array of BusinessItem Grom::Nodes or an empty array.
+        def oldest_business_item_date
+          oldest_business_item&.date
+        end
+      end
+    end
+  end
+end

data/lib/parliament/grom/decorator/work_packageable_thing.rb

@@ -0,0 +1,55 @@
+module Parliament
+  module Grom
+    module Decorator
+      # Decorator namespace for Grom::Node instances with type: https://id.parliament.uk/schema/WorkPackageableThing
+      module WorkPackageableThing
+        # Alias workPackageableThingName with fallback.
+        #
+        # @return [String, String] the name of the Grom::Node or an empty string.
+        def name
+          respond_to?(:workPackageableThingName) ? workPackageableThingName : ''
+        end
+
+        # Alias workPackageableThingHasWorkPackage with fallback.
+        # NB: Currently, a work packageable thing only has one work package
+        #
+        # @return [Grom::Node, nil] a WorkPackage Grom::Node or nil.
+        def work_package
+          respond_to?(:workPackageableThingHasWorkPackage) ? workPackageableThingHasWorkPackage.first : nil
+        end
+
+        # Alias workPackageableThingHasWorkPackage with fallback.
+        #
+        # @return [String, String] a web link or an empty string.
+        def weblink
+          respond_to?(:workPackageableThingHasWorkPackageableThingWebLink) ? workPackageableThingHasWorkPackageableThingWebLink : ''
+        end
+
+        # Uses work_package method in this set of decorators, which could return nil.
+        # Uses business_items method in WorkPackage decorators, which could return an empty array.
+        #
+        # @return [Boolean] whether a work packageable thing has both a work package and some business items.
+        def work_package_and_business_items?
+          work_package ? work_package.business_items.any? : false
+        end
+
+        # @return [Grom::Node, nil] a BusinessItem Grom::Node or nil.
+        def oldest_business_item
+          work_package_and_business_items? ? work_package.business_items.sort_by(&:date).last : nil
+        end
+
+        # @return [Date, nil] an array of BusinessItem Grom::Nodes or an empty array.
+        def oldest_business_item_date
+          oldest_business_item&.date
+        end
+
+        # Alias workPackageableThingComingIntoForceDate with fallback.
+        #
+        # @return [DateTime, nil] the expiry date (time limit) of a work package or nil.
+        def time_limit_for_objection_date
+          respond_to?(:workPackageableThingTimeLimitForObjectionEndDate) ? DateTime.parse(workPackageableThingTimeLimitForObjectionEndDate) : nil
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: parliament-grom-decorators
 version: !ruby/object:Gem::Version
-  version: 0.27.0
+  version: 0.27.1
 platform: ruby
 authors:
 - Rebecca Appleyard
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-05-18 00:00:00.000000000 Z
+date: 2018-05-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -177,6 +177,7 @@ files:
 - lib/parliament/grom/decorator/answering_body_allocation.rb
 - lib/parliament/grom/decorator/article_type.rb
 - lib/parliament/grom/decorator/audience.rb
+- lib/parliament/grom/decorator/business_item.rb
 - lib/parliament/grom/decorator/collection.rb
 - lib/parliament/grom/decorator/concept.rb
 - lib/parliament/grom/decorator/constituency_area.rb
@@ -208,10 +209,15 @@ files:
 - lib/parliament/grom/decorator/person.rb
 - lib/parliament/grom/decorator/position.rb
 - lib/parliament/grom/decorator/postal_address.rb
+- lib/parliament/grom/decorator/procedure.rb
+- lib/parliament/grom/decorator/procedure_route.rb
+- lib/parliament/grom/decorator/procedure_step.rb
 - lib/parliament/grom/decorator/question.rb
 - lib/parliament/grom/decorator/seat_incumbency.rb
 - lib/parliament/grom/decorator/version.rb
 - lib/parliament/grom/decorator/web_article.rb
+- lib/parliament/grom/decorator/work_package.rb
+- lib/parliament/grom/decorator/work_packageable_thing.rb
 - makefile
 - parliament-grom-decorators.gemspec
 homepage: http://github.com/ukparliament/parliament-grom-decorators