hydra-head 3.0.0pre1

data/.gitignore

@@ -0,0 +1,71 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## OSX
+.DS_Store
+nohup.out
+
+## Cucumber
+
+rerun.txt
+
+## rcov
+coverage.data
+coverage/*
+
+## TEST APP
+pkg/
+spec/dummy/db/*.sqlite3
+spec/dummy/log/*.log
+spec/dummy/tmp/
+
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+/.bundle
+/.rvmrc
+db/*.sqlite3
+log/*.log
+tmp/*.log
+tmp/pids/
+tmp/test_app/
+
+*.sqlite3
+*.log
+*~
+*.swp
+
+vendor/plugins/haml/init.rb
+vendor/plugins/blacklight/.git
+log/*
+
+public/plugin_assets
+public/plugin_assets/
+
+tmp/**/*
+tmp/performance
+
+db/schema.rb
+
+.project
+.buildpath
+.rvmrc
+
+/.bundle
+/.yardoc
+/doc
+## PROJECT::SPECIFIC

data/.gitmodules

@@ -0,0 +1,6 @@
+[submodule "hydra-plugin_test_host"]
+	path = hydra-plugin_test_host
+	url = git://github.com/projecthydra/hydra-plugin_test_host.git 
+[submodule "jetty"]
+	path = jetty
+	url = git://github.com/projecthydra/hydra-jetty.git

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in hydra-head-r3.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,257 @@
+PATH
+  remote: .
+  specs:
+    hydra-head (0.0.1)
+      RedCloth (= 4.2.3)
+      active-fedora (>= 2.3.3)
+      blacklight (= 3.0.0)
+      block_helpers
+      builder
+      columnize
+      crack
+      curb
+      database_cleaner
+      diff-lcs
+      facets (= 2.8.4)
+      haml
+      httparty
+      json_pure (> 1.4.3)
+      launchy
+      linecache
+      mime-types
+      multipart-post
+      nokogiri
+      om (>= 1.2.3)
+      rack
+      rack-test
+      rails (>= 3.0)
+      rake
+      rcov
+      sanitize
+      solr-ruby
+      solrizer (>= 1.1.0)
+      solrizer-fedora (>= 1.1.0)
+      sqlite3-ruby (= 1.2.5)
+      term-ansicolor
+      trollop
+      will_paginate
+      xml-simple
+      yard
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    RedCloth (4.2.3)
+    abstract (1.0.0)
+    actionmailer (3.0.9)
+      actionpack (= 3.0.9)
+      mail (~> 2.2.19)
+    actionpack (3.0.9)
+      activemodel (= 3.0.9)
+      activesupport (= 3.0.9)
+      builder (~> 2.1.2)
+      erubis (~> 2.6.6)
+      i18n (~> 0.5.0)
+      rack (~> 1.2.1)
+      rack-mount (~> 0.6.14)
+      rack-test (~> 0.5.7)
+      tzinfo (~> 0.3.23)
+    active-fedora (2.3.3)
+      activeresource
+      equivalent-xml
+      facets
+      mediashelf-loggable
+      mime-types (>= 1.16)
+      multipart-post
+      nokogiri
+      om (>= 1.0)
+      solr-ruby (>= 0.0.6)
+      solrizer (> 1.0.0)
+      xml-simple (>= 1.0.12)
+    activemodel (3.0.9)
+      activesupport (= 3.0.9)
+      builder (~> 2.1.2)
+      i18n (~> 0.5.0)
+    activerecord (3.0.9)
+      activemodel (= 3.0.9)
+      activesupport (= 3.0.9)
+      arel (~> 2.0.10)
+      tzinfo (~> 0.3.23)
+    activeresource (3.0.9)
+      activemodel (= 3.0.9)
+      activesupport (= 3.0.9)
+    activesupport (3.0.9)
+    arel (2.0.10)
+    blacklight (3.0.0)
+      kaminari
+      marc (~> 0.4.3)
+      nokogiri (~> 1.5)
+      rails (~> 3.0)
+      rsolr (~> 1.0)
+      rsolr-ext (~> 1.0)
+      unicode
+    block_helpers (0.3.3)
+      activesupport (>= 2.0)
+    builder (2.1.2)
+    capybara (1.0.0)
+      mime-types (>= 1.16)
+      nokogiri (>= 1.3.3)
+      rack (>= 1.0.0)
+      rack-test (>= 0.5.4)
+      selenium-webdriver (~> 0.2.0)
+      xpath (~> 0.1.4)
+    childprocess (0.2.0)
+      ffi (~> 1.0.6)
+    columnize (0.3.4)
+    crack (0.1.8)
+    cucumber (1.0.2)
+      builder (>= 2.1.2)
+      diff-lcs (>= 1.1.2)
+      gherkin (~> 2.4.5)
+      json (>= 1.4.6)
+      term-ansicolor (>= 1.0.5)
+    cucumber-rails (1.0.2)
+      capybara (>= 1.0.0)
+      cucumber (~> 1.0.0)
+      nokogiri (>= 1.4.6)
+    curb (0.7.15)
+    daemons (1.1.4)
+    database_cleaner (0.6.7)
+    diff-lcs (1.1.2)
+    equivalent-xml (0.2.7)
+      nokogiri (>= 1.4.3)
+    erubis (2.6.6)
+      abstract (>= 1.0.0)
+    facets (2.8.4)
+    factory_girl (1.3.3)
+    fastercsv (1.5.4)
+    ffi (1.0.9)
+    gherkin (2.4.5)
+      json (>= 1.4.6)
+    haml (3.1.2)
+    httparty (0.7.8)
+      crack (= 0.1.8)
+    i18n (0.5.0)
+    jettywrapper (0.0.10)
+      logger
+      mediashelf-loggable
+    json (1.5.3)
+    json_pure (1.5.3)
+    kaminari (0.12.4)
+      rails (>= 3.0.0)
+    launchy (2.0.3)
+    linecache (0.46)
+      rbx-require-relative (> 0.0.4)
+    logger (1.2.8)
+    mail (2.2.19)
+      activesupport (>= 2.3.6)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    marc (0.4.3)
+    mediashelf-loggable (0.4.2)
+    mime-types (1.16)
+    mocha (0.9.12)
+    multipart-post (1.1.2)
+    nokogiri (1.5.0)
+    om (1.2.5)
+      nokogiri (>= 1.4.2)
+    polyglot (0.3.1)
+    rack (1.2.3)
+    rack-mount (0.6.14)
+      rack (>= 1.0.0)
+    rack-test (0.5.7)
+      rack (>= 1.0)
+    rails (3.0.9)
+      actionmailer (= 3.0.9)
+      actionpack (= 3.0.9)
+      activerecord (= 3.0.9)
+      activeresource (= 3.0.9)
+      activesupport (= 3.0.9)
+      bundler (~> 1.0)
+      railties (= 3.0.9)
+    railties (3.0.9)
+      actionpack (= 3.0.9)
+      activesupport (= 3.0.9)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (~> 0.14.4)
+    rake (0.9.2)
+    rbx-require-relative (0.0.5)
+    rcov (0.9.9)
+    rdoc (3.8)
+    rsolr (1.0.2)
+      builder (>= 2.1.2)
+    rsolr-ext (1.0.3)
+      rsolr (>= 1.0.2)
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.4)
+    rspec-expectations (2.6.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.6.0)
+    rspec-rails (2.6.1)
+      actionpack (~> 3.0)
+      activesupport (~> 3.0)
+      railties (~> 3.0)
+      rspec (~> 2.6.0)
+    ruby-debug (0.10.4)
+      columnize (>= 0.1)
+      ruby-debug-base (~> 0.10.4.0)
+    ruby-debug-base (0.10.4)
+      linecache (>= 0.3)
+    rubyzip (0.9.4)
+    sanitize (2.0.3)
+      nokogiri (< 1.6, >= 1.4.4)
+    selenium-webdriver (0.2.2)
+      childprocess (>= 0.1.9)
+      ffi (>= 1.0.7)
+      json_pure
+      rubyzip
+    solr-ruby (0.0.8)
+    solrizer (1.1.0)
+      daemons
+      mediashelf-loggable
+      nokogiri
+      om (>= 1.0.0)
+      stomp
+      xml-simple
+    solrizer-fedora (1.1.0)
+      active-fedora (>= 2.3.0)
+      fastercsv
+      rsolr
+      solr-ruby (>= 0.0.6)
+      solrizer (>= 1.0.0)
+    sqlite3-ruby (1.2.5)
+    stomp (1.1.9)
+    term-ansicolor (1.0.5)
+    thor (0.14.6)
+    treetop (1.4.9)
+      polyglot (>= 0.3.1)
+    trollop (1.16.2)
+    tzinfo (0.3.29)
+    unicode (0.4.0)
+    will_paginate (2.3.15)
+    xml-simple (1.1.0)
+    xpath (0.1.4)
+      nokogiri (~> 1.3)
+    yard (0.7.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  cucumber (>= 0.8.5)
+  cucumber-rails (>= 1.0.0)
+  factory_girl
+  gherkin
+  hydra-head!
+  jettywrapper (~> 0.0.10)
+  mocha
+  rake
+  rspec (>= 2.0.0)
+  rspec-rails (>= 2.0.0)
+  ruby-debug
+  ruby-debug-base

data/README.textile

@@ -0,0 +1,150 @@
+h1. Hydra-Head
+
+Hydra-Head is a Rails Engines plugin containing the core code for a Hydra application.  The full hydra stack includes the following:
+
+- "Blacklight":http://projectblacklight.org/  (a rails engines plugin) for the User Interface
+- "Solr":http://lucene.apache.org/solr/ (a java application, also ported to other languages) for the Search Engine 
+- "ActiveFedora":https://github.com/mediashelf/active_fedora (a ruby gem) to let the rails application talk to fedora 
+- "OM (Opinionated Metadata)":https://github.com/mediashelf/om (a ruby gem) to streamline the metadata configuration
+- "Solrizer":https://github.com/projecthydra/solrizer (a ruby gem) to write content to the Solr index
+- "SolrizerFedora":https://github.com/projecthydra/solrizer-fedora (a ruby gem) to write Fedora content to the Solr index.
+- HydraHead (a rails engines plugin) to glue it all together 
+
+For a more thorough overview of the Hydra framework, see "HYDRA_OVERVIEW.textile":https://github.com/projecthydra/hydrangea/blob/master/HYDRA_OVERVIEW.textile.
+
+This is a Ruby on Rails 3 gem.
+
+h2. Installation/Setup
+
+h3. Install Rails, Bundler and Devise
+
+<pre>
+gem install 'rails'
+gem install 'bundler'
+gem install 'devise'
+</pre>
+  
+h3. Generate a new rails application:
+
+<pre>
+rails new my_hydra_head
+cd my_hydra_head
+</pre>
+
+h3. Init the git Repository
+
+First, put a .gitignore file into the root of your project to keep your repository clean.  You could start with the ".gitignore file from the hydra-head gem":https://github.com/projecthydra/hydra-head/blob/master/.gitignore
+
+Now init the git repository and add the initial set of files
+
+<pre>
+  git init
+  git add .
+  git commit -m"Initial Commit: empty rails app"
+</pre>
+
+h3. Add the blacklight and hydra-head gems:
+
+First, add them to the Gemfile of your application:
+
+<pre>
+  source 'http://rubygems.org'
+
+  gem 'rails', '>=3.0.4'
+
+  gem 'blacklight', '~> 3.0.0'
+  gem 'hydra-head', '3.0.0pre1'
+  
+  # We will assume that you're using sqlite3 for testing/demo, 
+  # but in a production setup you probably want to use a real sql database like mysql or postgres
+  gem 'sqlite3-ruby', :require => 'sqlite3'
+  
+  #  We will assume you're using devise in tutorials/documentation. 
+  # You are free to implement your own User/Authentication solution in its place.
+  gem 'devise'
+
+  # For testing.  You will probably want to use all of these to run the tests you write for your hydra head
+  group :development, :test do 
+         gem 'solrizer-fedora', '>=1.0.1'
+         gem 'ruby-debug'
+         gem 'rspec'
+         gem 'rspec-rails', '>=2.5.0'
+         gem 'mocha'
+         #gem 'generator_spec'
+         gem 'cucumber-rails'
+         gem 'database_cleaner'
+         gem 'capybara'
+         #gem 'webrat'
+         #gem 'aruba'
+         gem 'factory_girl'
+         gem 'bcrypt-ruby'
+  end
+</pre>
+
+To install all of the dependencies, run:
+
+<pre>
+bundle install
+</pre>
+
+h3. Run the generators and migrations:
+
+Run the blacklight generator
+
+<pre>rails g blackight -devise</pre>
+
+Run the hydra-head generator
+
+<pre>rails g hydra-head -df</pre>
+
+Run the database migrations
+
+<pre>
+rake db:migrate
+rake db:migrate RAILS_ENV=test
+</pre>
+  
+If you will be writing cucumber tests, run the cucumber generator
+
+<pre>rails g cucumber:install</pre>
+
+h3. Add all the generated code to the Git repository
+
+<pre>
+  git add .
+  git commit -m"Ran Blacklight, Hydra-Head, and Cucumber Generators"
+</pre>
+
+h3. The Hydra Jetty
+
+The Hydra project provides a copy of Jetty with Fedora and Solr pre-installed.  This is useful for running tests against and for running your code against while you're actively working on your hydra head.
+
+Most projects add hydra jetty to their code as a git submodule
+
+<pre>
+  git submodule add git@github.com:projecthydra/hydra-jetty.git jetty
+  git commit -m"added jetty submodule"
+</pre>
+
+Now that you've added the submodule to your git repository, whenever you grab a new working copy of the code, you can get hydra-jetty by running:
+
+<pre>
+git submodule init
+git submodule update
+</pre>
+
+h2. Run tests to make sure everything is installed properly
+
+*TODO*
+
+h2. Modifying and Testing the Gem 
+
+For those developers who want to or need to work on the hydra-head gem itself, see the "Instructions for Contributors":http://hudson.projecthydra.org/job/hydra-head-rails3-plugin/Documentation/file.TESTING.html
+
+h2. Acknowledgements
+
+h3. Design & Strategic Contributions
+
+The Hydra Framework would not exist without the extensive design effort undertaken by representatives of repository initiatives from Stanford University, University of Virginia, University of Hull and MediaShelf LLC.  Contributors to that effort include Tom Cramer, Lynn McRae, Martha Sites, Richard Green, Chris Awre, and Matt Zumwalt.  
+
+Thorny Staples from Fedora Commons & DuraSpace deserves special thanks for putting all of these people in the same room together.