hydra-pcdm 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9c4ca4330987a12626e2dd8a45e54d08e83b8c07
+  data.tar.gz: 99e3953956fe7a5a45b6c14bbee233d14e32eb2a
+SHA512:
+  metadata.gz: 5a0af66d3e277f5d2f05dbb2e96043742f1faeec169641cf64058c3a89dc7762bfd93ca7ed48055c621fa0cc3a463b8492d5dc3d0351a996e248a138c081ae66
+  data.tar.gz: 43f4e5f13d121da66b59c54a496b538d2cd8bbb74b4be5fa8bfb60944f793d485313e2aa1d0aec23e5bceb6dbd0a6f4ae09f7eaaff141f355ff913ff650d31bc

data/.coveralls.yml

@@ -0,0 +1 @@
+service_name: travis-ci

data/.gitignore

@@ -0,0 +1,26 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+.idea
+.ruby-gemset
+.ruby-version
+jetty

data/.travis.yml

@@ -0,0 +1,14 @@
+language: ruby
+cache: bundler
+sudo: false
+bundler_args: --without debug
+env:
+  global:
+    - NOKOGIRI_USE_SYSTEM_LIBRARIES=true
+rvm:
+  - 2.1
+  - 2.2
+  - jruby-head
+matrix:
+  allow_failures:
+      - rvm: jruby-head

data/CONTRIBUTING.md

@@ -0,0 +1,115 @@
+# How to Contribute
+
+We want your help to make Project Hydra great.
+There are a few guidelines that we need contributors to follow so that we can have a chance of keeping on top of things.
+
+## Hydra Project Intellectual Property Licensing and Ownership
+
+All code contributors must have an Individual Contributor License Agreement (iCLA) on file with the Hydra Project Steering Group.
+If the contributor works for an institution, the institution must have a Corporate Contributor License Agreement (cCLA) on file.
+
+https://wiki.duraspace.org/display/hydra/Hydra+Project+Intellectual+Property+Licensing+and+Ownership
+
+You should also add yourself to the `CONTRIBUTORS.md` file in the root of the project.
+
+## Contribution Tasks
+
+* Reporting Issues
+* Making Changes
+* Submitting Changes
+* Merging Changes
+
+### Reporting Issues
+
+* Make sure you have a [GitHub account](https://github.com/signup/free)
+* Submit a [Github issue](./issues) by:
+  * Clearly describing the issue
+    * Provide a descriptive summary
+    * Explain the expected behavior
+    * Explain the actual behavior
+    * Provide steps to reproduce the actual behavior
+
+### Making Changes
+
+* Fork the repository on GitHub
+* Create a topic branch from where you want to base your work.
+  * This is usually the master branch.
+  * To quickly create a topic branch based on master; `git branch fix/master/my_contribution master`
+  * Then checkout the new branch with `git checkout fix/master/my_contribution`.
+  * Please avoid working directly on the `master` branch.
+  * You may find the [hub suite of commands](https://github.com/defunkt/hub) helpful
+* Make commits of logical units.
+  * Your commit should include a high level description of your work in HISTORY.textile 
+* Check for unnecessary whitespace with `git diff --check` before committing.
+* Make sure your commit messages are [well formed](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html).
+* If you created an issue, you can close it by including "Closes #issue" in your commit message. See [Github's blog post for more details](https://github.com/blog/1386-closing-issues-via-commit-messages)
+
+```
+    Present tense short summary (50 characters or less)
+
+    More detailed description, if necessary. It should be wrapped to 72
+    characters. Try to be as descriptive as you can, even if you think that
+    the commit content is obvious, it may not be obvious to others. You
+    should add such description also if it's already present in bug tracker,
+    it should not be necessary to visit a webpage to check the history.
+
+    Include Closes #<issue-number> when relavent.
+
+    Description can have multiple paragraphs and you can use code examples
+    inside, just indent it with 4 spaces:
+
+        class PostsController
+          def index
+            respond_with Post.limit(10)
+          end
+        end
+
+    You can also add bullet points:
+
+    - you can use dashes or asterisks
+
+    - also, try to indent next line of a point for readability, if it's too
+      long to fit in 72 characters
+```
+
+* Make sure you have added the necessary tests for your changes.
+* Run _all_ the tests to assure nothing else was accidentally broken.
+* When you are ready to submit a pull request
+
+### Submitting Changes
+
+* Read the article ["Using Pull Requests"](https://help.github.com/articles/using-pull-requests) on GitHub.
+* Make sure your branch is up to date with its parent branch (i.e. master)
+  * `git checkout master`
+  * `git pull --rebase`
+  * `git checkout <your-branch>`
+  * `git rebase master`
+  * It is likely a good idea to run your tests again.
+* If you've made more than one commit take a moment to consider whether squashing commits together would help improve their logical grouping.
+  * [Detailed Walkthrough of One Pull Request per Commit](http://ndlib.github.io/practices/one-commit-per-pull-request/)
+  * `git rebase --interactive HEAD~<number-of-commits>` ([See Github help](https://help.github.com/articles/interactive-rebase))
+  * To determine the number of commits on your branch: `git log master..<your-branch> --oneline | wc -l`
+  * Squashing your branch's changes into one commit is "good form" and helps the person merging your request to see everything that is going on.
+* Push your changes to a topic branch in your fork of the repository.
+* Submit a pull request from your fork to the project.
+
+### Merging Changes
+
+* It is considered "poor from" to merge your own request.
+* Please take the time to review the changes and get a sense of what is being changed. Things to consider:
+  * Does the commit message explain what is going on?
+  * Does the code changes have tests? _Not all changes need new tests, some changes are refactorings_
+  * Does the commit contain more than it should? Are two separate concerns being addressed in one commit?
+  * Did the Travis tests complete successfully?
+* If you are uncertain, bring other contributors into the conversation by creating a comment that includes their @username.
+* If you like the pull request, but want others to chime in, create a +1 comment and tag a user.
+
+## New Developers
+A great way to get new developers involved and to learn the process is to have them go through the Hierarchy of Promises and create a pull request to improve it.
+
+# Additional Resources
+
+* [General GitHub documentation](http://help.github.com/)
+* [GitHub pull request documentation](http://help.github.com/send-pull-requests/)
+* [Pro Git](http://git-scm.com/book) is both a free and excellent book about Git.
+* [A Git Config for Contributing](http://ndlib.github.io/practices/my-typical-per-project-git-config/)

data/Gemfile

@@ -0,0 +1,13 @@
+source 'https://rubygems.org'
+
+gem 'activefedora-aggregation', github: 'projecthydra-labs/activefedora-aggregation'
+gem 'active-fedora', github: 'projecthydra/active_fedora'
+
+
+unless ENV['CI']
+  gem 'pry'
+  gem 'pry-byebug'
+end
+
+# Specify your gem's dependencies in hydra-pcdm.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,12 @@
+##########################################################################
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.

data/README.md

@@ -0,0 +1,87 @@
+# Hydra::PCDM
+[![Build Status](https://travis-ci.org/projecthydra-labs/hydra-pcdm.svg?branch=master)](https://travis-ci.org/projecthydra-labs/hydra-pcdm)
+[![Coverage Status](https://coveralls.io/repos/projecthydra-labs/hydra-pcdm/badge.svg?branch=master)](https://coveralls.io/r/projecthydra-labs/hydra-pcdm?branch=master)
+
+Hydra implementation of Portland Common Data Models (PCDM)
+
+## Installation
+
+Add these lines to your application's Gemfile:
+
+```ruby
+  gem 'active-fedora', github: 'projecthydra/active_fedora' # hydra-pcdm requires an unreleased version of ActiveFedora
+  gem 'hydra-pcdm', github: 'projecthydra-labs/hydra-pcdm'
+```
+
+Substitute another branch name for 'master' to test out a branch under development.    
+<!-- Temporarily comment out until gem is published.
+    gem 'hydra-pcdm' 
+-->
+
+And then execute:
+```
+    $ bundle
+```
+<!-- Temporarily comment out until gem is published.
+Or install it yourself as:
+
+    $ gem install hydra-pcdm
+-->
+
+## Access Controls
+We are using [Web ACL](http://www.w3.org/wiki/WebAccessControl) as implemented by [hydra-access](https://github.com/projecthydra/hydra-head/tree/master/hydra-access-controls) controls
+
+## PCDM Model
+
+Reference:  [Portland Common Data Model](https://wiki.duraspace.org/x/9IoOB)
+
+
+### Model Definition
+
+![PCDM Model Definition](https://wiki.duraspace.org/download/attachments/68061940/coll-object-file.png?version=1&modificationDate=1425932362178&api=v2)
+
+
+### Example
+
+To test the model and provide clarity we have included a sample mode that exercises the interfaces provided by the gem.
+The sample model may change over time to reflect the state of the gam and what it supports.  
+
+![Sandwich Objet Model](https://docs.google.com/drawings/d/1wI4H3AH9pdIPllKIMO356c1cFHUN57azDlgIqMVODSw/pub?w=1369&h=727)
+
+## Usage
+
+Hydra-pcdm provides three classes:
+```
+Hydra::PCDM::Object
+Hydra::PCDM::Collection
+Hydra::PCDM::File
+```
+
+A `Hydra::PCDM::File` is a NonRDFSource &emdash; a bitstream.  You can use this to store content. A PCDM::File is contained by a PCDM::Object. A `File` has some attached technical metadata, but no descriptive metadata.  A `Hydra::PCDM::Object` contains files and other objects and may have descriptive metadata.  A `Hydra::PCDM::Collection` can contain other `Collection`s or `Object`s but not `File`s.  A `Collection` also may have descriptive metadata.
+
+Typically usage involves extending the behavior provided by this gem. In your application you can write something like this:
+
+```ruby
+
+class Book < ActiveFedora::Base
+  include Hydra::PCDM::ObjectBehavior
+end
+
+class Collection < ActiveFedora::Base
+  include Hydra::PCDM::CollectionBehavior
+end
+
+c1 = Collection.create
+b1 = Book.create
+
+c1.members = [b1]
+# c1.members << b1 # This should work in the future
+c1.save
+
+f1 = b1.files.build
+f1.content = "The quick brown fox jumped over the lazy dog."
+b1.save
+```
+
+## How to contribute
+If you'd like to contribute to this effort, please check out the [Contributing Guide](CONTRIBUTING.md)

data/Rakefile

@@ -0,0 +1,20 @@
+require 'bundler/gem_tasks'
+require 'jettywrapper'
+require 'rspec/core'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+Jettywrapper.hydra_jetty_version = "master"
+
+desc 'Spin up hydra-jetty and run specs'
+task ci: ['jetty:clean'] do
+  puts 'running continuous integration'
+  jetty_params = Jettywrapper.load_config
+  jetty_params[:startup_wait]= 90
+  error = Jettywrapper.wrap(jetty_params) do
+    Rake::Task['spec'].invoke
+  end
+  raise "test failures: #{error}" if error
+end
+
+task default: :ci

data/config/jetty.yml

@@ -0,0 +1,6 @@
+default:
+  startup_wait: 90
+  jetty_port: 8983
+  java_opts:
+    - "-Xmx256m" 
+    - "-XX:MaxPermSize=128m"

data/hydra-pcdm.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'hydra/pcdm/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "hydra-pcdm"
+  spec.version       = Hydra::PCDM::VERSION
+  spec.authors       = ["E. Lynette Rayle"]
+  spec.email         = ["elr37@cornell.edu"]
+  spec.summary       = %q{Portland Common Data Model (PCDM)}
+  spec.description   = %q{Portland Common Data Model (PCDM)}
+  spec.homepage      = "https://github.com/projecthydra-labs/hydra-pcdm"
+  spec.license       = "APACHE2"
+  spec.required_ruby_version     = '>= 1.9.3'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency 'activefedora-aggregation', '~> 0.2.0'
+
+  spec.add_development_dependency 'bundler', '~> 1.6'
+  spec.add_development_dependency 'jettywrapper', '>= 2.0.0'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'coveralls'
+  spec.add_development_dependency 'rspec'
+
+end

data/lib/hydra/pcdm/collection_indexer.rb

@@ -0,0 +1,12 @@
+module Hydra::PCDM
+  class CollectionIndexer < ObjectIndexer
+
+    def generate_solr_document
+      super.tap do |solr_doc|
+        solr_doc["members_ssim"]        = object.member_ids
+        solr_doc["child_collections_ssim"] = object.child_collections.map { |o| o.id }
+      end
+    end
+
+  end
+end

data/lib/hydra/pcdm/models/collection.rb

@@ -0,0 +1,6 @@
+module Hydra::PCDM
+  class Collection < ActiveFedora::Base
+    include Hydra::PCDM::CollectionBehavior
+  end
+end
+

data/lib/hydra/pcdm/models/concerns/collection_behavior.rb

@@ -0,0 +1,79 @@
+require 'active_fedora/aggregation'
+
+module Hydra::PCDM
+  module CollectionBehavior
+    extend ActiveSupport::Concern
+
+    included do
+      type RDFVocabularies::PCDMTerms.Collection
+
+      aggregates :members, predicate: RDFVocabularies::PCDMTerms.hasMember,
+        class_name: "ActiveFedora::Base"
+
+      indirectly_contains :related_objects, has_member_relation: RDF::Vocab::ORE.aggregates,
+        inserted_content_relation: RDF::Vocab::ORE.proxyFor, class_name: "ActiveFedora::Base",
+        through: 'ActiveFedora::Aggregation::Proxy', foreign_key: :target
+    end
+
+    module ClassMethods
+      def indexer
+        Hydra::PCDM::CollectionIndexer
+      end
+    end
+
+    # behavior:
+    #   1) Hydra::PCDM::Collection can aggregate (pcdm:hasMember)  Hydra::PCDM::Collection (no infinite loop, e.g., A -> B -> C -> A)
+    #   2) Hydra::PCDM::Collection can aggregate (pcdm:hasMember)  Hydra::PCDM::Object
+    #   3) Hydra::PCDM::Collection can aggregate (ore:aggregates) Hydra::PCDM::Object  (Object related to the Collection)
+
+    #   4) Hydra::PCDM::Collection can NOT aggregate non-PCDM object
+    #   5) Hydra::PCDM::Collection can NOT contain (pcdm:hasFile)  Hydra::PCDM::File
+
+    #   6) Hydra::PCDM::Collection can have descriptive metadata
+    #   7) Hydra::PCDM::Collection can have access metadata
+
+    def child_collections= collections
+      raise ArgumentError, "each collection must be a pcdm collection" unless collections.all? { |c| Hydra::PCDM.collection? c }
+      raise ArgumentError, "a collection can't be an ancestor of itself" if collection_ancestor?(collections)
+      self.members = objects + collections
+    end
+
+    def child_collections
+      members.to_a.select { |m| Hydra::PCDM.collection? m }
+    end
+
+    def objects= objects
+      raise ArgumentError, "each object must be a pcdm object" unless objects.all? { |o| Hydra::PCDM.object? o }
+      self.members = child_collections + objects
+    end
+
+    def objects
+      members.to_a.select { |m| Hydra::PCDM.object? m }
+    end
+
+    def collection_ancestor? collections
+      collections.each do |check|
+        return true if check.id == self.id
+        return true if ancestor?(check)
+      end
+      false
+    end
+
+    def ancestor? collection
+      return true if collection.id == self.id
+      return false if collection.child_collections.empty?
+      current_collections = collection.child_collections
+      next_batch = []
+      while !current_collections.empty? do
+        current_collections.each do |c|
+          return true if c.id == self.id
+          next_batch += c.child_collections
+        end
+        current_collections = next_batch
+      end
+      false
+    end
+
+  end
+end
+

data/lib/hydra/pcdm/models/concerns/object_behavior.rb

@@ -0,0 +1,104 @@
+require 'active_fedora/aggregation'
+
+module Hydra::PCDM
+
+  # behavior:
+  #   1) Hydra::PCDM::Object can aggregate (pcdm:hasMember) Hydra::PCDM::Object
+  #   2) Hydra::PCDM::Object can aggregate (ore:aggregates) Hydra::PCDM::Object  (Object related to the Object)
+  #   3) Hydra::PCDM::Object can contain (pcdm:hasFile) Hydra::PCDM::File
+  #   4) Hydra::PCDM::Object can contain (pcdm:hasRelatedFile) Hydra::PCDM::File
+  #   5) Hydra::PCDM::Object can NOT aggregate Hydra::PCDM::Collection
+  #   6) Hydra::PCDM::Object can NOT aggregate non-PCDM object
+  #   7) Hydra::PCDM::Object can have descriptive metadata
+  #   8) Hydra::PCDM::Object can have access metadata
+  module ObjectBehavior
+    extend ActiveSupport::Concern
+
+    included do
+      type RDFVocabularies::PCDMTerms.Object
+
+      aggregates :members, predicate: RDFVocabularies::PCDMTerms.hasMember,
+        class_name: "ActiveFedora::Base"
+
+      indirectly_contains :related_objects, has_member_relation: RDF::Vocab::ORE.aggregates,
+        inserted_content_relation: RDF::Vocab::ORE.proxyFor, class_name: "ActiveFedora::Base",
+        through: 'ActiveFedora::Aggregation::Proxy', foreign_key: :target
+
+      directly_contains :files, has_member_relation: RDFVocabularies::PCDMTerms.hasFile,
+        class_name: "Hydra::PCDM::File"
+
+    end
+
+    module ClassMethods
+      def indexer
+        Hydra::PCDM::ObjectIndexer
+      end
+    end
+
+    def objects= objects
+      raise ArgumentError, "each object must be a pcdm object" unless objects.all? { |o| Hydra::PCDM.object? o }
+      raise ArgumentError, "an object can't be an ancestor of itself" if object_ancestor?(objects)
+      self.members = objects
+    end
+
+    def objects
+      members.to_a.select { |m| Hydra::PCDM.object? m }
+    end
+
+    def object_ancestor? objects
+      objects.each do |check|
+        return true if check.id == self.id
+        return true if ancestor?(check)
+      end
+      false
+    end
+
+    def ancestor? object
+      return true if object.id == self.id
+      return false if object.objects.empty?
+      current_objects = object.objects
+      next_batch = []
+      while !current_objects.empty? do
+        current_objects.each do |c|
+          return true if c.id == self.id
+          next_batch += c.objects
+        end
+        current_objects = next_batch
+      end
+      false
+    end
+
+    def contains= files
+      # check that file is an instance of Hydra::PCDM::File
+      raise ArgumentError, "each file must be a pcdm file" unless
+          files.all? { |f| Hydra::PCDM.file? f }
+      super(files)
+    end
+
+    # Returns directly contained files that have the requested RDF Type
+    # @param [RDF::URI] uri for the desired Type
+    # @example
+    #   filter_files_by_type(::RDF::URI("http://pcdm.org/ExtractedText"))
+    def filter_files_by_type uri
+      self.files.reject do |file|
+        file.metadata_node.query(predicate: RDF.type, object: uri).map(&:object).empty?
+      end
+    end
+
+    # Finds or Initializes directly contained file with the requested RDF Type
+    # @param [RDF::URI] uri for the desired Type
+    # @example
+    #   file_of_type(::RDF::URI("http://pcdm.org/ExtractedText"))
+    def file_of_type uri
+      matching_files =  filter_files_by_type(uri)
+      if  matching_files.empty?
+        file = self.files.build
+        Hydra::PCDM::AddTypeToFile.call(file, uri)
+      else
+        return matching_files.first
+      end
+    end
+
+  end
+end
+

data/lib/hydra/pcdm/models/file.rb

@@ -0,0 +1,20 @@
+module Hydra::PCDM
+  class File < ActiveFedora::File
+    include ActiveFedora::WithMetadata
+
+    metadata do
+      configure type: RDFVocabularies::PCDMTerms.File
+      property :label, predicate: ::RDF::RDFS.label
+
+      property :file_name, predicate: EBUCoreVocabularies::EBUCoreTerms.filename 
+      property :file_size, predicate: EBUCoreVocabularies::EBUCoreTerms.fileSize 
+      property :date_created, predicate: EBUCoreVocabularies::EBUCoreTerms.dateCreated
+      property :has_mime_type, predicate: EBUCoreVocabularies::EBUCoreTerms.hasMimeType
+      property :date_modified, predicate: EBUCoreVocabularies::EBUCoreTerms.dateModified
+      property :byte_order, predicate: SweetjplVocabularies::SweetjplTerms.byteOrder
+
+      # This is a server-managed predicate which means Fedora does not let us change it.
+      property :file_hash, predicate: RDF::Vocab::PREMIS.hasMessageDigest
+    end
+  end
+end

data/lib/hydra/pcdm/models/object.rb

@@ -0,0 +1,6 @@
+module Hydra::PCDM
+  class Object < ActiveFedora::Base
+    include Hydra::PCDM::ObjectBehavior
+  end
+end
+

data/lib/hydra/pcdm/object_indexer.rb

@@ -0,0 +1,10 @@
+module Hydra::PCDM
+  class ObjectIndexer < ActiveFedora::IndexingService
+    def generate_solr_document
+      super.tap do |solr_doc|
+        solr_doc["objects_ssim"]     = object.objects.map { |o| o.id }
+      end
+    end
+
+  end
+end

data/lib/hydra/pcdm/services/collection/add_collection.rb

@@ -0,0 +1,20 @@
+module Hydra::PCDM
+  class AddCollectionToCollection
+
+    ##
+    # Add a collection to a collection.
+    #
+    # @param [Hydra::PCDM::Collection] :parent_collection to which to add collection
+    # @param [Hydra::PCDM::Collection] :child_collection being added
+    #
+    # @return [Hydra::PCDM::Collection] the updated pcdm collection
+
+    def self.call( parent_collection, child_collection )
+      raise ArgumentError, "parent_collection must be a pcdm collection" unless Hydra::PCDM.collection? parent_collection
+      raise ArgumentError, "child_collection must be a pcdm collection" unless Hydra::PCDM.collection? child_collection
+      raise ArgumentError, "a collection can't be an ancestor of itself" if parent_collection.ancestor? child_collection
+      parent_collection.members << child_collection
+    end
+
+  end
+end

data/lib/hydra/pcdm/services/collection/add_object.rb

@@ -0,0 +1,19 @@
+module Hydra::PCDM
+  class AddObjectToCollection
+
+    ##
+    # Add an object to a collection.
+    #
+    # @param [Hydra::PCDM::Collection] :parent_collection to which to add object
+    # @param [Hydra::PCDM::Object] :child_object being added
+    #
+    # @return [Hydra::PCDM::Collection] the updated pcdm collection
+
+    def self.call( parent_collection, child_object )
+      raise ArgumentError, "parent_collection must be a pcdm collection" unless Hydra::PCDM.collection? parent_collection
+      raise ArgumentError, "child_object must be a pcdm object" unless Hydra::PCDM.object? child_object
+      parent_collection.members << child_object
+    end
+
+  end
+end

data/lib/hydra/pcdm/services/collection/add_related_object.rb

@@ -0,0 +1,21 @@
+module Hydra::PCDM
+  class AddRelatedObjectToCollection
+
+    ##
+    # Add a related object to a collection.
+    #
+    # @param [Hydra::PCDM::Collection] :parent_collection to which to add the related object
+    # @param [Hydra::PCDM::Object] :child_related_object being added
+    #
+    # @return [Hydra::PCDM::Collection] the updated pcdm collection
+
+    def self.call( parent_collection, child_related_object )
+      raise ArgumentError, 'parent_collection must be a pcdm object' unless Hydra::PCDM.collection? parent_collection
+      raise ArgumentError, 'child_related_object must be a pcdm object' unless Hydra::PCDM.object? child_related_object
+
+      # parent_collection.related_objects = parent_collection.related_objects.to_a + child_related_object
+      parent_collection.related_objects << child_related_object
+    end
+
+  end
+end

data/lib/hydra/pcdm/services/collection/get_collections.rb

@@ -0,0 +1,18 @@
+module Hydra::PCDM
+  class GetCollectionsFromCollection
+
+    ##
+    # Get member collections from a collection in order.
+    #
+    # @param [Hydra::PCDM::Collection] :parent_collection in which the child collections are members
+    #
+    # @return [Array<Hydra::PCDM::Collection>] all member collections
+
+    def self.call( parent_collection )
+      raise ArgumentError, "parent_collection must be a pcdm collection" unless Hydra::PCDM.collection? parent_collection
+
+      parent_collection.child_collections
+    end
+
+  end
+end