fcrepo_admin 0.1.0

data/config/routes.rb

@@ -0,0 +1,14 @@
+FcrepoAdmin::Engine.routes.draw do
+
+  scope :module => "fcrepo_admin" do
+    resources :objects, :only => :show do
+      resources :datastreams, :only => [:index, :show] do
+        member do
+          get 'download'
+        end
+      end
+      resources :audit_trail, :only => :index
+    end
+  end
+    
+end

data/doc/README_FOR_APP

@@ -0,0 +1,2 @@
+Use this README file to introduce your application and point to useful places in the API for learning more.
+Run "rake doc:app" to generate API documentation for your models, controllers, helpers, and libraries.

data/fcrepo_admin.gemspec

@@ -0,0 +1,42 @@
+$:.push File.expand_path("../lib", __FILE__)
+
+# Maintain your gem's version:
+require "fcrepo_admin/version"
+
+# Describe your gem and declare its dependencies:
+Gem::Specification.new do |s|
+  s.name        = "fcrepo_admin"
+  s.version     = FcrepoAdmin::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["David Chandek-Stark", "Jim Coble", "Chris Beer", "Justin Coyne"]
+  s.email       = ["hydra-tech@googlegroups.com"]
+  s.homepage    = "http://projecthydra.org"
+  s.summary     = "Hydra-based Fedora Commons repository admin tool."
+  s.description = "A Rails engine for administrative access to a Fedora Commons repository based on the Hydra Project repository application framework."
+  s.license     = "BSD Simplified"
+
+  s.required_ruby_version = '>= 1.9.3'
+
+  s.files      = `git ls-files`.split("\n")
+  s.test_files = `git ls-files -- spec/*`.split("\n")
+
+  s.extra_rdoc_files = ["LICENSE", "README.rdoc"]
+
+  s.require_paths = ["lib"]
+
+  s.add_dependency "hydra-head", "6.0.0"
+  s.add_dependency "blacklight"
+  s.add_dependency "rails", "~> 3.2"
+  s.add_dependency "mime-types", '~> 1.19'
+
+  s.add_development_dependency "devise"
+  s.add_development_dependency "rspec"
+  s.add_development_dependency "rspec-rails"
+  s.add_development_dependency "capybara"
+  s.add_development_dependency "sqlite3"
+  s.add_development_dependency "factory_girl_rails"
+  s.add_development_dependency "jettywrapper"
+  s.add_development_dependency "jquery-rails"
+  s.add_development_dependency "sass-rails"
+  s.add_development_dependency "bootstrap-sass"
+end

data/lib/assets/stylesheets/fcrepo_admin/fcrepo_admin.css

@@ -0,0 +1,4 @@
+#fcrepo-admin-dsprofile { 
+	/* datastream profile table */
+	width: 40em;
+}

data/lib/fcrepo_admin.rb

@@ -0,0 +1,8 @@
+require 'fcrepo_admin/engine'
+require 'blacklight'
+require 'hydra/head'
+
+module FcrepoAdmin
+  autoload :SolrDocumentExtension, 'fcrepo_admin/solr_document_extension'
+  autoload :ControllerBehavior, 'fcrepo_admin/controller_behavior'
+end

data/lib/fcrepo_admin/controller_behavior.rb

@@ -0,0 +1,10 @@
+module FcrepoAdmin
+  module ControllerBehavior
+
+    def load_and_authz_object
+      @object = ActiveFedora::Base.find(params[:object_id], :cast => true)
+      authorize! :read, @object
+    end    
+
+  end
+end

data/lib/fcrepo_admin/engine.rb

@@ -0,0 +1,12 @@
+module FcrepoAdmin
+  class Engine < ::Rails::Engine
+
+    config.generators do |g|
+      g.test_framework      :rspec,        :fixture => false
+      g.fixture_replacement :factory_girl, :dir => 'spec/factories'
+      g.assets false
+      g.helper false
+    end
+
+  end
+end

data/lib/fcrepo_admin/solr_document_extension.rb

@@ -0,0 +1,49 @@
+require 'json'
+
+module FcrepoAdmin
+  module SolrDocumentExtension
+
+    def object_profile
+      @object_profile ||= JSON.parse(self[ActiveFedora::Base.profile_solr_name].first)
+    end
+
+    def datastreams
+      object_profile["datastreams"]
+    end
+    
+    def has_datastream?(dsID)
+      !datastreams[dsID].blank?
+    end
+
+    def has_admin_policy?
+      !admin_policy_uri.blank?
+    end
+
+    def admin_policy_uri
+      get ActiveFedora::SolrService.solr_name('is_governed_by', :symbol)
+    end
+
+    def admin_policy_pid
+      uri = admin_policy_uri
+      uri &&= ActiveFedora::Base.pids_from_uris(uri)
+    end
+
+    def has_parent?
+      !parent_uri
+    end
+
+    def parent_uri
+      get(ActiveFedora::SolrService.solr_name('is_part_of', :symbol)) || get(ActiveFedora::SolrService.solr_name('is_member_of', :symbol)) || get(ActiveFedora::SolrService.solr_name('is_member_of_collection', :symbol))
+    end
+
+    def parent_pid
+      uri = parent_uri
+      uri &&= ActiveFedora::Base.pids_from_uris(uri)
+    end
+
+    def active_fedora_model
+      get(ActiveFedora::SolrService.solr_name('active_fedora_model', :symbol))
+    end
+    
+  end
+end

data/lib/fcrepo_admin/version.rb

@@ -0,0 +1,3 @@
+module FcrepoAdmin
+  VERSION = "0.1.0"
+end

data/lib/tasks/fcrepo_admin.rake

@@ -0,0 +1,24 @@
+namespace :fcrepo_admin do
+    namespace :solr do
+        desc "Deletes everything from the Solr index"
+        task :clean => :environment do
+          Blacklight.solr.delete_by_query("*:*")
+          Blacklight.solr.commit
+        end
+        desc "Index a single object in solr specified by PID="
+        task :index => :environment do
+          raise "Must specify a pid. Ex: PID=changeme:12" unless ENV['PID']
+          ActiveFedora::Base.connection_for_pid('foo:1') # Loads Rubydora connection with fake object
+          ActiveFedora::Base.find(ENV['PID'], cast: true).update_index
+        end
+        desc 'Index all objects in the repository (except fedora-system: objects).'
+        task :index_all => :environment do
+          ActiveFedora::Base.connection_for_pid('foo:1') # Loads Rubydora connection with fake object
+          ActiveFedora::Base.fedora_connection[0].connection.search(nil) do |object|
+            if !object.pid.starts_with?('fedora-system:')
+                ActiveFedora::Base.find(object.pid, cast: true).update_index
+            end
+          end
+        end        
+    end
+end

data/script/rails

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# This command will automatically be run when you run "rails" with Rails 3 gems installed from the root of your application.
+
+APP_PATH = File.expand_path('../../config/application',  __FILE__)
+require File.expand_path('../../config/boot',  __FILE__)
+require 'rails/commands'

data/spec/controllers/audit_trail_controller_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+describe FcrepoAdmin::AuditTrailController do
+  context "#index" do
+    let(:object) { FactoryGirl.create(:content_model) }
+    after { object.delete }
+    it "should render the index template" do
+      get :index, :object_id => object, :use_route => 'fcrepo_admin'
+      response.should render_template(:index)
+    end
+  end
+  context "#index?download=true" do
+    context "object does not respond to audit_trail" do
+      subject { get :index, :object_id => object, :download => 'true', :use_route => 'fcrepo_admin' }
+      let(:object) { FactoryGirl.create(:content_model) }
+      after { object.delete }
+      its(:response_code) { should eq(200) }
+    end
+  end
+end

data/spec/controllers/datastreams_controller_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+
+shared_examples "a datastream profile view" do
+  it { should render_template(:show) }
+end
+
+describe FcrepoAdmin::DatastreamsController do
+  after { object.delete }
+  context "#show" do
+    let(:object) { FactoryGirl.create(:content_model) } 
+    let(:dsid) { "DC" }
+    context "profile information" do
+      subject { get :show, :object_id => object, :id => dsid, :use_route => 'fcrepo_admin' }
+      it { should render_template(:show) }
+    end
+    context "download content" do
+      subject { get :show, :object_id => object, :id => dsid, :download => 'true', :use_route => 'fcrepo_admin' }
+      it { should be_successful }
+    end
+  end
+end

data/spec/factories/fcrepo_admin_factories.rb

@@ -0,0 +1,20 @@
+FactoryGirl.define do
+
+  factory :admin_policy do
+    title "Test APO"
+    permissions [{type: 'group', name: 'public', access: 'read'}]
+    default_permissions [{type: 'group', name: 'public', access: 'read'}]
+  end
+
+  factory :content_model do
+    title "Test Object"
+    permissions [{type: 'group', name: 'public', access: 'read'}]
+
+    trait :has_apo do
+      admin_policy
+    end
+
+    factory :content_model_has_apo, :traits => [:has_apo]
+  end
+
+end

data/spec/factories/user_factories.rb

@@ -0,0 +1,8 @@
+FactoryGirl.define do
+
+  factory :user do
+    sequence(:email) { |n| "person#{n}@example.com" }
+    password 'b1gSecret'
+  end
+
+end

data/spec/features/audit_trail/index.html.erb_spec.rb

@@ -0,0 +1,11 @@
+require 'spec_helper'
+
+describe "audit_trail/index.html.erb" do
+  let(:object) { FactoryGirl.create(:content_model) }
+  after { object.delete }
+  it "should display the audit trail" do
+    visit fcrepo_admin.object_audit_trail_index_path(object)
+    page.should have_content(object.pid)
+    page.should have_link(I18n.t("fcrepo_admin.audit_trail.download"), :href => "#{fcrepo_admin.object_audit_trail_index_path(object)}?download=true")
+  end
+end

data/spec/features/catalog/show.html.erb_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+
+describe "catalog/show.html.erb" do
+  after { object.delete }
+  context "basic object" do
+    let(:object) { FactoryGirl.create(:content_model) }
+    it "should link to all datastreams" do
+      visit catalog_path(object)
+      object.datastreams.reject { |dsid, ds| ds.profile.empty? }.each_key do |dsid|
+        page.should have_link(dsid, :href => fcrepo_admin.object_datastream_path(object, dsid))
+      end
+    end
+    it "should link to its audit trail" do
+      visit catalog_path(object)
+      page.should have_link(I18n.t("fcrepo_admin.audit_trail.title"))
+    end
+  end
+  context "object has admin policy" do
+    it "should link to the APO"
+  end
+end

data/spec/features/datastreams/show.html.erb_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+shared_examples "a datastream show page" do
+  it "should display all attributes of the datastream profile" do
+    object.datastreams[dsid].profile.each do |key, value|
+      expect(subject).to have_content(I18n.t("fcrepo_admin.datastream.profile.#{key}"))
+      expect(subject).to have_content(value)
+    end
+  end
+  it "should have a link to download the datastream content" do
+    expect(subject).to have_link(I18n.t("fcrepo_admin.datastream.download"), :href => fcrepo_admin.download_object_datastream_path(object, dsid))
+  end
+end
+
+shared_examples "an object having datastream show pages" do
+  it_behaves_like "a datastream show page" do
+    let(:dsid) { "DC" }
+  end
+  it_behaves_like "a datastream show page" do
+    let(:dsid) { "RELS-EXT" }
+  end
+end
+
+describe "datastreams/show.html.erb" do
+  subject { page }
+  before { visit fcrepo_admin.object_datastream_path(object, dsid) }
+  after { object.delete }
+  it_behaves_like "an object having datastream show pages" do
+    let(:object) { FactoryGirl.create(:content_model) }
+  end
+end

data/spec/features/objects/show.html.erb_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+
+describe "objects/show.html.erb" do
+  after { object.delete }
+  context "basic object" do
+    let(:object) { FactoryGirl.create(:content_model) }
+    it "should display the object's properties" do
+      visit fcrepo_admin.object_path(object)
+      page.should have_content(I18n.t("fcrepo_admin.object.properties.keys.state"))
+      page.should have_content(I18n.t("fcrepo_admin.object.properties.keys.create_date"))
+      page.should have_content(I18n.t("fcrepo_admin.object.properties.keys.modified_date"))
+      page.should have_content(I18n.t("fcrepo_admin.object.properties.keys.owner_id"))
+      page.should have_content(I18n.t("fcrepo_admin.object.properties.keys.label"))
+    end
+    it "should link to all datastreams" do
+      visit fcrepo_admin.object_path(object)
+      object.datastreams.reject { |dsid, ds| ds.profile.empty? }.each_key do |dsid|
+        page.should have_link(dsid, :href => fcrepo_admin.object_datastream_path(object, dsid))
+      end
+    end
+    it "should link to its audit trail" do
+      visit fcrepo_admin.object_path(object)
+      page.should have_link(I18n.t("fcrepo_admin.audit_trail.title"), :href => fcrepo_admin.object_audit_trail_index_path(object))
+    end
+    context "object governed by an admin policy" do
+      it "should link to the APO"
+    end
+  end
+end

data/spec/fixtures/auditable.foxml.xml

@@ -0,0 +1,110 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<foxml:digitalObject VERSION="1.1" PID="changeme:242"
+xmlns:foxml="info:fedora/fedora-system:def/foxml#"
+xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+xsi:schemaLocation="info:fedora/fedora-system:def/foxml# http://www.fedora.info/definitions/1/0/foxml1-1.xsd">
+<foxml:objectProperties>
+<foxml:property NAME="info:fedora/fedora-system:def/model#state" VALUE="Active"/>
+<foxml:property NAME="info:fedora/fedora-system:def/model#label" VALUE=""/>
+<foxml:property NAME="info:fedora/fedora-system:def/model#ownerId" VALUE="fedoraAdmin"/>
+<foxml:property NAME="info:fedora/fedora-system:def/model#createdDate" VALUE="2013-02-25T16:43:05.802Z"/>
+<foxml:property NAME="info:fedora/fedora-system:def/view#lastModifiedDate" VALUE="2013-02-25T16:43:06.379Z"/>
+</foxml:objectProperties>
+<foxml:datastream ID="AUDIT" STATE="A" CONTROL_GROUP="X" VERSIONABLE="false">
+<foxml:datastreamVersion ID="AUDIT.0" LABEL="Audit Trail for this object" CREATED="2013-02-25T16:43:05.802Z" MIMETYPE="text/xml" FORMAT_URI="info:fedora/fedora-system:format/xml.fedora.audit">
+<foxml:xmlContent>
+<audit:auditTrail xmlns:audit="info:fedora/fedora-system:def/audit#">
+<audit:record ID="AUDREC1">
+<audit:process type="Fedora API-M"/>
+<audit:action>addDatastream</audit:action>
+<audit:componentID>RELS-EXT</audit:componentID>
+<audit:responsibility>fedoraAdmin</audit:responsibility>
+<audit:date>2013-02-25T16:43:06.219Z</audit:date>
+<audit:justification></audit:justification>
+</audit:record>
+<audit:record ID="AUDREC2">
+<audit:process type="Fedora API-M"/>
+<audit:action>addDatastream</audit:action>
+<audit:componentID>descMetadata</audit:componentID>
+<audit:responsibility>fedoraAdmin</audit:responsibility>
+<audit:date>2013-02-25T16:43:06.315Z</audit:date>
+<audit:justification></audit:justification>
+</audit:record>
+<audit:record ID="AUDREC3">
+<audit:process type="Fedora API-M"/>
+<audit:action>addDatastream</audit:action>
+<audit:componentID>rightsMetadata</audit:componentID>
+<audit:responsibility>fedoraAdmin</audit:responsibility>
+<audit:date>2013-02-25T16:43:06.379Z</audit:date>
+<audit:justification></audit:justification>
+</audit:record>
+</audit:auditTrail>
+</foxml:xmlContent>
+</foxml:datastreamVersion>
+</foxml:datastream>
+<foxml:datastream ID="DC" STATE="A" CONTROL_GROUP="X" VERSIONABLE="true">
+<foxml:datastreamVersion ID="DC1.0" LABEL="Dublin Core Record for this object" CREATED="2013-02-25T16:43:05.802Z" MIMETYPE="text/xml" FORMAT_URI="http://www.openarchives.org/OAI/2.0/oai_dc/" SIZE="341">
+<foxml:contentDigest TYPE="SHA-256" DIGEST="eb075bf6da5903e54464631dc998f66f95bffde9f4137132796457d31de5cd44"/>
+<foxml:xmlContent>
+<oai_dc:dc xmlns:oai_dc="http://www.openarchives.org/OAI/2.0/oai_dc/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/oai_dc/ http://www.openarchives.org/OAI/2.0/oai_dc.xsd">
+  <dc:identifier>changeme:242</dc:identifier>
+</oai_dc:dc>
+</foxml:xmlContent>
+</foxml:datastreamVersion>
+</foxml:datastream>
+<foxml:datastream ID="RELS-EXT" STATE="A" CONTROL_GROUP="X" VERSIONABLE="true">
+<foxml:datastreamVersion ID="RELS-EXT.0" LABEL="Fedora Object-to-Object Relationship Metadata" CREATED="2013-02-25T16:43:06.219Z" MIMETYPE="application/rdf+xml" SIZE="284">
+<foxml:contentDigest TYPE="SHA-256" DIGEST="013d2229de7bd91c61256563eff1b475cd1e8f7e45a2f15de5a36f2d20ec2852"/>
+<foxml:xmlContent>
+<rdf:RDF xmlns:ns0="info:fedora/fedora-system:def/model#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
+  <rdf:Description rdf:about="info:fedora/changeme:242">
+    <ns0:hasModel rdf:resource="info:fedora/afmodel:TestModel"></ns0:hasModel>
+  </rdf:Description>
+</rdf:RDF>
+</foxml:xmlContent>
+</foxml:datastreamVersion>
+</foxml:datastream>
+<foxml:datastream ID="descMetadata" STATE="A" CONTROL_GROUP="X" VERSIONABLE="true">
+<foxml:datastreamVersion ID="descMetadata.0" LABEL="" CREATED="2013-02-25T16:43:06.315Z" MIMETYPE="text/xml" SIZE="215">
+<foxml:contentDigest TYPE="SHA-256" DIGEST="3f588eca58dea77b31c9ed0b90e4560288a419856c4bb744fab9c7fe8749ad19"/>
+<foxml:xmlContent>
+<dc xmlns:dcterms="http://purl.org/dc/terms/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <dcterms:title>Fcrepo Test Object</dcterms:title>
+  <dcterms:identifier>test00001</dcterms:identifier>
+</dc>
+</foxml:xmlContent>
+</foxml:datastreamVersion>
+</foxml:datastream>
+<foxml:datastream ID="rightsMetadata" STATE="A" CONTROL_GROUP="X" VERSIONABLE="true">
+<foxml:datastreamVersion ID="rightsMetadata.0" LABEL="" CREATED="2013-02-25T16:43:06.379Z" MIMETYPE="text/xml" SIZE="596">
+<foxml:contentDigest TYPE="SHA-256" DIGEST="472f8634b31bd425dadd9206531ab02a70c08c22e4250bb2b0d3dd0314cfb240"/>
+<foxml:xmlContent>
+<rightsMetadata xmlns="http://hydra-collab.stanford.edu/schemas/rightsMetadata/v1" version="0.1">
+  <copyright>
+    <human type="title"></human>
+    <human type="description"></human>
+    <machine type="uri"></machine>
+  </copyright>
+  <access type="discover">
+    <human></human>
+    <machine></machine>
+  </access>
+  <access type="read">
+    <human></human>
+    <machine>
+      <group>public</group>
+    </machine>
+  </access>
+  <access type="edit">
+    <human></human>
+    <machine></machine>
+  </access>
+  <embargo>
+    <human></human>
+    <machine></machine>
+  </embargo>
+</rightsMetadata>
+</foxml:xmlContent>
+</foxml:datastreamVersion>
+</foxml:datastream>
+</foxml:digitalObject>