dmao_api 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8e7257d738325683b5729c978624513908db362c
-  data.tar.gz: ddf6f8f8e95bb525f749ab6000659560079673a3
+  metadata.gz: bb6855ebeb3df109d747a4e5153c91735df68bdd
+  data.tar.gz: 873620f2bd988a331dc6d6a8da2013ce4b77ce80
 SHA512:
-  metadata.gz: 8c5765835fb5a8f277ccc48bd093878b82d5a6b477cd77e5a4a8ec0219cfbb3aca471fde00d29dfdde3bacfa74b2faaf1f44d52534b9b6e3beea81612efbc8e8
-  data.tar.gz: 19656c8cbdb4ccf1f731b8d3ff22688d273cf62d0f4083fb3f0dac935ae572e1ab18f015b64af20d9533329ac5c37d83b0572005b3b86f515a41f2034b428b52
+  metadata.gz: 1102a0b85199d723e567c34caefb160f20fc8769552580b67fa56c8f306059e02fc3dfd2d276de4fbdcafbbe64d9c43225ae249181fa8c46c03830cb0635c799
+  data.tar.gz: e5939a3a23114804ee4b1d3c87939a3047f8c33da6999dbf188ffb2a0a58056d27387e65671b0fc27ffceacd0cfd0dd2955d45e63f854eb8bf875865441dfc10

data/lib/dmao/api/dataset.rb

@@ -0,0 +1,92 @@
+require 'dmao/api/entity'
+require 'dmao/api/errors/invalid_dataset'
+require 'dmao/api/errors/invalid_dataset_id'
+require 'dmao/api/errors/invalid_project_id'
+require 'dmao/api/errors/invalid_organisation_unit_id'
+require 'dmao/api/errors/dataset_not_found'
+
+module DMAO
+  module API
+
+    class Dataset < Entity
+
+      ENDPOINT = 'datasets'
+      NOT_FOUND_ERROR = DMAO::API::Errors::DatasetNotFound
+      INVALID_ID_ERROR = DMAO::API::Errors::InvalidDatasetID
+      INVALID_ENTITY_CLASS = DMAO::API::Errors::InvalidDataset
+      INVALID_ENTITY_ERROR_MESSAGE = "Invalid dataset details, please see errors."
+
+      VALID_ATTRIBUTES = [
+          :id,
+          :institution_id,
+          :permanent_id,
+          :title,
+          :description,
+          :publisher,
+          :access,
+          :notes,
+          :creation_date,
+          :system_uuid,
+          :system_modified_at,
+          :project_id,
+          :owning_unit_id
+      ]
+
+      attr_reader(*VALID_ATTRIBUTES)
+
+      def initialize(attributes)
+
+        @id = attributes[:id]
+        @institution_id = attributes[:institution_id]
+        @permanent_id = attributes[:permanent_id]
+        @title = attributes[:title]
+        @description = attributes[:description]
+        @publisher = attributes[:publisher]
+        @access = attributes[:access]
+        @notes = attributes[:notes]
+        @creation_date = attributes[:creation_date]
+        @system_uuid = attributes[:system_uuid]
+        @system_modified_at = attributes[:system_modified_at]
+        @project_id = attributes[:project_id]
+        @owning_unit_id = attributes[:owning_unit_id]
+
+      end
+
+      def self.instance_from_api_data data
+
+        attributes = {
+            id: data["id"],
+            institution_id: data["relationships"]["institution"]["data"]["id"],
+            permanent_id: data["attributes"]["permanent-id"],
+            title: data["attributes"]["title"],
+            description: data["attributes"]["description"],
+            publisher: data["attributes"]["publisher"],
+            access: data["attributes"]["access"],
+            notes: data["attributes"]["notes"],
+            creation_date: data["attributes"]["creation-date"],
+            system_uuid: data["attributes"]["system-uuid"],
+            system_modified_at: data["attributes"]["system-modified-at"],
+            project_id: data["relationships"]["project"]["data"]["id"],
+            owning_unit_id: data["relationships"]["owning-unit"]["data"]["id"]
+        }
+
+        new(attributes)
+
+      end
+
+      def self.handle_unprocessable_entity error_response
+
+        errors = parse_error_response error_response
+
+        raise_error_if_key DMAO::API::Errors::InvalidProjectID, errors, "project"
+        raise_error_if_key DMAO::API::Errors::InvalidOrganisationUnitID, errors, "owning_unit"
+
+        raise DMAO::API::Errors::InvalidDataset.new("Invalid dataset details, please see errors.", errors)
+
+
+      end
+
+    end
+
+  end
+end

data/lib/dmao/api/dataset_file.rb

@@ -0,0 +1,65 @@
+require 'dmao/api/entity'
+require 'dmao/api/errors/invalid_dataset_file'
+require 'dmao/api/errors/invalid_dataset_file_id'
+require 'dmao/api/errors/dataset_file_not_found'
+require 'dmao/api/errors/invalid_dataset_id'
+
+module DMAO
+  module API
+
+    class DatasetFile < Entity
+
+      ENDPOINT = 'dataset_files'
+      NOT_FOUND_ERROR = DMAO::API::Errors::DatasetFileNotFound
+      INVALID_ID_ERROR = DMAO::API::Errors::InvalidDatasetFileID
+      INVALID_ENTITY_CLASS = DMAO::API::Errors::InvalidDatasetFile
+      INVALID_ENTITY_ERROR_MESSAGE = "Invalid dataset file details, please see errors."
+
+      VALID_ATTRIBUTES = [:id, :institution_id, :name, :size, :url, :system_uuid, :system_modified_at, :dataset_id]
+
+      attr_reader(*VALID_ATTRIBUTES)
+
+      def initialize(attributes)
+
+        @id = attributes[:id]
+        @institution_id = attributes[:institution_id]
+        @name = attributes[:name]
+        @size = attributes[:size]
+        @url = attributes[:url]
+        @system_uuid = attributes[:system_uuid]
+        @system_modified_at = attributes[:system_modified_at]
+        @dataset_id= attributes[:dataset_id]
+
+      end
+
+      def self.instance_from_api_data data
+
+        attributes = {
+            id: data["id"],
+            institution_id: data["relationships"]["institution"]["data"]["id"],
+            name: data["attributes"]["name"],
+            size: data["attributes"]["size"],
+            url: data["attributes"]["url"],
+            system_uuid: data["attributes"]["system-uuid"],
+            system_modified_at: data["attributes"]["system-modified-at"],
+            dataset_id: data["relationships"]["dataset"]["data"]["id"]
+        }
+
+        new(attributes)
+
+      end
+
+      def self.handle_unprocessable_entity error_response
+
+        errors = parse_error_response error_response
+
+        raise_error_if_key DMAO::API::Errors::InvalidDatasetID, errors, "dataset"
+
+        raise DMAO::API::Errors::InvalidDatasetFile.new("Invalid dataset file details, please see errors.", errors)
+
+      end
+
+    end
+
+  end
+end

data/lib/dmao/api/dmp.rb

@@ -0,0 +1,62 @@
+require 'dmao/api/entity'
+require 'dmao/api/errors/invalid_dmp'
+require 'dmao/api/errors/invalid_dmp_id'
+require 'dmao/api/errors/dmp_not_found'
+
+module DMAO
+  module API
+
+    class DMP < Entity
+
+      ENDPOINT = 'dmps'
+      NOT_FOUND_ERROR = DMAO::API::Errors::DMPNotFound
+      INVALID_ID_ERROR = DMAO::API::Errors::InvalidDMPID
+      INVALID_ENTITY_CLASS = DMAO::API::Errors::InvalidDMP
+      INVALID_ENTITY_ERROR_MESSAGE = "Invalid DMP details, please see errors."
+
+      VALID_ATTRIBUTES = [:id, :institution_id, :project_id, :reviewed, :url, :system_uuid, :system_modified_at]
+
+      attr_reader(*VALID_ATTRIBUTES)
+
+      def initialize(attributes)
+
+        @id = attributes[:id]
+        @institution_id = attributes[:institution_id]
+        @reviewed = attributes[:reviewed]
+        @url = attributes[:url]
+        @system_uuid = attributes[:system_uuid]
+        @system_modified_at = attributes[:system_modified_at]
+        @project_id = attributes[:project_id]
+
+      end
+
+      def self.instance_from_api_data data
+
+        attributes = {
+            id: data["id"],
+            institution_id: data["relationships"]["institution"]["data"]["id"],
+            reviewed: data["attributes"]["reviewed"],
+            url: data["attributes"]["url"],system_uuid: data["attributes"]["system-uuid"],
+            system_modified_at: data["attributes"]["system-modified-at"],
+            project_id: data["relationships"]["project"]["data"]["id"]
+        }
+
+        new(attributes)
+
+      end
+
+      def self.handle_unprocessable_entity error_response
+
+        errors = parse_error_response error_response
+
+        raise_error_if_key DMAO::API::Errors::InvalidProjectID, errors, "project"
+        
+        raise DMAO::API::Errors::InvalidDMP.new("Invalid DMP details, please see errors.", errors)
+
+
+      end
+
+    end
+
+  end
+end

data/lib/dmao/api/entity.rb

@@ -157,6 +157,18 @@ module DMAO
         raise "Should be overridden in extending class"
       end
 
+      def self.set_id_attribute_if_not_nil attribute_value
+      attribute_value.nil? ? nil : attribute_value["id"]
+      end
+
+      def self.parse_error_response error_response
+        JSON.parse(error_response.response.body)["errors"]
+      end
+
+      def self.raise_error_if_key error_class, errors, key
+        raise error_class.new if errors.keys.include? key
+      end
+
     end
 
   end

data/lib/dmao/api/errors/action_unsupported.rb

@@ -0,0 +1,17 @@
+module DMAO
+  module API
+    module Errors
+
+      class ActionUnsupported < StandardError
+
+        def initialize(msg="Action is not supported by entity.")
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/dataset_file_not_found.rb

@@ -0,0 +1,17 @@
+module DMAO
+  module API
+    module Errors
+
+      class DatasetFileNotFound < StandardError
+
+        def initialize(msg="Invalid dataset file id specified, id does not exist for requesting institution.")
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/dataset_not_found.rb

@@ -0,0 +1,17 @@
+module DMAO
+  module API
+    module Errors
+
+      class DatasetNotFound < StandardError
+
+        def initialize(msg="Invalid dataset id specified, id does not exist for requesting institution.")
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/dmp_not_found.rb

@@ -0,0 +1,17 @@
+module DMAO
+  module API
+    module Errors
+
+      class DMPNotFound < StandardError
+
+        def initialize(msg="Invalid DMP id specified, id does not exist for requesting institution.")
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/funder_not_found.rb

@@ -0,0 +1,17 @@
+module DMAO
+  module API
+    module Errors
+
+      class FunderNotFound < StandardError
+
+        def initialize(msg="Invalid funder id specified, id does not exist for requesting institution.")
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/invalid_dataset.rb

@@ -0,0 +1,21 @@
+module DMAO
+  module API
+    module Errors
+
+      class InvalidDataset < StandardError
+
+        attr_reader :errors
+
+        def initialize(msg="Invalid dataset details passed in, please see errors.", errors=nil)
+
+          @errors = errors
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/invalid_dataset_file.rb

@@ -0,0 +1,21 @@
+module DMAO
+  module API
+    module Errors
+
+      class InvalidDatasetFile < StandardError
+
+        attr_reader :errors
+
+        def initialize(msg="Invalid dataset file details passed in, please see errors.", errors=nil)
+
+          @errors = errors
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/invalid_dataset_file_id.rb

@@ -0,0 +1,19 @@
+module DMAO
+  module API
+    module Errors
+
+      class InvalidDatasetFileID < StandardError
+
+        attr_reader :errors
+
+        def initialize(msg="Invalid dataset file ID specified")
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/invalid_dataset_id.rb

@@ -0,0 +1,19 @@
+module DMAO
+  module API
+    module Errors
+
+      class InvalidDatasetID < StandardError
+
+        attr_reader :errors
+
+        def initialize(msg="Invalid dataset ID specified")
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/invalid_dmp.rb

@@ -0,0 +1,21 @@
+module DMAO
+  module API
+    module Errors
+
+      class InvalidDMP < StandardError
+
+        attr_reader :errors
+
+        def initialize(msg="Invalid DMP details passed in, please see errors.", errors=nil)
+
+          @errors = errors
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/invalid_dmp_id.rb

@@ -0,0 +1,17 @@
+module DMAO
+  module API
+    module Errors
+
+      class InvalidDMPID < StandardError
+
+        def initialize(msg="Invalid DMP ID specified")
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/invalid_funder.rb

@@ -0,0 +1,21 @@
+module DMAO
+  module API
+    module Errors
+
+      class InvalidFunder < StandardError
+
+        attr_reader :errors
+
+        def initialize(msg="Invalid funder details passed in, please see errors.", errors=nil)
+
+          @errors = errors
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/invalid_funder_id.rb

@@ -0,0 +1,17 @@
+module DMAO
+  module API
+    module Errors
+
+      class InvalidFunderID < StandardError
+
+        def initialize(msg="Invalid funder ID specified")
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/invalid_project.rb

@@ -0,0 +1,21 @@
+module DMAO
+  module API
+    module Errors
+
+      class InvalidProject < StandardError
+
+        attr_reader :errors
+
+        def initialize(msg="Invalid project details passed in, please see errors.", errors=nil)
+
+          @errors = errors
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/invalid_project_id.rb

@@ -0,0 +1,19 @@
+module DMAO
+  module API
+    module Errors
+
+      class InvalidProjectID < StandardError
+
+        attr_reader :errors
+
+        def initialize(msg="Invalid project ID specified")
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/invalid_project_participant.rb

@@ -0,0 +1,21 @@
+module DMAO
+  module API
+    module Errors
+
+      class InvalidProjectParticipant < StandardError
+
+        attr_reader :errors
+
+        def initialize(msg="Invalid project participant details passed in, please see errors.", errors=nil)
+
+          @errors = errors
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/invalid_project_participant_id.rb

@@ -0,0 +1,19 @@
+module DMAO
+  module API
+    module Errors
+
+      class InvalidProjectParticipantID < StandardError
+
+        attr_reader :errors
+
+        def initialize(msg="Invalid project participant ID specified")
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/invalid_publication.rb

@@ -0,0 +1,21 @@
+module DMAO
+  module API
+    module Errors
+
+      class InvalidPublication < StandardError
+
+        attr_reader :errors
+
+        def initialize(msg="Invalid project details passed in, please see errors.", errors=nil)
+
+          @errors = errors
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/invalid_publication_dataset.rb

@@ -0,0 +1,21 @@
+module DMAO
+  module API
+    module Errors
+
+      class InvalidPublicationDataset < StandardError
+
+        attr_reader :errors
+
+        def initialize(msg="Invalid publication dataset details passed in, please see errors.", errors=nil)
+
+          @errors = errors
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/invalid_publication_dataset_id.rb

@@ -0,0 +1,17 @@
+module DMAO
+  module API
+    module Errors
+
+      class InvalidPublicationDatasetID < StandardError
+
+        def initialize(msg="Invalid publication dataset ID specified")
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/invalid_publication_id.rb

@@ -0,0 +1,17 @@
+module DMAO
+  module API
+    module Errors
+
+      class InvalidPublicationID < StandardError
+
+        def initialize(msg="Invalid publication ID specified")
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/project_not_found.rb

@@ -0,0 +1,17 @@
+module DMAO
+  module API
+    module Errors
+
+      class ProjectNotFound < StandardError
+
+        def initialize(msg="Invalid project id specified, id does not exist for requesting institution.")
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/project_participant_not_found.rb

@@ -0,0 +1,17 @@
+module DMAO
+  module API
+    module Errors
+
+      class ProjectParticipantNotFound < StandardError
+
+        def initialize(msg="Invalid project participant id specified, id does not exist for requesting institution.")
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/publication_dataset_not_found.rb

@@ -0,0 +1,17 @@
+module DMAO
+  module API
+    module Errors
+
+      class PublicationDatasetNotFound < StandardError
+
+        def initialize(msg="Invalid publication dataset id specified, id does not exist for requesting institution.")
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/publication_not_found.rb

@@ -0,0 +1,17 @@
+module DMAO
+  module API
+    module Errors
+
+      class PublicationNotFound < StandardError
+
+        def initialize(msg="Invalid publication id specified, id does not exist for requesting institution.")
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/errors/unsupported_query_by_system_uuid.rb

@@ -0,0 +1,17 @@
+module DMAO
+  module API
+    module Errors
+
+      class UnsupportedQueryBySystemUUID < StandardError
+
+        def initialize(msg="Querying by system uuid is not supported.")
+
+          super(msg)
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/dmao/api/funder.rb

@@ -0,0 +1,50 @@
+require 'dmao/api/entity'
+require 'dmao/api/errors/invalid_funder'
+require 'dmao/api/errors/invalid_funder_id'
+require 'dmao/api/errors/funder_not_found'
+
+module DMAO
+  module API
+
+    class Funder < Entity
+
+      ENDPOINT = 'funders'
+      NOT_FOUND_ERROR = DMAO::API::Errors::FunderNotFound
+      INVALID_ID_ERROR = DMAO::API::Errors::InvalidFunderID
+      INVALID_ENTITY_CLASS = DMAO::API::Errors::InvalidFunder
+      INVALID_ENTITY_ERROR_MESSAGE = "Invalid funder details, please see errors."
+
+      VALID_ATTRIBUTES = [:id, :institution_id, :name, :parent_group, :system_uuid, :system_modified_at]
+
+      attr_reader(*VALID_ATTRIBUTES)
+
+      def initialize(attributes)
+
+        @id = attributes[:id]
+        @institution_id = attributes[:institution_id]
+        @name = attributes[:name]
+        @parent_group = attributes[:parent_group]
+        @system_uuid = attributes[:system_uuid]
+        @system_modified_at = attributes[:system_modified_at]
+
+      end
+
+      def self.instance_from_api_data data
+
+        attributes = {
+            id: data["id"],
+            institution_id: data["relationships"]["institution"]["data"]["id"],
+            name: data["attributes"]["name"],
+            parent_group: data["attributes"]["parent-group"],
+            system_uuid: data["attributes"]["system-uuid"],
+            system_modified_at: data["attributes"]["system-modified-at"]
+        }
+
+        new(attributes)
+
+      end
+
+    end
+
+  end
+end

data/lib/dmao/api/organisation_unit.rb

@@ -39,7 +39,7 @@ module DMAO
 
       def self.instance_from_api_data data
 
-        parent_id = data["relationships"]["parent"]["data"].nil? ? nil : data["relationships"]["parent"]["data"]["id"]
+        parent_id = set_id_attribute_if_not_nil data["relationships"]["parent"]["data"]
 
         attributes = {
             id: data["id"],
@@ -60,9 +60,10 @@ module DMAO
 
       def self.handle_unprocessable_entity error_response
 
-        errors = JSON.parse(error_response.response.body)["errors"]
+        errors = parse_error_response error_response
+
+        raise_error_if_key DMAO::API::Errors::InvalidParentId, errors, "parent"
 
-        raise DMAO::API::Errors::InvalidParentId.new if errors.keys.include? "parent"
         raise DMAO::API::Errors::InvalidOrganisationUnit.new("Invalid organisation unit details, please see errors.", errors)
 
       end

data/lib/dmao/api/project.rb

@@ -0,0 +1,101 @@
+require 'dmao/api/entity'
+require 'dmao/api/errors/invalid_project'
+require 'dmao/api/errors/invalid_project_id'
+require 'dmao/api/errors/invalid_organisation_unit_id'
+require 'dmao/api/errors/project_not_found'
+
+module DMAO
+  module API
+
+    class Project < Entity
+
+      ENDPOINT = 'projects'
+      NOT_FOUND_ERROR = DMAO::API::Errors::ProjectNotFound
+      INVALID_ID_ERROR = DMAO::API::Errors::InvalidProjectID
+      INVALID_ENTITY_CLASS = DMAO::API::Errors::InvalidProject
+      INVALID_ENTITY_ERROR_MESSAGE = "Invalid project details, please see errors."
+
+      VALID_ATTRIBUTES = [
+          :id,
+          :institution_id,
+          :title,
+          :acronym,
+          :description,
+          :status,
+          :project_type,
+          :classification,
+          :internal_project_code,
+          :url,
+          :start_date,
+          :end_date,
+          :system_uuid,
+          :system_modified_at,
+          :owning_unit_id,
+          :funder_id
+      ]
+
+      attr_reader(*VALID_ATTRIBUTES)
+
+      def initialize(attributes)
+
+        @id = attributes[:id]
+        @institution_id = attributes[:institution_id]
+        @title = attributes[:title]
+        @acronym = attributes[:acronym]
+        @description = attributes[:description]
+        @status = attributes[:status]
+        @project_type = attributes[:project_type]
+        @classification = attributes[:classification]
+        @internal_project_code = attributes[:internal_project_code]
+        @url = attributes[:url]
+        @start_date = attributes[:start_date]
+        @end_date = attributes[:end_date]
+        @system_uuid = attributes[:system_uuid]
+        @system_modified_at = attributes[:system_modified_at]
+        @owning_unit_id = attributes[:owning_unit_id]
+        @funder_id = attributes[:funder_id]
+
+      end
+
+      def self.instance_from_api_data data
+
+        funder_id = set_id_attribute_if_not_nil data["relationships"]["funder"]["data"]
+
+        attributes = {
+            id: data["id"],
+            institution_id: data["relationships"]["institution"]["data"]["id"],
+            title: data["attributes"]["title"],
+            acronym: data["attributes"]["acronym"],
+            description: data["attributes"]["description"],
+            status: data["attributes"]["status"],
+            project_type: data["attributes"]["project-type"],
+            classification: data["attributes"]["classification"],
+            internal_project_code: data["attributes"]["internal-project-code"],
+            url: data["attributes"]["url"],
+            start_date: data["attributes"]["start-date"],
+            end_date: data["attributes"]["end-date"],
+            system_uuid: data["attributes"]["system-uuid"],
+            system_modified_at: data["attributes"]["system-modified-at"],
+            owning_unit_id: data["relationships"]["owning-unit"]["data"]["id"],
+            funder_id: funder_id
+        }
+
+        new(attributes)
+
+      end
+
+      def self.handle_unprocessable_entity error_response
+
+        errors = parse_error_response error_response
+
+        raise_error_if_key DMAO::API::Errors::InvalidOrganisationUnitID, errors, "owning_unit"
+
+        raise DMAO::API::Errors::InvalidProject.new("Invalid project details, please see errors.", errors)
+
+
+      end
+
+    end
+
+  end
+end

data/lib/dmao/api/project_participant.rb

@@ -0,0 +1,69 @@
+require 'dmao/api/entity'
+require 'dmao/api/errors/invalid_project_participant'
+require 'dmao/api/errors/invalid_project_participant_id'
+require 'dmao/api/errors/project_participant_not_found'
+require 'dmao/api/errors/invalid_project_id'
+require 'dmao/api/errors/invalid_person_id'
+require 'dmao/api/errors/unsupported_query_by_system_uuid'
+
+module DMAO
+  module API
+
+    class ProjectParticipant < Entity
+
+      ENDPOINT = 'project_participants'
+      NOT_FOUND_ERROR = DMAO::API::Errors::ProjectParticipantNotFound
+      INVALID_ID_ERROR = DMAO::API::Errors::InvalidProjectParticipantID
+      INVALID_ENTITY_CLASS = DMAO::API::Errors::InvalidProjectParticipant
+      INVALID_ENTITY_ERROR_MESSAGE = "Invalid project participant details, please see errors."
+
+      VALID_ATTRIBUTES = [:id, :institution_id, :role, :project_id, :participant_id, :person_id]
+
+      attr_reader(*VALID_ATTRIBUTES)
+
+      def initialize(attributes)
+
+        @id = attributes[:id]
+        @institution_id = attributes[:institution_id]
+        @role = attributes[:role]
+        @project_id = attributes[:project_id]
+        @participant_id = @person_id = attributes[:participant_id]
+
+      end
+
+      def self.instance_from_api_data data
+
+        attributes = {
+            id: data["id"],
+            institution_id: data["relationships"]["institution"]["data"]["id"],
+            role: data["attributes"]["role"],
+            project_id: data["relationships"]["project"]["data"]["id"],
+            participant_id: data["relationships"]["person"]["data"]["id"]
+        }
+
+        new(attributes)
+
+      end
+
+      def self.handle_unprocessable_entity error_response
+
+        errors = parse_error_response error_response
+
+        raise DMAO::API::Errors::InvalidProjectParticipant.new("Invalid project participant details, please see errors.", errors) if (errors.keys.include?("project") && errors.keys.include?("person"))
+
+        raise_error_if_key DMAO::API::Errors::InvalidProjectID, errors, "project"
+        raise_error_if_key DMAO::API::Errors::InvalidPersonID, errors, "person"
+
+        raise DMAO::API::Errors::InvalidProjectParticipant.new("Invalid project participant details, please see errors.", errors)
+
+
+      end
+
+      def self.find_by_system_uuid _system_uuid
+        raise DMAO::API::Errors::UnsupportedQueryBySystemUUID.new
+      end
+
+    end
+
+  end
+end

data/lib/dmao/api/publication.rb

@@ -0,0 +1,95 @@
+require 'dmao/api/entity'
+require 'dmao/api/errors/invalid_publication'
+require 'dmao/api/errors/invalid_publication_id'
+require 'dmao/api/errors/invalid_project_id'
+require 'dmao/api/errors/invalid_organisation_unit_id'
+require 'dmao/api/errors/publication_not_found'
+
+module DMAO
+  module API
+
+    class Publication < Entity
+
+      ENDPOINT = 'publications'
+      NOT_FOUND_ERROR = DMAO::API::Errors::PublicationNotFound
+      INVALID_ID_ERROR = DMAO::API::Errors::InvalidPublicationID
+      INVALID_ENTITY_CLASS = DMAO::API::Errors::InvalidPublication
+      INVALID_ENTITY_ERROR_MESSAGE = "Invalid publication details, please see errors."
+
+      VALID_ATTRIBUTES = [
+          :id,
+          :institution_id,
+          :permanent_id,
+          :title,
+          :abstract,
+          :category,
+          :publication_type,
+          :status,
+          :url,
+          :publication_date,
+          :system_uuid,
+          :system_modified_at,
+          :project_id,
+          :owning_unit_id
+      ]
+
+      attr_reader(*VALID_ATTRIBUTES)
+
+      def initialize(attributes)
+
+        @id = attributes[:id]
+        @institution_id = attributes[:institution_id]
+        @permanent_id = attributes[:permanent_id]
+        @title = attributes[:title]
+        @abstract = attributes[:abstract]
+        @category = attributes[:category]
+        @publication_type = attributes[:publication_type]
+        @status = attributes[:status]
+        @url = attributes[:url]
+        @publication_date = attributes[:publication_date]
+        @system_uuid = attributes[:system_uuid]
+        @system_modified_at = attributes[:system_modified_at]
+        @project_id = attributes[:project_id]
+        @owning_unit_id = attributes[:owning_unit_id]
+
+      end
+
+      def self.instance_from_api_data data
+
+        attributes = {
+            id: data["id"],
+            institution_id: data["relationships"]["institution"]["data"]["id"],
+            permanent_id: data["attributes"]["permanent-id"],
+            title: data["attributes"]["title"],
+            abstract: data["attributes"]["abstract"],
+            category: data["attributes"]["category"],
+            publication_type: data["attributes"]["publication-type"],
+            status: data["attributes"]["status"],
+            url: data["attributes"]["url"],
+            publication_date: data["attributes"]["publication-date"],
+            system_uuid: data["attributes"]["system-uuid"],
+            system_modified_at: data["attributes"]["system-modified-at"],
+            project_id: data["relationships"]["project"]["data"]["id"],
+            owning_unit_id: data["relationships"]["owning-unit"]["data"]["id"]
+        }
+
+        new(attributes)
+
+      end
+
+      def self.handle_unprocessable_entity error_response
+
+        errors = parse_error_response error_response
+
+        raise_error_if_key DMAO::API::Errors::InvalidProjectID, errors, "project"
+        raise_error_if_key DMAO::API::Errors::InvalidOrganisationUnitID, errors, "owning_unit"
+
+        raise DMAO::API::Errors::InvalidPublication.new("Invalid Publication details, please see errors.", errors)
+
+
+      end
+
+    end
+
+  end
+end

data/lib/dmao/api/publication_dataset.rb

@@ -0,0 +1,71 @@
+require 'dmao/api/entity'
+require 'dmao/api/errors/invalid_publication_dataset'
+require 'dmao/api/errors/invalid_publication_dataset_id'
+require 'dmao/api/errors/publication_dataset_not_found'
+require 'dmao/api/errors/invalid_publication_id'
+require 'dmao/api/errors/invalid_dataset_id'
+require 'dmao/api/errors/unsupported_query_by_system_uuid'
+require 'dmao/api/errors/action_unsupported'
+
+module DMAO
+  module API
+
+    class PublicationDataset < Entity
+
+      ENDPOINT = 'publication_datasets'
+      NOT_FOUND_ERROR = DMAO::API::Errors::PublicationDatasetNotFound
+      INVALID_ID_ERROR = DMAO::API::Errors::InvalidPublicationDatasetID
+      INVALID_ENTITY_CLASS = DMAO::API::Errors::InvalidPublicationDataset
+      INVALID_ENTITY_ERROR_MESSAGE = "Invalid publication dataset details, please see errors."
+
+      VALID_ATTRIBUTES = [:id, :institution_id, :publication_id, :dataset_id]
+
+      attr_reader(*VALID_ATTRIBUTES)
+
+      def initialize(attributes)
+
+        @id = attributes[:id]
+        @institution_id = attributes[:institution_id]
+        @publication_id = attributes[:publication_id]
+        @dataset_id= attributes[:dataset_id]
+
+      end
+
+      def self.instance_from_api_data data
+
+        attributes = {
+            id: data["id"],
+            institution_id: data["relationships"]["institution"]["data"]["id"],
+            publication_id: data["relationships"]["publication"]["data"]["id"],
+            dataset_id: data["relationships"]["dataset"]["data"]["id"]
+        }
+
+        new(attributes)
+
+      end
+
+      def self.handle_unprocessable_entity error_response
+
+        errors = parse_error_response error_response
+
+        raise DMAO::API::Errors::InvalidPublicationDataset.new("Invalid publication dataset details, please see errors.", errors) if (errors.keys.include?("publication") && errors.keys.include?("dataset"))
+
+        raise_error_if_key DMAO::API::Errors::InvalidPublicationID, errors, "publication"
+        raise_error_if_key DMAO::API::Errors::InvalidDatasetID, errors, "dataset"
+        
+        raise DMAO::API::Errors::InvalidPublicationDataset.new("Invalid publication dataset details, please see errors.", errors)
+        
+      end
+
+      def self.find_by_system_uuid _system_uuid
+        raise DMAO::API::Errors::UnsupportedQueryBySystemUUID.new
+      end
+
+      def self.update _id, _attributes
+        raise DMAO::API::Errors::ActionUnsupported.new("Updating publication dataset is not supported.")
+      end
+
+    end
+
+  end
+end

data/lib/dmao/api/version.rb

@@ -1,5 +1,5 @@
 module DMAO
   module API
-    VERSION = "0.3.0"
+    VERSION = "0.4.0"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dmao_api
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Stephen Robinson
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-04-12 00:00:00.000000000 Z
+date: 2017-04-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -153,21 +153,55 @@ files:
 - dmao_api.gemspec
 - lib/dmao/api/base.rb
 - lib/dmao/api/configuration.rb
+- lib/dmao/api/dataset.rb
+- lib/dmao/api/dataset_file.rb
+- lib/dmao/api/dmp.rb
 - lib/dmao/api/entity.rb
+- lib/dmao/api/errors/action_unsupported.rb
+- lib/dmao/api/errors/dataset_file_not_found.rb
+- lib/dmao/api/errors/dataset_not_found.rb
+- lib/dmao/api/errors/dmp_not_found.rb
+- lib/dmao/api/errors/funder_not_found.rb
 - lib/dmao/api/errors/institution_not_found.rb
 - lib/dmao/api/errors/invalid_api_base_url.rb
 - lib/dmao/api/errors/invalid_api_token.rb
+- lib/dmao/api/errors/invalid_dataset.rb
+- lib/dmao/api/errors/invalid_dataset_file.rb
+- lib/dmao/api/errors/invalid_dataset_file_id.rb
+- lib/dmao/api/errors/invalid_dataset_id.rb
+- lib/dmao/api/errors/invalid_dmp.rb
+- lib/dmao/api/errors/invalid_dmp_id.rb
+- lib/dmao/api/errors/invalid_funder.rb
+- lib/dmao/api/errors/invalid_funder_id.rb
 - lib/dmao/api/errors/invalid_organisation_unit.rb
 - lib/dmao/api/errors/invalid_organisation_unit_id.rb
 - lib/dmao/api/errors/invalid_parent_id.rb
 - lib/dmao/api/errors/invalid_person.rb
 - lib/dmao/api/errors/invalid_person_id.rb
+- lib/dmao/api/errors/invalid_project.rb
+- lib/dmao/api/errors/invalid_project_id.rb
+- lib/dmao/api/errors/invalid_project_participant.rb
+- lib/dmao/api/errors/invalid_project_participant_id.rb
+- lib/dmao/api/errors/invalid_publication.rb
+- lib/dmao/api/errors/invalid_publication_dataset.rb
+- lib/dmao/api/errors/invalid_publication_dataset_id.rb
+- lib/dmao/api/errors/invalid_publication_id.rb
 - lib/dmao/api/errors/invalid_response_length.rb
 - lib/dmao/api/errors/invalid_system_uuid.rb
 - lib/dmao/api/errors/organisation_unit_not_found.rb
 - lib/dmao/api/errors/person_not_found.rb
+- lib/dmao/api/errors/project_not_found.rb
+- lib/dmao/api/errors/project_participant_not_found.rb
+- lib/dmao/api/errors/publication_dataset_not_found.rb
+- lib/dmao/api/errors/publication_not_found.rb
+- lib/dmao/api/errors/unsupported_query_by_system_uuid.rb
+- lib/dmao/api/funder.rb
 - lib/dmao/api/organisation_unit.rb
 - lib/dmao/api/person.rb
+- lib/dmao/api/project.rb
+- lib/dmao/api/project_participant.rb
+- lib/dmao/api/publication.rb
+- lib/dmao/api/publication_dataset.rb
 - lib/dmao/api/version.rb
 - lib/dmao_api.rb
 homepage: https://github.com/lulibrary/DMAO-API-rb