geoblacklight 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2790f480cb5d55cf12f7cb2833a40fbd366d72c9
-  data.tar.gz: b72946fc1299ff88dcb829dde41b2060ca53195a
+  metadata.gz: 63a935be20a30e560a0653acdd2397fe9393d40f
+  data.tar.gz: 325d07c535bf6b20a9a74f6f9d039dbd5257ce85
 SHA512:
-  metadata.gz: 08ef76ebafe288ba94d401d88af615b56f4dc531df078cc3308ff8e7952001aa49a00b7c437ef4570d860a6c7718b95bc83b8b6ff683190e393cf90171f92e66
-  data.tar.gz: bbd8456833a4c4bec1c978cdc3edaf82913cd6517e8c961795e8d1d3a7a6b8c308987d0312061b57be50677ba3f141a32b0ee4675b1c3857817ec93f34a2f091
+  metadata.gz: 5a8f2aca97d1458f5c8932aebe58e86ffbce1e330363448f34e25facf451b58eb713f0abc4071a1f5b39dcadeb0fb2e2690e6b2ee7feec05e052eea543e56b97
+  data.tar.gz: 4a28c89f1d327a4cbf1c1cf1ddac47acf8e95d9730a6dab4bb65846904ed86e272b42a23f165ba2d5a05d5573ca42db0ef07d4ab2dd461f810ceafce55e46fd4

data/.rubocop.yml

@@ -25,7 +25,7 @@ Metrics/AbcSize:
   Max: 23
 
 Metrics/MethodLength:
-  Max: 15
+  Max: 16
 
 # TODO: Add top-level class and module documentation.
 Style/Documentation:

data/.travis.yml

@@ -10,16 +10,16 @@ rvm:
 matrix:
   include:
     - rvm: 2.3.1
-      env: "RAILS_VERSION=4.2.6"
+      env: "RAILS_VERSION=4.2.7.1"
     - rvm: 2.2.5
-      env: "RAILS_VERSION=5.0.0"
+      env: "RAILS_VERSION=5.0.0.1"
 
 before_install:
   - gem update --system
   - gem install bundler
 
 env:
- - "RAILS_VERSION=5.0.0"
+ - "RAILS_VERSION=5.0.0.1"
 
 global_env:
   - NOKOGIRI_USE_SYSTEM_LIBRARIES=true

data/app/assets/javascripts/geoblacklight/geoblacklight.js

@@ -20,7 +20,7 @@
 
   var GeoBlacklight = L.Class.extend({
     statics: {
-      __version__: '1.2.0',
+      __version__: '1.3.0',
 
       debounce: function(fn, delay) {
         var timeout = null;

data/app/assets/javascripts/geoblacklight/modules/relations.js

@@ -0,0 +1,14 @@
+Blacklight.onLoad(function () {
+    $('[data-relations="true"]').each(function (i, element) {
+        var $elem = $(element);
+        var attributes = $elem.data();
+        var relation_url = attributes['url'] + '/relations';
+        $.ajax({
+            url: relation_url,
+            type: 'GET',
+            success: function (data) {
+                $elem.append($(data).hide().fadeIn(200));
+            }
+        })
+    });
+});

data/app/assets/stylesheets/geoblacklight/modules/icon-customization.scss

@@ -34,6 +34,14 @@
   @extend .fa, .fa-envelope;
 }
 
+.geoblacklight-relations-ancestor {
+  @extend .fa, .fa-pagelines;
+}
+
+.geoblacklight-relations-descendant {
+  @extend .fa, .fa-leaf;
+}
+
 .geoblacklight-web_services {
   @extend .fa, .fa-external-link;
 }

data/app/controllers/relation_controller.rb

@@ -0,0 +1,10 @@
+class RelationController < ApplicationController
+  include Blacklight::Configurable
+  include Blacklight::SearchHelper
+  copy_blacklight_config_from(CatalogController)
+
+  def index
+    @relations = Geoblacklight::Relation::RelationResponse.new(params[:id], repository)
+    render layout: !request.xhr?
+  end
+end

data/app/helpers/blacklight_helper.rb

@@ -1,4 +1,9 @@
 module BlacklightHelper
   include Blacklight::BlacklightHelperBehavior
   include Geoblacklight::GeoblacklightHelperBehavior
+  include Blacklight::CatalogHelperBehavior
+
+  def render_document_sidebar_partial(document = @document)
+    super(document) + (render 'relations_container', document: document)
+  end
 end

data/app/views/catalog/_relations_container.html.erb

@@ -0,0 +1 @@
+<%= content_tag(:div, nil, data: {relations: true, url: solr_document_path(document.id)}) %>

data/app/views/relation/_ancestors.html.erb

@@ -0,0 +1,8 @@
+<b><%= t('geoblacklight.relations.ancestor') %></b>
+<% @relations.ancestors['docs'].each do |ancestor| %>
+  <li>
+    <%= link_to solr_document_path(ancestor['layer_slug_s']) do %>
+      <span class='geoblacklight geoblacklight-relations-ancestor'></span> <%= ancestor['dc_title_s'] %>
+    <% end %>
+  </li>
+<% end %>

data/app/views/relation/_descendants.html.erb

@@ -0,0 +1,15 @@
+<b><%= t('geoblacklight.relations.descendant', count: @relations.descendants['numFound']) %></b>
+<% @relations.descendants['docs'][0..2].each do |descendant| %>
+  <li>
+    <%= link_to solr_document_path(descendant['layer_slug_s']) do %>
+      <span class='geoblacklight geoblacklight-relations-descendant'></span> <%= descendant['dc_title_s'] %>
+    <% end %>
+  </li>
+<% end %>
+<% unless (@relations.descendants['numFound'].to_i <= 3) %>
+  <li>
+    <%= link_to search_catalog_path({f: {"#{Settings.FIELDS.SOURCE}" => [@relations.search_id]}}) do %>
+      <%= t('geoblacklight.relations.browse_all', count: @relations.descendants['numFound']) %>
+    <% end %>
+  </li>
+<% end %>

data/app/views/relation/index.html.erb

@@ -0,0 +1,13 @@
+<% unless @relations.empty? %>
+  <div class="panel panel-default show-tools">
+    <div class="panel-heading">
+      <%= t('geoblacklight.relations.title') %>
+    </div>
+    <div class="panel-body">
+      <ul class="nav">
+        <%= render 'ancestors' unless @relations.ancestors['numFound'].to_i == 0 %>
+        <%= render 'descendants' unless @relations.descendants['numFound'].to_i == 0 %>
+      </ul>
+    </div>
+  </div>
+<% end %>

data/app/views/relation/index.json.jbuilder

@@ -0,0 +1,3 @@
+json.ancestors@relations.ancestors
+json.descendants @relations.descendants
+json.current_doc @relations.search_id

data/config/locales/geoblacklight.en.yml

@@ -32,3 +32,8 @@ en:
       dynamic_map_layer: 'ArcGIS Dynamic Map Layer'
       image_map_layer: 'ArcGIS Image Map Layer'
       data_dictionary: 'Documentation'
+    relations:
+      ancestor: 'Source Datasets'
+      descendant: 'Derived Datasets (%{count})'
+      browse_all: "Browse all %{count} records..."
+      title: 'Data Relations'

data/geoblacklight.gemspec

@@ -32,7 +32,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'solr_wrapper'
   spec.add_development_dependency 'rails-controller-testing'
   spec.add_development_dependency 'rspec-rails', '~> 3.1'
-  spec.add_development_dependency 'engine_cart', '~> 0.10'
+  spec.add_development_dependency 'engine_cart', '~> 1.0'
   spec.add_development_dependency 'capybara', '>= 2.5.0'
   spec.add_development_dependency 'poltergeist'
   spec.add_development_dependency 'factory_girl_rails'

data/lib/generators/geoblacklight/install_generator.rb

@@ -20,17 +20,14 @@ module Geoblacklight
           resources :solr_documents, only: [:show], path: '/catalog', controller: 'catalog' do
             concerns :gbl_exportable
           end
-
           concern :gbl_wms, Geoblacklight::Routes::Wms.new
           namespace :wms do
             concerns :gbl_wms
           end
-
           concern :gbl_downloadable, Geoblacklight::Routes::Downloadable.new
           namespace :download do
             concerns :gbl_downloadable
           end
-
           resources :download, only: [:show]
       EOF
     end

data/lib/generators/geoblacklight/templates/settings.yml

@@ -28,6 +28,7 @@ FIELDS:
   :PART_OF: 'dct_isPartOf_sm'
   :TEMPORAL: 'dct_temporal_sm'
   :TITLE: 'dc_title_s'
+  :SOURCE: 'dc_source_sm'
 
 # Institution deployed at
 INSTITUTION: 'Stanford'

data/lib/geoblacklight.rb

@@ -22,6 +22,9 @@ module Geoblacklight
   require 'geoblacklight/reference'
   require 'geoblacklight/references'
   require 'geoblacklight/routes'
+  require 'geoblacklight/relation/descendants'
+  require 'geoblacklight/relation/ancestors'
+  require 'geoblacklight/relation/relation_response'
 
   def self.inject!
     CatalogController.send(:include, Geoblacklight::ControllerOverride)

data/lib/geoblacklight/relation/ancestors.rb

@@ -0,0 +1,27 @@
+module Geoblacklight
+  module Relation
+    class Ancestors
+      def initialize(id, repository)
+        @search_id = id
+        @repository = repository
+      end
+
+      def create_search_params
+        { fq: ["{!join from=#{Settings.FIELDS.SOURCE} to=layer_slug_s}layer_slug_s:#{@search_id}"],
+          fl: [Settings.FIELDS.TITLE, 'layer_slug_s'] }
+      end
+
+      def execute_query
+        @repository.connection.send_and_receive(
+          @repository.blacklight_config.solr_path,
+          params: create_search_params
+        )
+      end
+
+      def results
+        response = execute_query
+        response['response']
+      end
+    end
+  end
+end

data/lib/geoblacklight/relation/descendants.rb

@@ -0,0 +1,27 @@
+module Geoblacklight
+  module Relation
+    class Descendants
+      def initialize(id, repository)
+        @search_id = id
+        @repository = repository
+      end
+
+      def create_search_params
+        { fq: "#{Settings.FIELDS.SOURCE}:#{@search_id}",
+          fl: [Settings.FIELDS.TITLE, 'layer_slug_s'] }
+      end
+
+      def execute_query
+        @repository.connection.send_and_receive(
+          @repository.blacklight_config.solr_path,
+          params: create_search_params
+        )
+      end
+
+      def results
+        response = execute_query
+        response['response']
+      end
+    end
+  end
+end

data/lib/geoblacklight/relation/relation_response.rb

@@ -0,0 +1,23 @@
+module Geoblacklight
+  module Relation
+    class RelationResponse
+      attr_reader :search_id
+      def initialize(id, repository)
+        @search_id = id
+        @repository = repository
+      end
+
+      def ancestors
+        @ancestors ||= Geoblacklight::Relation::Ancestors.new(@search_id, @repository).results
+      end
+
+      def descendants
+        @descendants ||= Geoblacklight::Relation::Descendants.new(@search_id, @repository).results
+      end
+
+      def empty?
+        !(ancestors['numFound'] > 0 || descendants['numFound'] > 0)
+      end
+    end
+  end
+end

data/lib/geoblacklight/routes/exportable.rb

@@ -9,6 +9,7 @@ module Geoblacklight
         mapper.member do
           mapper.get 'web_services'
           mapper.get 'metadata'
+          mapper.get 'relations' => 'relation#index'
         end
       end
     end

data/lib/geoblacklight/version.rb

@@ -1,3 +1,3 @@
 module Geoblacklight
-  VERSION = '1.2.0'.freeze
+  VERSION = '1.3.0'.freeze
 end

data/spec/controllers/relation_controller_spec.rb

@@ -0,0 +1,11 @@
+require 'spec_helper'
+
+describe RelationController, type: :controller do
+  describe '#index' do
+    it 'returns a listing of related documents for a record' do
+      get :index, params: { id: 'nyu_2451_34502' }
+      expect(response.status).to eq 200
+      expect(assigns(:relations)).not_to be_nil
+    end
+  end
+end

data/spec/features/esri_viewer_spec.rb

@@ -12,7 +12,7 @@ feature 'feature_layer reference', js: true do
     expect(page).to have_css 'img.leaflet-image-layer', visible: true
   end
   scenario 'displays dynamic layer (single layer)' do
-    visit solr_document_path 'michigan-state-urn-ad0e6ebc-824e-4450-a0d9-987f2232724f'
+    visit solr_document_path 'Minnesota-urn-0f7ae38b-4bf2-4e03-a32b-e87f245ccb03'
     expect(page).to have_css '.leaflet-control-zoom', visible: true
     expect(page).to have_css 'img.leaflet-image-layer', visible: true
   end

data/spec/features/relations_spec.rb

@@ -0,0 +1,51 @@
+require 'spec_helper'
+
+feature 'Display related documents' do
+  let(:expected_json_resp) do
+    {
+      'ancestors' =>
+        {
+          'numFound' => 0,
+          'start' => 0,
+          'docs' => []
+        },
+      'descendants' =>
+            {
+              'numFound' => 1,
+              'start' => 0,
+              'docs' =>
+                    [
+                      {
+                        'dc_title_s' => '2015 New York City Subway Complexes and Ridership',
+                        'layer_slug_s' => 'nyu_2451_34502'
+                      }
+                    ]
+            },
+      'current_doc' => 'nyu_2451_34635'
+    }
+  end
+  scenario 'Record with dc_source_sm value(s) should have parent(s)' do
+    visit relations_solr_document_path('nyu_2451_34502')
+    expect(page).to have_css('ul b', text: 'Source Datasets')
+  end
+
+  scenario 'Record that is pointed to by others should have children' do
+    visit relations_solr_document_path('nyu_2451_34635')
+    expect(page).to have_css('ul b', text: 'Derived Datasets')
+  end
+
+  scenario 'Relations should respond to json' do
+    visit relations_solr_document_path('nyu_2451_34635', format: 'json')
+    expect(page.body).to eq(expected_json_resp.to_json)
+  end
+
+  scenario 'Record with relations should render widget in catalog#show', js: true do
+    visit solr_document_path('nyu_2451_34635')
+    expect(page).to have_css('div.panel-heading', text: 'Data Relations')
+  end
+
+  scenario 'Record without relations should not render widget in catalog#show', js: true do
+    visit solr_document_path('harvard-g7064-s2-1834-k3')
+    expect(page).to have_no_css('div.panel-heading', text: 'Data Relations')
+  end
+end

data/spec/features/split_view.html.erb_spec.rb

@@ -49,7 +49,7 @@ feature 'Index view', js: true do
   scenario 'spatial search should reset to page one' do
     visit '/?per_page=5&q=%2A&page=2'
     find('#map').double_click
-    expect(find('.page_entries')).to have_content(/^1 - \d of \d.$/)
+    expect(find('.page_entries')).to have_content(/^1 - \d of \d.*$/)
   end
 
   scenario 'clicking map search should retain current search parameters' do

data/spec/fixtures/solr_documents/baruch_ancestor1.json

@@ -0,0 +1,46 @@
+{
+  "dc_identifier_s": "http://hdl.handle.net/2451/34635",
+  "dc_title_s": "2016 NYC Geodatabase, Open Source Version (jan2016)",
+  "dc_description_s": "The NYC Geodatabase (nyc_gdb) is a resource designed for basic geographic analysis and thematic mapping within the five boroughs of New York City. It contains geographic features and data compiled from several public sources. Subsets of large features like water, greenspace, and public facilities were created and Census geographies like tracts, ZCTAs, and PUMAs were geoprocessed to create land-based boundaries. Census data from the 2010 Census, American Community Survey (ACS), and ZIP Code Business Patterns are stored in tables that can be easily related to geographic features. Transit and public facility point data were gathered from several city agencies and transformed into spatial data that can be used for reference or analysis for measuring distance, drawing buffers, or counting features within areas. The data is provided in SQLite format.",
+  "dc_rights_s": "Public",
+  "dct_provenance_s": "Baruch CUNY",
+  "dct_references_s": "{\"http://schema.org/url\":\"http://hdl.handle.net/2451/34635\",\"http://schema.org/downloadUrl\":\"https://archive.nyu.edu/retrieve/74854/nyu_2451_34635.zip\",\"http://lccn.loc.gov/sh85035852\":\"https://archive.nyu.edu/retrieve/74855/nyu_2451_34635_doc.zip\"}",
+  "layer_id_s": "sdr:nyu_2451_34635",
+  "layer_slug_s": "nyu_2451_34635",
+  "layer_geom_type_s": "Mixed",
+  "layer_modified_dt": "2016-5-2T18:21:7Z",
+  "dc_format_s": "SQLite Database",
+  "dc_language_s": "English",
+  "dc_type_s": "Dataset",
+  "dc_publisher_s": [
+    "Newman Library (Bernard M. Baruch College)"
+  ],
+  "dc_creator_sm": "GIS Lab, Newman Library, Baruch CUNY",
+  "dc_subject_sm": [
+    "Boroughs",
+    "Boundaries",
+    "Counties"
+  ],
+  "dct_isPartOf_sm": "NYC Geodatabase (version jan2016)",
+  "dct_issued_s": "1/15/2016",
+  "dct_temporal_sm": [
+    "2010",
+    "2016"
+  ],
+  "dct_spatial_sm": [
+    "New York, New York, United States",
+    "Bronx County, New York, United States",
+    "Kings County, New York, United States",
+    "New York County, New York, United States",
+    "Queens County, New York, United States",
+    "Richmond County, New York, United States",
+    "Borough of Bronx, New York, United States",
+    "Borough of Brooklyn, New York, United States",
+    "Borough of Manhattan, New York, United States",
+    "Borough of Queens, New York, United States",
+    "Borough of Staten Island, New York, United States"
+  ],
+  "solr_geom": "ENVELOPE(-74.255895, -73.700272, 40.9152819999998, 40.4959289999998)",
+  "solr_year_i": 2016,
+  "geoblacklight_version": "1.0"
+}

data/spec/fixtures/solr_documents/baruch_ancestor2.json

@@ -0,0 +1,46 @@
+{
+  "dc_identifier_s": "http://hdl.handle.net/2451/34636",
+  "dc_title_s": "2016 NYC Geodatabase, ArcGIS Version (jan2016)",
+  "dc_description_s": "The NYC Geodatabase (nyc_gdb) is a resource designed for basic geographic analysis and thematic mapping within the five boroughs of New York City. It contains geographic features and data compiled from several public sources. Subsets of large features like water, greenspace, and public facilities were created and Census geographies like tracts, ZCTAs, and PUMAs were geoprocessed to create land-based boundaries. Census data from the 2010 Census, American Community Survey (ACS), and ZIP Code Business Patterns are stored in tables that can be easily related to geographic features. Transit and public facility point data were gathered from several city agencies and transformed into spatial data that can be used for reference or analysis for measuring distance, drawing buffers, or counting features within areas. The data is provided in ESRI Geodatabase format.",
+  "dc_rights_s": "Public",
+  "dct_provenance_s": "Baruch CUNY",
+  "dct_references_s": "{\"http://schema.org/url\":\"http://hdl.handle.net/2451/34636\",\"http://schema.org/downloadUrl\":\"https://archive.nyu.edu/retrieve/74856/nyu_2451_34636.zip\",\"http://lccn.loc.gov/sh85035852\":\"https://archive.nyu.edu/retrieve/74857/nyu_2451_34636_doc.zip\"}",
+  "layer_id_s": "sdr:nyu_2451_34636",
+  "layer_slug_s": "nyu_2451_34636",
+  "layer_geom_type_s": "Mixed",
+  "layer_modified_dt": "2016-5-2T18:21:7Z",
+  "dc_format_s": "ESRI Geodatabase",
+  "dc_language_s": "English",
+  "dc_type_s": "Dataset",
+  "dc_publisher_s": [
+    "Newman Library (Bernard M. Baruch College)"
+  ],
+  "dc_creator_sm": "GIS Lab, Newman Library, Baruch CUNY",
+  "dc_subject_sm": [
+    "Boroughs",
+    "Boundaries",
+    "Counties"
+  ],
+  "dct_isPartOf_sm": "NYC Geodatabase (version jan2016)",
+  "dct_issued_s": "1/15/2016",
+  "dct_temporal_sm": [
+    "2010",
+    "2016"
+  ],
+  "dct_spatial_sm": [
+    "New York, New York, United States",
+    "Bronx County, New York, United States",
+    "Kings County, New York, United States",
+    "New York County, New York, United States",
+    "Queens County, New York, United States",
+    "Richmond County, New York, United States",
+    "Borough of Bronx, New York, United States",
+    "Borough of Brooklyn, New York, United States",
+    "Borough of Manhattan, New York, United States",
+    "Borough of Queens, New York, United States",
+    "Borough of Staten Island, New York, United States"
+  ],
+  "solr_geom": "ENVELOPE(-74.255895, -73.700272, 40.9152819999998, 40.4959289999998)",
+  "solr_year_i": 2016,
+  "geoblacklight_version": "1.0"
+}

data/spec/fixtures/solr_documents/esri-dynamic-layer-single-layer.json

@@ -1,34 +1,37 @@
 {
   "geoblacklight_version": "1.0",
-  "dc_creator_sm": [
-    "State of Michigan"
-  ],
-  "dc_description_s": "Michigan Glacial Landsystems",
-  "dc_format_s": "Shapefile",
-  "dc_identifier_s": "urn-ad0e6ebc-824e-4450-a0d9-987f2232724f",
-  "dc_publisher_sm": [
-    "State of Michigan GIS Open Data"
-  ],
+  "layer_geom_type_s": "Polygon",
+  "layer_modified_dt": "2016-09-19T16:48:34Z",
+  "solr_geom": "ENVELOPE(-93.772, -93.1769, 45.2477, 44.7834)",
+  "dct_references_s": "{\"http://schema.org/downloadUrl\":\"http://gis.hennepin.opendata.arcgis.com/datasets/62c63204202b45aca308a60efd8784d9_0.zip\",\"http://schema.org/url\":\"http://gis.hennepin.opendata.arcgis.com/datasets/62c63204202b45aca308a60efd8784d9_0\",\"http://www.isotc211.org/schemas/2005/gmd/\":\"https://opengeometadata.github.io/edu.umn/0f/7a/e3/8b4bf24e03a32be87f245ccb03/iso19139.xml\",\"urn:x-esri:serviceType:ArcGIS#DynamicMapLayer\":\"https://gis.hennepin.us/arcgis/rest/services/HennepinData/PEOPLE_SOCIETY/MapServer/0\"}",
   "dc_rights_s": "Public",
+  "dct_provenance_s": "Minnesota",
   "dc_subject_sm": [
-    "geoscientificinformation",
-    "utilitiesCommunications",
-    "inlandWaters",
-    "glaciers",
-    "geology"
+    "Society"
+  ],
+  "dct_temporal_sm": [
+    "2015"
+  ],
+  "dc_description_s": "2010 US Census County Subdivisions (Cities) for Hennepin County with subset of PL94-171 demographic data. The Hennepin County GIS Office downloaded US Census data from the following sites: Shapefiles: http://www.census.gov/cgi-bin/geo/shapefiles2010/main PL94-171: http://www.census.gov/rdo/data/2010_census_redistricting_data_pl_94-171_summary_files.html PL94-171 tabular data was post processed per instructions and stored in an Access database. Link to Attribute Table Information: http://gis.hennepin.us/OpenData/Metadata/2010%20Census%20Cities.pdf Data updated: 04/08/2011 Use Limitations: This data (i) is furnished 'AS IS' with no representation as to completeness or accuracy; (ii) is furnished with no warranty of any kind; and (iii) is not suitable for legal, engineering or surveying purposes. Hennepin County shall not be liable for any damage, injury or loss resulting from this data.",
+  "dct_issued_s": "2015-09-11T18:24:36Z",
+  "dc_format_s": "Shapefile",
+  "dc_creator_sm": [
+    "Hennepin County"
   ],
-  "dc_title_s": "Glacial Landsystems: Michigan, 2015",
   "dc_type_s": "Dataset",
-  "dct_issued_s": "2015-02-28T18:53:27Z",
-  "dct_provenance_s": "Michigan State",
-  "dct_references_s": "{\"http://schema.org/downloadUrl\":\"http://gis.michigan.opendata.arcgis.com/datasets/a020fc444ff04d6abf7b03b268cadb71_9.zip\",\"http://schema.org/url\":\"http://gis.michigan.opendata.arcgis.com/datasets/a020fc444ff04d6abf7b03b268cadb71_9\",\"http://www.isotc211.org/schemas/2005/gmd/\":\"https://opengeometadata.github.io/edu.michstate/ad/0e/6e/bc824e4450a0d9987f2232724f/iso19139.xml\",\"urn:x-esri:serviceType:ArcGIS#DynamicMapLayer\":\"https://gisago.mcgi.state.mi.us/arcgis/rest/services/OpenData/hydro/MapServer/9\"}",
+  "dc_identifier_s": "urn-0f7ae38b-4bf2-4e03-a32b-e87f245ccb03",
+  "dct_isPartOf_sm": [
+    "Hennepin County Open Data"
+  ],
+  "solr_year_i": 2015,
   "dct_spatial_sm": [
-    "Michigan"
+    "Hennepin County, Minnesota",
+    "Minnesota"
   ],
-  "layer_geom_type_s": "Polygon",
-  "layer_id_s": "urn:urn-ad0e6ebc-824e-4450-a0d9-987f2232724f",
-  "layer_modified_dt": "2016-07-18T15:17:46Z",
-  "layer_slug_s": "michigan-state-urn-ad0e6ebc-824e-4450-a0d9-987f2232724f",
-  "solr_geom": "ENVELOPE(-90.5497, -82.0758, 48.2152, 41.6321)",
-  "solr_year_i": 2015
-}
+  "dc_publisher_sm": [
+    "Hennepin County"
+  ],
+  "layer_id_s": "urn:urn-0f7ae38b-4bf2-4e03-a32b-e87f245ccb03",
+  "dc_title_s": "2010 Census Cities: Hennepin County, Minnesota",
+  "layer_slug_s": "Minnesota-urn-0f7ae38b-4bf2-4e03-a32b-e87f245ccb03"
+}

data/spec/lib/geoblacklight/relation/ancestors_spec.rb

@@ -0,0 +1,32 @@
+require 'spec_helper'
+
+describe Geoblacklight::Relation::Ancestors do
+  let(:repository) { Blacklight::Solr::Repository.new(CatalogController.blacklight_config) }
+  let(:ancestors) { described_class.new('nyu_2451_34502', repository) }
+  let(:empty_ancestors) { described_class.new('harvard-g7064-s2-1834-k3', repository) }
+
+  describe '#create_search_params' do
+    it 'assembles the correct search params for finding ancestor documents' do
+      expect(ancestors.create_search_params).to eq(fq: ["{!join from=#{Settings.FIELDS.SOURCE} to=layer_slug_s}layer_slug_s:nyu_2451_34502"], fl: [Settings.FIELDS.TITLE.to_s, 'layer_slug_s'])
+    end
+  end
+
+  describe '#execute_query' do
+    it 'executes the query for finding ancestors, return response' do
+      expect(ancestors.execute_query).to include('responseHeader')
+    end
+  end
+
+  describe '#results' do
+    it 'produces a hash of results from the query' do
+      expect(ancestors.results).to include('numFound')
+      expect(ancestors.results).to include('docs')
+    end
+    it 'has non-zero numfound for a document with ancestors' do
+      expect(ancestors.results['numFound']).to be > 0
+    end
+    it 'has zero numfound for a document without ancestors' do
+      expect(empty_ancestors.results['numFound']).to eq(0)
+    end
+  end
+end

data/spec/lib/geoblacklight/relation/descendants_spec.rb

@@ -0,0 +1,32 @@
+require 'spec_helper'
+
+describe Geoblacklight::Relation::Descendants do
+  let(:repository) { Blacklight::Solr::Repository.new(CatalogController.blacklight_config) }
+  let(:descendants) { described_class.new('nyu_2451_34636', repository) }
+  let(:empty_descendants) { described_class.new('harvard-g7064-s2-1834-k3', repository) }
+
+  describe '#create_search_params' do
+    it 'assembles the correct search params for finding descendant documents' do
+      expect(descendants.create_search_params).to eq(fq: "#{Settings.FIELDS.SOURCE}:nyu_2451_34636", fl: [Settings.FIELDS.TITLE.to_s, 'layer_slug_s'])
+    end
+  end
+
+  describe '#execute_query' do
+    it 'executes the query for finding descendants, return response' do
+      expect(descendants.execute_query).to include('responseHeader')
+    end
+  end
+
+  describe '#results' do
+    it 'produces a hash of results from the query' do
+      expect(descendants.results).to include('numFound')
+      expect(descendants.results).to include('docs')
+    end
+    it 'has non-zero numfound for a document with descendants' do
+      expect(descendants.results['numFound']).to be > 0
+    end
+    it 'has zero numfound for a document without descendants' do
+      expect(empty_descendants.results['numFound']).to eq(0)
+    end
+  end
+end

data/spec/lib/geoblacklight/relation/relation_response_spec.rb

@@ -0,0 +1,35 @@
+require 'spec_helper'
+
+describe Geoblacklight::Relation::RelationResponse do
+  let(:repository) { Blacklight::Solr::Repository.new(CatalogController.blacklight_config) }
+  let(:relation_resp) { described_class.new('nyu_2451_34502', repository) }
+  let(:empty_relation_resp) { described_class.new('harvard-g7064-s2-1834-k3', repository) }
+  describe '#initialize' do
+    it 'creates a RelationResponse' do
+      expect(relation_resp).to be_an described_class
+    end
+  end
+
+  describe '#ancestors' do
+    it 'returns a hash of ancestor documents' do
+      expect(relation_resp.ancestors).to include('numFound')
+      expect(relation_resp.ancestors).to include('docs')
+    end
+  end
+
+  describe '#descendants' do
+    it 'returns a hash of descendant documents' do
+      expect(relation_resp.ancestors).to include('numFound')
+      expect(relation_resp.ancestors).to include('docs')
+    end
+  end
+
+  describe '#empty?' do
+    it 'returns false if document has ancestors or descendants' do
+      expect(relation_resp.empty?).to be false
+    end
+    it 'returns true if document has neither ancestors nor descendants' do
+      expect(empty_relation_resp.empty?).to be true
+    end
+  end
+end

data/spec/test_app_templates/lib/generators/test_app_generator.rb

@@ -19,7 +19,7 @@ class TestAppGenerator < Rails::Generators::Base
   end
 
   def install_engine
-    generate 'geoblacklight:install'
+    generate 'geoblacklight:install', '-f'
   end
 
   def fixtures

data/spec/test_app_templates/solr_documents

@@ -1 +1 @@
-../fixtures/solr_documents
+spec/test_app_templates/../fixtures/solr_documents

data/template.rb

@@ -1,9 +1,9 @@
 gem 'blacklight', '>= 6.3'
-gem 'geoblacklight', '>= 1.1.2'
+gem 'geoblacklight', '>= 1.3'
 
 run 'bundle install'
 
 generate 'blacklight:install', '--devise'
-generate 'geoblacklight:install', '--solrwrapper'
+generate 'geoblacklight:install', '--solrwrapper', '-f'
 
 rake 'db:migrate'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: geoblacklight
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Mike Graves
@@ -11,7 +11,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-09-09 00:00:00.000000000 Z
+date: 2016-11-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -193,14 +193,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.10'
+        version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.10'
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: capybara
   requirement: !ruby/object:Gem::Requirement
@@ -299,6 +299,7 @@ files:
 - app/assets/javascripts/geoblacklight/modules/home.js
 - app/assets/javascripts/geoblacklight/modules/item.js
 - app/assets/javascripts/geoblacklight/modules/layer_opacity.js
+- app/assets/javascripts/geoblacklight/modules/relations.js
 - app/assets/javascripts/geoblacklight/modules/results.js
 - app/assets/javascripts/geoblacklight/modules/util.js
 - app/assets/javascripts/geoblacklight/viewers.js
@@ -329,6 +330,7 @@ files:
 - app/assets/stylesheets/geoblacklight/modules/twitter-typeahead.scss
 - app/assets/stylesheets/geoblacklight/modules/web_services.scss
 - app/controllers/download_controller.rb
+- app/controllers/relation_controller.rb
 - app/controllers/wms_controller.rb
 - app/helpers/blacklight_helper.rb
 - app/helpers/carto_helper.rb
@@ -353,6 +355,7 @@ files:
 - app/views/catalog/_icon_facet.html.erb
 - app/views/catalog/_index_split_default.html.erb
 - app/views/catalog/_metadata.html.erb
+- app/views/catalog/_relations_container.html.erb
 - app/views/catalog/_search_form_no_navbar.html.erb
 - app/views/catalog/_show_default.html.erb
 - app/views/catalog/_show_default_attribute_table.html.erb
@@ -369,6 +372,10 @@ files:
 - app/views/catalog/web_services.html.erb
 - app/views/catalog/web_services.js.erb
 - app/views/download/hgl.html.erb
+- app/views/relation/_ancestors.html.erb
+- app/views/relation/_descendants.html.erb
+- app/views/relation/index.html.erb
+- app/views/relation/index.json.jbuilder
 - app/views/shared/_header_navbar.html.erb
 - config/initializers/rails_config.rb
 - config/locales/geoblacklight.en.yml
@@ -396,6 +403,9 @@ files:
 - lib/geoblacklight/metadata.rb
 - lib/geoblacklight/reference.rb
 - lib/geoblacklight/references.rb
+- lib/geoblacklight/relation/ancestors.rb
+- lib/geoblacklight/relation/descendants.rb
+- lib/geoblacklight/relation/relation_response.rb
 - lib/geoblacklight/routes.rb
 - lib/geoblacklight/routes/downloadable.rb
 - lib/geoblacklight/routes/exportable.rb
@@ -425,6 +435,7 @@ files:
 - solr/conf/xslt/luke.xsl
 - spec/controllers/catalog_controller_spec.rb
 - spec/controllers/download_controller_spec.rb
+- spec/controllers/relation_controller_spec.rb
 - spec/controllers/wms_controller_spec.rb
 - spec/factories/user.rb
 - spec/features/bookmarks_spec.rb
@@ -441,6 +452,7 @@ files:
 - spec/features/layer_with_no_references_spec.rb
 - spec/features/linkified_attribute_table_spec.rb
 - spec/features/metadata_panel_spec.rb
+- spec/features/relations_spec.rb
 - spec/features/saved_searches_spec.rb
 - spec/features/search_bar_spec.rb
 - spec/features/show_page_metadata_spec.rb
@@ -450,6 +462,8 @@ files:
 - spec/fixtures/solr_documents/actual-point1.json
 - spec/fixtures/solr_documents/actual-polygon1.json
 - spec/fixtures/solr_documents/actual-raster1.json
+- spec/fixtures/solr_documents/baruch_ancestor1.json
+- spec/fixtures/solr_documents/baruch_ancestor2.json
 - spec/fixtures/solr_documents/baruch_documentation_download.json
 - spec/fixtures/solr_documents/esri-dynamic-layer-all-layers.json
 - spec/fixtures/solr_documents/esri-dynamic-layer-single-layer.json
@@ -481,6 +495,9 @@ files:
 - spec/lib/geoblacklight/metadata_spec.rb
 - spec/lib/geoblacklight/reference_spec.rb
 - spec/lib/geoblacklight/references_spec.rb
+- spec/lib/geoblacklight/relation/ancestors_spec.rb
+- spec/lib/geoblacklight/relation/descendants_spec.rb
+- spec/lib/geoblacklight/relation/relation_response_spec.rb
 - spec/lib/geoblacklight/view_helper_override_spec.rb
 - spec/lib/geoblacklight/wms_layer/feature_info_response_spec.rb
 - spec/lib/geoblacklight/wms_layer_spec.rb
@@ -524,13 +541,14 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: 2.5.2
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 2.6.7
 signing_key: 
 specification_version: 4
 summary: A discovery platform for geospatial holdings
 test_files:
 - spec/controllers/catalog_controller_spec.rb
 - spec/controllers/download_controller_spec.rb
+- spec/controllers/relation_controller_spec.rb
 - spec/controllers/wms_controller_spec.rb
 - spec/factories/user.rb
 - spec/features/bookmarks_spec.rb
@@ -547,6 +565,7 @@ test_files:
 - spec/features/layer_with_no_references_spec.rb
 - spec/features/linkified_attribute_table_spec.rb
 - spec/features/metadata_panel_spec.rb
+- spec/features/relations_spec.rb
 - spec/features/saved_searches_spec.rb
 - spec/features/search_bar_spec.rb
 - spec/features/show_page_metadata_spec.rb
@@ -556,6 +575,8 @@ test_files:
 - spec/fixtures/solr_documents/actual-point1.json
 - spec/fixtures/solr_documents/actual-polygon1.json
 - spec/fixtures/solr_documents/actual-raster1.json
+- spec/fixtures/solr_documents/baruch_ancestor1.json
+- spec/fixtures/solr_documents/baruch_ancestor2.json
 - spec/fixtures/solr_documents/baruch_documentation_download.json
 - spec/fixtures/solr_documents/esri-dynamic-layer-all-layers.json
 - spec/fixtures/solr_documents/esri-dynamic-layer-single-layer.json
@@ -587,6 +608,9 @@ test_files:
 - spec/lib/geoblacklight/metadata_spec.rb
 - spec/lib/geoblacklight/reference_spec.rb
 - spec/lib/geoblacklight/references_spec.rb
+- spec/lib/geoblacklight/relation/ancestors_spec.rb
+- spec/lib/geoblacklight/relation/descendants_spec.rb
+- spec/lib/geoblacklight/relation/relation_response_spec.rb
 - spec/lib/geoblacklight/view_helper_override_spec.rb
 - spec/lib/geoblacklight/wms_layer/feature_info_response_spec.rb
 - spec/lib/geoblacklight/wms_layer_spec.rb