parliament-grom-decorators 0.0.1.pre

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b2f75a3801ad85977ad528da1b1f2c0d3f26629b
+  data.tar.gz: 6448048f224bd2ee396c9e3ec456ea0111116761
+SHA512:
+  metadata.gz: bc564c635935c2caf45966685c4a165c9f2329b17ca946d1312477d88354d668adfef4b6584b0c2fce20283a88d3ef8db2dce1df671110ca52dbe2416ced0c67
+  data.tar.gz: 29c972949860372dfb5e4b4c227f40515e8785c2452fde5b50a4da477bec03e4fa59b7a6a1e06da98860c5d15dd9fd4cd6dd21fe1ee67f35bcac3271968f2352

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.gem
+.idea
+
+# rspec failure tracking
+.rspec_status

data/.hound.yml

@@ -0,0 +1,4 @@
+ruby:
+  config_file: .rubocop.yml
+
+fail_on_violations: true

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.rubocop.yml

@@ -0,0 +1,55 @@
+Metrics/LineLength:
+  Description: 'Limit lines to 120 characters.'
+  Max: 120
+  IgnoredPatterns: ['\A#', '\A([ ]{2}|[ ]{4})#']
+
+Style/SpaceBeforeFirstArg:
+  Enabled: false
+
+Style/BracesAroundHashParameters:
+  Enabled: false
+
+Style/IndentHash:
+  EnforcedStyle: consistent
+
+Style/AlignHash:
+  Severity: fatal
+  Enabled: true
+  EnforcedHashRocketStyle: table
+  EnforcedColonStyle: table
+
+Style/AlignParameters:
+  EnforcedStyle: with_fixed_indentation
+
+Style/StringLiterals:
+  EnforcedStyle: single_quotes
+
+Style/CollectionMethods:
+  PreferredMethods:
+    collect: 'map'
+    collect!: 'map!'
+    inject: 'reduce'
+    detect: 'find'
+    find_all: 'select'
+
+Style/DotPosition:
+  EnforcedStyle: leading
+
+Style/DoubleNegation:
+  Enabled: false
+
+Style/SpaceAroundOperators:
+  # When true, allows most uses of extra spacing if the intent is to align
+  # with an operator on the previous or next line, not counting empty lines
+  # or comment lines.
+  AllowForAlignment: true
+
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+AllCops:
+  Exclude:
+    - '*.gemspec'
+    - 'vendor/**/*'
+    - 'spec/**/*'
+    - 'tmp/**/*'

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.3.1

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at mattrayner1@gmail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,10 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in parliament-grom-decorator.gemspec
+gemspec
+
+# Include coveralls for CI coverage reports
+gem 'coveralls', require: false
+
+gem 'parliament-ntriple', path: '../parliament-ntriple'
+gem 'parliament-ruby', path: '../parliament-ruby'

data/LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) 2016-2017 United Kingdom Parliament
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,47 @@
+# Parliament::Grom::Decorators
+
+[parliament-grom-decorators](http://rubygems.org/gems/parliament-grom-decorators) is a gem created by the [Parliamentary Digital Service](https://www.parliament.uk/mps-lords-and-offices/offices/bicameral/parliamentary-digital-service/) to allow Grom::Node objects to be extended with alias methods.
+
+> **NOTE:** This gem is in active development and is likely to change at short notice. It is not recommended that you use this in any production environment.
+
+## Requirements
+[parliament-grom-decorators](http://github.com/ukparliament/parliament-grom-decorators) requires the following:
+* [Ruby](https://www.ruby-lang.org/en/)
+* [Bundler](http://http://bundler.io/)
+
+## Installation
+
+This gem is currently not available on RubyGems. To use it in an application, install it directly from GitHub via your Gemfile
+```bash
+gem 'parliament-grom-decorators', git: 'https://github.com/ukparliament/parliament-grom-decorators.git', branch: 'master'
+```
+
+## Usage
+
+This gem's main function is to extend Grom::Node objects with alias methods.
+
+> **Note:** Comprehensive class documentation can be found on [rubydocs](http://www.rubydoc.info/github/ukparliament/parliament-grom-decorators/master/file/README.md).
+
+## Getting Started with Development
+To clone the repository and set up the dependencies, run the following:
+```bash
+git clone https://github.com/ukparliament/parliament-grom-decorators.git
+cd parliament-grom-decorators
+bundle install
+```
+
+### Running the tests
+We use [RSpec](http://rspec.info/) as our testing framework and tests can be run using:
+```bash
+bundle exec rake
+```
+
+## Contributing
+If you wish to submit a bug fix or feature, you can create a pull request and it will be merged pending a code review.
+
+1. Fork the repository
+1. Create your feature branch (`git checkout -b my-new-feature`)
+1. Commit your changes (`git commit -am 'Add some feature'`)
+1. Push to the branch (`git push origin my-new-feature`)
+1. Ensure your changes are tested using [Rspec](http://rspec.info/)
+1. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'parliament/grom/decorator'
+
+# 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

@@ -0,0 +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

data/lib/parliament/grom/decorator.rb

@@ -0,0 +1,40 @@
+require 'parliament/grom/decorator/version'
+require 'parliament/grom/decorator/constituency_area'
+require 'parliament/grom/decorator/constituency_group'
+require 'parliament/grom/decorator/contact_point'
+require 'parliament/grom/decorator/gender'
+require 'parliament/grom/decorator/gender_identity'
+require 'parliament/grom/decorator/house'
+require 'parliament/grom/decorator/house_incumbency'
+require 'parliament/grom/decorator/house_seat'
+require 'parliament/grom/decorator/incumbency'
+require 'parliament/grom/decorator/party'
+require 'parliament/grom/decorator/party_membership'
+require 'parliament/grom/decorator/person'
+require 'parliament/grom/decorator/postal_address'
+require 'parliament/grom/decorator/seat_incumbency'
+
+# Namespace for classes and modules that handle connections to, and processing of data from the parliamentary API.
+# @since 0.1.0
+module Parliament
+  module Grom
+    # Namespace for Grom decorators.
+    #
+    # @since 0.1.0
+    module Decorator
+      # Decorates objects with alias methods extended from its decorator module.
+      #
+      # @param [Grom::Node] object the object to be decorated.
+      def self.decorate(object)
+        return object unless object.respond_to?(:type)
+
+        object_type = ::Grom::Helper.get_id(object.type)
+
+        return object unless constants.include?(object_type.to_sym)
+
+        decorator_module = Object.const_get("Parliament::Grom::Decorator::#{object_type}")
+        object.extend(decorator_module)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,29 @@
+module Parliament
+  module Grom
+    module Decorator
+      # Decorator namespace for Grom::Node instances with type: http://id.ukpds.org/schema/ConstituencyArea
+      module ConstituencyArea
+        # Alias constituencyAreaLatitude with fallback.
+        #
+        # @return [String, String] the latitude of the Grom::Node or an empty string.
+        def latitude
+          respond_to?(:constituencyAreaLatitude) ? constituencyAreaLatitude : ''
+        end
+
+        # Alias constituencyAreaLongitude with fallback.
+        #
+        # @return [String, String] the longitude of the Grom::Node or an empty string.
+        def longitude
+          respond_to?(:constituencyAreaLongitude) ? constituencyAreaLongitude : ''
+        end
+
+        # Alias constituencyAreaExtent with fallback.
+        #
+        # @return [String, String] the polygon of the Grom::Node or an empty string.
+        def polygon
+          respond_to?(:constituencyAreaExtent) ? constituencyAreaExtent : ''
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,94 @@
+module Parliament
+  module Grom
+    module Decorator
+      # Decorator namespace for Grom::Node instances with type: http://id.ukpds.org/schema/ConstituencyGroup
+      module ConstituencyGroup
+        # Alias constituencyGroupName with fallback.
+        #
+        # @return [String, String] the name of the Grom::Node or an empty string.
+        def name
+          respond_to?(:constituencyGroupName) ? constituencyGroupName : ''
+        end
+
+        # Alias constituencyGroupStartDate with fallback.
+        #
+        # @return [DateTime, nil] the start date of the Grom::Node or nil.
+        def start_date
+          @start_date ||= respond_to?(:constituencyGroupStartDate) ? DateTime.parse(constituencyGroupStartDate) : nil
+        end
+
+        # Alias constituencyGroupEndDate with fallback.
+        #
+        # @return [DateTime, nil] the end date of the Grom::Node or nil.
+        def end_date
+          @end_date ||= respond_to?(:constituencyGroupEndDate) ? DateTime.parse(constituencyGroupEndDate) : nil
+        end
+
+        # Alias constituencyGroupHasHouseSeat with fallback.
+        #
+        # @return [Array, Array] the house seats of the Grom::Node or an empty array.
+        def seats
+          respond_to?(:constituencyGroupHasHouseSeat) ? constituencyGroupHasHouseSeat : []
+        end
+
+        # Alias houseSeatHasSeatIncumbency with fallback.
+        #
+        # @return [Array, Array] the seat incumbencies of the Grom::Node or an empty array.
+        def seat_incumbencies
+          return @seat_incumbencies unless @seat_incumbencies.nil?
+
+          seat_incumbencies = []
+          seats.each do |seat|
+            seat_incumbencies << seat.seat_incumbencies
+          end
+
+          @seat_incumbencies = seat_incumbencies.flatten.uniq
+        end
+
+        # Alias incumbencyHasMember with fallback.
+        #
+        # @return [Array, Array] the members of the Grom::Node or an empty array.
+        def members
+          return @members unless @members.nil?
+
+          members = []
+          seat_incumbencies.each do |seat_incumbency|
+            members << seat_incumbency.member
+          end
+
+          @members = members.flatten.uniq
+        end
+
+        # Alias constituencyGroupHasConstituencyArea with fallback.
+        #
+        # @return [Grom::Node, nil] a Grom::Node with type http://id.ukpds.org/schema/ConstituencyArea or nil.
+        def area
+          respond_to?(:constituencyGroupHasConstituencyArea) ? constituencyGroupHasConstituencyArea.first : nil
+        end
+
+        # Alias incumbencyHasContactPoint with fallback.
+        #
+        # @return [Array, Array] the contact points of the Grom::Node or an empty array.
+        def contact_points
+          return @contact_points unless @contact_points.nil?
+
+          contact_points = []
+          seat_incumbencies.each do |seat_incumbency|
+            contact_points << seat_incumbency.contact_points
+          end
+
+          @contact_points = contact_points.flatten.uniq
+        end
+
+        # Checks if Grom::Node has an end date.
+        #
+        # @return [Boolean] a boolean depending on whether or not the Grom::Node has an end date.
+        def current?
+          has_end_date = respond_to?(:constituencyGroupEndDate)
+
+          !has_end_date
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,50 @@
+module Parliament
+  module Grom
+    module Decorator
+      # Decorator namespace for Grom::Node instances with type: http://id.ukpds.org/schema/ContactPoint
+      module ContactPoint
+        # Alias contactPointHasPostalAddress with fallback.
+        #
+        # @return [Array, Array] an array of the postal addresses for the Grom::Node or an empty array.
+        def postal_addresses
+          respond_to?(:contactPointHasPostalAddress) ? contactPointHasPostalAddress : []
+        end
+
+        # Alias email with fallback.
+        #
+        # @return [String, String] the email of the Grom::Node or an empty string.
+        def email
+          instance_variable_get('@email'.to_sym).nil? ? '' : instance_variable_get('@email'.to_sym)
+        end
+
+        # Alias phoneNumber with fallback.
+        #
+        # @return [String, String] the phone number of the Grom::Node or an empty string.
+        def phone_number
+          respond_to?(:phoneNumber) ? phoneNumber : ''
+        end
+
+        # Alias faxNumber with fallback.
+        #
+        # @return [String, String] the fax number of the Grom::Node or an empty string.
+        def fax_number
+          respond_to?(:faxNumber) ? faxNumber : ''
+        end
+
+        # Alias contactPointHasPerson with fallback.
+        #
+        # @return [Array, Array] the person connected to the Grom::Node or an empty array.
+        def person
+          respond_to?(:contactPointHasPerson) ? contactPointHasPerson : []
+        end
+
+        # Alias contactPointHasIncumbency with fallback.
+        #
+        # @return [Grom::Node, nil] the incumbency of the Grom::Node or nil.
+        def incumbency
+          respond_to?(:contactPointHasIncumbency) ? contactPointHasIncumbency.first : nil
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,15 @@
+module Parliament
+  module Grom
+    module Decorator
+      # Decorator namespace for Grom::Node instances with type: http://id.ukpds.org/schema/Gender
+      module Gender
+        # Alias genderName with fallback.
+        #
+        # @return [String, String] the gender name of the Grom::Node or an empty string.
+        def name
+          respond_to?(:genderName) ? genderName : ''
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,15 @@
+module Parliament
+  module Grom
+    module Decorator
+      # Decorator namespace for Grom::Node instances with type: http://id.ukpds.org/schema/GenderIdentity
+      module GenderIdentity
+        # Alias genderIdentityHasGender with fallback.
+        #
+        # @return [Grom::Node, nil] a Grom::Node with type http://id.ukpds.org/schema/Gender or nil.
+        def gender
+          respond_to?(:genderIdentityHasGender) ? genderIdentityHasGender.first : nil
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,43 @@
+module Parliament
+  module Grom
+    module Decorator
+      # Decorator namespace for Grom::Node instances with type: http://id.ukpds.org/schema/House
+      module House
+        # Alias houseName with fallback.
+        #
+        # @return [String, String] the name of the Grom::Node or an empty string.
+        def name
+          respond_to?(:houseName) ? houseName : ''
+        end
+
+        # Alias houseSeatHasSeatIncumbency with fallback.
+        #
+        # @return [Array, Array] the seat incumbencies of the Grom::Node or an empty array.
+        def seat_incumbencies
+          return @seat_incumbencies unless @seat_incumbencies.nil?
+
+          seat_incumbencies = []
+          seats.each do |seat|
+            seat_incumbencies << seat.seat_incumbencies
+          end
+
+          @seat_incumbencies = seat_incumbencies.flatten.uniq
+        end
+
+        # Alias houseHasHouseSeat with fallback.
+        #
+        # @return [Array, Array] the house seats of the Grom::Node or an empty array.
+        def seats
+          respond_to?(:houseHasHouseSeat) ? houseHasHouseSeat : []
+        end
+
+        # Alias houseHasHouseIncumbency with fallback.
+        #
+        # @return [Array, Array] the house incumbencies of the Grom::Node or an empty array.
+        def house_incumbencies
+          respond_to?(:houseHasHouseIncumbency) ? houseHasHouseIncumbency : []
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,50 @@
+module Parliament
+  module Grom
+    module Decorator
+      # Decorator namespace for Grom::Node instances with type: http://id.ukpds.org/schema/HouseIncumbency
+      module HouseIncumbency
+        # Alias incumbencyStartDate with fallback.
+        #
+        # @return [DateTime, nil] the start date of the Grom::Node or nil.
+        def start_date
+          @start_date ||= respond_to?(:incumbencyStartDate) ? DateTime.parse(incumbencyStartDate) : nil
+        end
+
+        # Alias incumbencyEndDate with fallback.
+        #
+        # @return [DateTime, nil] the end date of the Grom::Node or nil.
+        def end_date
+          @end_date ||= respond_to?(:incumbencyEndDate) ? DateTime.parse(incumbencyEndDate) : nil
+        end
+
+        # Checks if Grom::Node has an end date.
+        #
+        # @return [Boolean] a boolean depending on whether or not the Grom::Node has an end date.
+        def current?
+          end_date.nil?
+        end
+
+        # Alias houseIncumbencyHasHouse with fallback.
+        #
+        # @return [Grom::Node, nil] the house of the Grom::Node or nil.
+        def house
+          respond_to?(:houseIncumbencyHasHouse) ? houseIncumbencyHasHouse.first : nil
+        end
+
+        # Alias incumbencyHasMember with fallback.
+        #
+        # @return [Grom::Node, nil] the member connected to the Grom::Node or nil.
+        def member
+          respond_to?(:incumbencyHasMember) ? incumbencyHasMember.first : nil
+        end
+
+        # Alias incumbencyHasContactPoint with fallback.
+        #
+        # @return [Array, Array] the contact points of the Grom::Node or an empty array.
+        def contact_points
+          respond_to?(:incumbencyHasContactPoint) ? incumbencyHasContactPoint : []
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,29 @@
+module Parliament
+  module Grom
+    module Decorator
+      # Decorator namespace for Grom::Node instances with type: http://id.ukpds.org/schema/HouseSeat
+      module HouseSeat
+        # Alias houseSeatHasHouse with fallback.
+        #
+        # @return [Grom::Node, nil] the house of the Grom::Node or nil.
+        def house
+          respond_to?(:houseSeatHasHouse) ? houseSeatHasHouse.first : nil
+        end
+
+        # Alias houseSeatHasConstituencyGroup with fallback.
+        #
+        # @return [Grom::Node, nil] the constituency group of the Grom::Node or nil.
+        def constituency
+          respond_to?(:houseSeatHasConstituencyGroup) ? houseSeatHasConstituencyGroup.first : nil
+        end
+
+        # Alias houseSeatHasSeatIncumbency with fallback.
+        #
+        # @return [Array, Array] the seat incumbencies of the Grom::Node or an empty.
+        def seat_incumbencies
+          respond_to?(:houseSeatHasSeatIncumbency) ? houseSeatHasSeatIncumbency : []
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,57 @@
+module Parliament
+  module Grom
+    module Decorator
+      # Decorator namespace for Grom::Node instances with type: http://id.ukpds.org/schema/Incumbency
+      module Incumbency
+        # Alias incumbencyStartDate with fallback.
+        #
+        # @return [DateTime, nil] the start date of the Grom::Node or nil.
+        def start_date
+          @start_date ||= respond_to?(:incumbencyStartDate) ? DateTime.parse(incumbencyStartDate) : nil
+        end
+
+        # Alias incumbencyEndDate with fallback.
+        #
+        # @return [DateTime, nil] the end date of the Grom::Node or nil.
+        def end_date
+          @end_date ||= respond_to?(:incumbencyEndDate) ? DateTime.parse(incumbencyEndDate) : nil
+        end
+
+        # Checks if Grom::Node has an end date.
+        #
+        # @return [Boolean] a boolean depending on whether or not the Grom::Node has an end date.
+        def current?
+          end_date.nil?
+        end
+
+        # Alias incumbencyHasMember with fallback.
+        #
+        # @return [Grom::Node, nil] the member connected to the Grom::Node or nil.
+        def member
+          respond_to?(:incumbencyHasMember) ? incumbencyHasMember.first : nil
+        end
+
+        # Alias incumbencyHasContactPoint with fallback.
+        #
+        # @return [Array, Array] the contact points of the Grom::Node or an empty array.
+        def contact_points
+          respond_to?(:incumbencyHasContactPoint) ? incumbencyHasContactPoint : []
+        end
+
+        # Alias seatIncumbencyHasHouseSeat with fallback.
+        #
+        # @return [Grom::Node, nil] the seat of the Grom::Node or nil.
+        def seat
+          respond_to?(:seatIncumbencyHasHouseSeat) ? seatIncumbencyHasHouseSeat.first : nil
+        end
+
+        # Alias houseIncumbencyHasHouse with fallback.
+        #
+        # @return [Grom::Node, nil] the house of the Grom::Node or nil.
+        def house
+          respond_to?(:houseIncumbencyHasHouse) ? houseIncumbencyHasHouse.first : nil
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,29 @@
+module Parliament
+  module Grom
+    module Decorator
+      # Decorator namespace for Grom::Node instances with type: http://id.ukpds.org/schema/Party
+      module Party
+        # Alias partyName with fallback.
+        #
+        # @return [String, String] the party name of the Grom::Node or an empty string.
+        def name
+          respond_to?(:partyName) ? partyName : ''
+        end
+
+        # Alias partyHasPartyMembership with fallback.
+        #
+        # @return [Array, Array] the party memberships of the Grom::Node or an empty array.
+        def party_memberships
+          respond_to?(:partyHasPartyMembership) ? partyHasPartyMembership : []
+        end
+
+        # Alias count with fallback.
+        #
+        # @return [Integer, nil] the count of members of the Grom::Node or nil.
+        def member_count
+          respond_to?(:count) ? count.to_i : nil
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,36 @@
+module Parliament
+  module Grom
+    module Decorator
+      # Decorator namespace for Grom::Node instances with type: http://id.ukpds.org/schema/PartyMembership
+      module PartyMembership
+        # Alias partyMembershipHasParty with fallback.
+        #
+        # @return [Grom::Node, nil] the party of the Grom::Node or nil.
+        def party
+          respond_to?(:partyMembershipHasParty) ? partyMembershipHasParty.first : nil
+        end
+
+        # Alias partyMembershipStartDate with fallback.
+        #
+        # @return [DateTime, nil] the start date of the Grom::Node or nil.
+        def start_date
+          @start_date ||= respond_to?(:partyMembershipStartDate) ? DateTime.parse(partyMembershipStartDate) : nil
+        end
+
+        # Alias partyMembershipEndDate with fallback.
+        #
+        # @return [DateTime, nil] the end date of the Grom::Node or nil.
+        def end_date
+          @end_date ||= respond_to?(:partyMembershipEndDate) ? DateTime.parse(partyMembershipEndDate) : nil
+        end
+
+        # Checks if Grom::Node has an end date.
+        #
+        # @return [Boolean] a boolean depending on whether or not the Grom::Node has an end date.
+        def current?
+          end_date.nil?
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,190 @@
+module Parliament
+  module Grom
+    module Decorator
+      # Decorator namespace for Grom::Node instances with type: http://id.ukpds.org/schema/Person.
+      # rubocop:disable ModuleLength
+      module Person
+        # Alias personGivenName with fallback.
+        #
+        # @return [String, String] the given name of the Grom::Node or an empty string.
+        def given_name
+          respond_to?(:personGivenName) ? personGivenName : ''
+        end
+
+        # Alias personFamilyName with fallback.
+        #
+        # @return [String, String] the family name of the Grom::Node or an empty string.
+        def family_name
+          respond_to?(:personFamilyName) ? personFamilyName : ''
+        end
+
+        # Alias personOtherNames with fallback.
+        #
+        # @return [String, String] the other names of the Grom::Node or an empty string.
+        def other_name
+          respond_to?(:personOtherNames) ? personOtherNames : ''
+        end
+
+        # Alias personDateOfBirth with fallback.
+        #
+        # @return [DateTime, nil] the date of birth of the Grom::Node or nil.
+        def date_of_birth
+          @date_of_birth ||= respond_to?(:personDateOfBirth) ? DateTime.parse(personDateOfBirth) : nil
+        end
+
+        # Builds a full name using personGivenName and personFamilyName.
+        #
+        # @return [String, String] the full name of the Grom::Node or an empty string.
+        def full_name
+          return @full_name unless @full_name.nil?
+
+          full_name = []
+          full_name << personGivenName if respond_to?(:personGivenName)
+          full_name << personFamilyName if respond_to?(:personFamilyName)
+
+          @full_name = full_name.join(' ')
+        end
+
+        # Alias memberHasIncumbency with fallback.
+        #
+        # @return [Array, Array] all the incumbencies of the Grom::Node or an empty array.
+        def incumbencies
+          respond_to?(:memberHasIncumbency) ? memberHasIncumbency : []
+        end
+
+        # Alias memberHasIncumbency with fallback.
+        #
+        # @return [Array, Array] the seat incumbencies of the Grom::Node or an empty array.
+        def seat_incumbencies
+          @seat_incumbencies ||= incumbencies.select { |inc| inc.type == 'http://id.ukpds.org/schema/SeatIncumbency' }
+        end
+
+        # Alias memberHasIncumbency with fallback.
+        #
+        # @return [Array, Array] the house incumbencies of the Grom::Node or an empty array.
+        def house_incumbencies
+          @house_incumbencies ||= incumbencies.select { |inc| inc.type == 'http://id.ukpds.org/schema/HouseIncumbency' }
+        end
+
+        # Alias seatIncumbencyHasHouseSeat with fallback.
+        #
+        # @return [Array, Array] the seats of the Grom::Node or an empty array.
+        def seats
+          @seats ||= seat_incumbencies.map(&:seat).flatten.uniq.compact
+        end
+
+        # Alias houseSeatHasHouse with fallback.
+        #
+        # @return [Array, Array] the houses of the Grom::Node or an empty array.
+        def houses
+          @houses ||= [seats.map(&:house), house_incumbencies.map(&:house)].flatten.uniq.compact
+        end
+
+        # Alias houseSeatHasConstituencyGroup with fallback.
+        #
+        # @return [Array, Array] the constituencies of the Grom::Node or an empty array.
+        def constituencies
+          @constituencies ||= seats.map(&:constituency).flatten.uniq.compact
+        end
+
+        # Alias partyMemberHasPartyMembership with fallback.
+        #
+        # @return [Array, Array] the party memberships of the Grom::Node or an empty array.
+        def party_memberships
+          respond_to?(:partyMemberHasPartyMembership) ? partyMemberHasPartyMembership : []
+        end
+
+        # Alias partyMembershipHasParty with fallback.
+        #
+        # @return [Array, Array] the parties of the Grom::Node or an empty array.
+        def parties
+          @parties ||= party_memberships.map(&:party).flatten.uniq.compact
+        end
+
+        # Alias personHasContactPoint with fallback.
+        #
+        # @return [Array, Array] the contact points of the Grom::Node or an empty array.
+        def contact_points
+          respond_to?(:personHasContactPoint) ? personHasContactPoint : []
+        end
+
+        # Alias personHasGenderIdentity with fallback.
+        #
+        # @return [Array, Array] the gender identities of the Grom::Node or an empty array.
+        def gender_identities
+          respond_to?(:personHasGenderIdentity) ? personHasGenderIdentity : []
+        end
+
+        # Alias genderIdentityHasGender with fallback.
+        #
+        # @return [Array, Array] the gender of the Grom::Node or nil.
+        def gender
+          gender_identities.empty? ? nil : gender_identities.first.gender
+        end
+
+        # Checks the statuses of the Grom::Node.
+        #
+        # @return [Hash, Hash] the statuses of the Grom::Node or an empty hash.
+        def statuses
+          return @statuses unless @statuses.nil?
+
+          statuses = {}
+          statuses[:house_membership_status] = house_membership_status
+          statuses[:general_membership_status] = general_membership_status
+
+          @statuses = statuses
+        end
+
+        # Alias D79B0BAC513C4A9A87C9D5AFF1FC632F with fallback.
+        #
+        # @return [String, String] the full title of the Grom::Node or an empty string.
+        def full_title
+          respond_to?(:D79B0BAC513C4A9A87C9D5AFF1FC632F) ? self.D79B0BAC513C4A9A87C9D5AFF1FC632F : ''
+        end
+
+        # Alias F31CBD81AD8343898B49DC65743F0BDF with fallback.
+        #
+        # @return [String, String] the display name of the Grom::Node or the full name.
+        def display_name
+          respond_to?(:F31CBD81AD8343898B49DC65743F0BDF) ? self.F31CBD81AD8343898B49DC65743F0BDF : full_name
+        end
+
+        # Alias A5EE13ABE03C4D3A8F1A274F57097B6C with fallback.
+        #
+        # @return [String, String] the sort name of the Grom::Node or an empty string.
+        def sort_name
+          respond_to?(:A5EE13ABE03C4D3A8F1A274F57097B6C) ? self.A5EE13ABE03C4D3A8F1A274F57097B6C : ''
+        end
+
+        private
+
+        def house_membership_status
+          no_current_seat_incumbency = seat_incumbencies.select(&:current?).empty?
+          no_current_house_incumbency = house_incumbencies.select(&:current?).empty?
+          former_lord = (!house_incumbencies.empty? && no_current_house_incumbency)
+          former_mp = (!seat_incumbencies.empty? && no_current_seat_incumbency)
+
+          build_house_membership_status(no_current_seat_incumbency, no_current_house_incumbency, former_lord, former_mp)
+        end
+
+        # TODO: Convert hard-coded strings to language file values
+        def build_house_membership_status(no_current_seat_incumbency, no_current_house_incumbency, former_lord, former_mp)
+          statuses = []
+          statuses << 'Current MP' unless no_current_seat_incumbency
+          statuses << 'Member of the House of Lords' unless no_current_house_incumbency
+          statuses << 'Former Member of the House of Lords' if former_lord
+          statuses << 'Former MP' if former_mp
+
+          statuses
+        end
+
+        def general_membership_status
+          statuses = []
+          statuses << 'Current Member' unless incumbencies.select(&:current?).empty?
+          statuses << 'Former Member' if !incumbencies.empty? && incumbencies.select(&:current?).empty?
+          statuses
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,28 @@
+module Parliament
+  module Grom
+    module Decorator
+      # Decorator namespace for Grom::Node instances with type: http://id.ukpds.org/schema/PostalAddress
+      module PostalAddress
+        # Builds a full address using the lines of the address and the postcode.
+        #
+        # @return [String, String] the full address of the Grom::Node or an empty string.
+        def full_address
+          address_array.join(', ')
+        end
+
+        private
+
+        def address_array
+          address_array = []
+          (1..5).each do |i|
+            if respond_to?("addressLine#{i}".to_sym)
+              address_array << instance_variable_get("@addressLine#{i}".to_sym)
+            end
+          end
+          address_array << postCode if respond_to?(:postCode)
+          address_array
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,71 @@
+module Parliament
+  module Grom
+    module Decorator
+      # Decorator namespace for Grom::Node instances with type: http://id.ukpds.org/schema/SeatIncumbency
+      module SeatIncumbency
+        # Alias incumbencyStartDate with fallback.
+        #
+        # @return [DateTime, nil] the start date of the Grom::Node or nil.
+        def start_date
+          respond_to?(:incumbencyStartDate) ? DateTime.parse(incumbencyStartDate) : nil
+        end
+
+        # Alias incumbencyEndDate with fallback.
+        #
+        # @return [DateTime, nil] the end date of the Grom::Node or nil.
+        def end_date
+          respond_to?(:incumbencyEndDate) ? DateTime.parse(incumbencyEndDate) : nil
+        end
+
+        # Alias seatIncumbencyHasHouseSeat with fallback.
+        #
+        # @return [Grom::Node, nil] the seat of the Grom::Node or nil.
+        def seat
+          respond_to?(:seatIncumbencyHasHouseSeat) ? seatIncumbencyHasHouseSeat.first : nil
+        end
+
+        # Checks if Grom::Node has no end date.
+        #
+        # @return [Boolean] a boolean depending on whether or not the Grom::Node has an end date.
+        def current?
+          !former?
+        end
+
+        # Checks if Grom::Node has an end date.
+        #
+        # @return [Boolean] a boolean depending on whether or not the Grom::Node has an end date.
+        def former?
+          respond_to?(:incumbencyEndDate)
+        end
+
+        # Alias houseSeatHasHouse with fallback.
+        #
+        # @return [Grom::Node, nil] the house of the Grom::Node or nil.
+        def house
+          seat.nil? ? nil : seat.house
+        end
+
+        # Alias houseSeatHasConstituencyGroup with fallback.
+        #
+        # @return [Grom::Node, nil] the constituency of the Grom::Node or nil.
+        def constituency
+          seat.nil? ? nil : seat.constituency
+        end
+
+        # Alias incumbencyHasContactPoint with fallback.
+        #
+        # @return [Array, Array] the contact points of the Grom::Node or an empty array.
+        def contact_points
+          respond_to?(:incumbencyHasContactPoint) ? incumbencyHasContactPoint : []
+        end
+
+        # Alias incumbencyHasMember with fallback.
+        #
+        # @return [Grom::Node, nil] the member connected to the Grom::Node or nil.
+        def member
+          respond_to?(:incumbencyHasMember) ? incumbencyHasMember.first : nil
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,7 @@
+module Parliament
+  module Grom
+    module Decorator
+      VERSION = '0.0.1.pre'.freeze
+    end
+  end
+end

data/parliament-grom-decorators.gemspec

@@ -0,0 +1,31 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'parliament/grom/decorator/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'parliament-grom-decorators'
+  spec.version       = Parliament::Grom::Decorator::VERSION
+  spec.authors       = ['Rebecca Appleyard']
+  spec.email         = ['rklappleyard@gmail.com']
+
+  spec.summary       = %q{Parliamentary Grom decorator}
+  spec.description   = %q{Parliamentary Grom decorator}
+  spec.homepage      = 'http://github.com/ukparliament/parliament_grom_decorators'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.14'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'rubocop', '~> 0.47'
+  spec.add_development_dependency 'simplecov', '~> 0.12'
+  spec.add_development_dependency 'vcr', '~> 3.0'
+  spec.add_development_dependency 'webmock', '~> 2.3'
+  # spec.add_development_dependency 'parliament-ntriple'
+end

metadata

@@ -0,0 +1,170 @@
+--- !ruby/object:Gem::Specification
+name: parliament-grom-decorators
+version: !ruby/object:Gem::Version
+  version: 0.0.1.pre
+platform: ruby
+authors:
+- Rebecca Appleyard
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-04-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.47'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.47'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+description: Parliamentary Grom decorator
+email:
+- rklappleyard@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".hound.yml"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/parliament/grom/decorator.rb
+- lib/parliament/grom/decorator/constituency_area.rb
+- lib/parliament/grom/decorator/constituency_group.rb
+- lib/parliament/grom/decorator/contact_point.rb
+- lib/parliament/grom/decorator/gender.rb
+- lib/parliament/grom/decorator/gender_identity.rb
+- lib/parliament/grom/decorator/house.rb
+- lib/parliament/grom/decorator/house_incumbency.rb
+- lib/parliament/grom/decorator/house_seat.rb
+- lib/parliament/grom/decorator/incumbency.rb
+- lib/parliament/grom/decorator/party.rb
+- lib/parliament/grom/decorator/party_membership.rb
+- lib/parliament/grom/decorator/person.rb
+- lib/parliament/grom/decorator/postal_address.rb
+- lib/parliament/grom/decorator/seat_incumbency.rb
+- lib/parliament/grom/decorator/version.rb
+- parliament-grom-decorators.gemspec
+homepage: http://github.com/ukparliament/parliament_grom_decorators
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.6
+signing_key: 
+specification_version: 4
+summary: Parliamentary Grom decorator
+test_files: []