spatial_features 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c42265b78f3d41490bf8e89691d57f1cab48d9b2
+  data.tar.gz: bdc3542a36c9584b6f18bceddda2b7e175997a2e
+SHA512:
+  metadata.gz: a17091a2662a74ac313c47059ac13f63a220a45fbce3c11aedffc7ccc6c74c8425b07aec89ccc0a1b00772c5405bcaa5432ac39bd20aa8398d93ac405d7407eb
+  data.tar.gz: 7a15bb57318905523faa487ff24ac34b48a331e893d4088dfa77aff0c8dda933604599428f2030263d9b67bf287cfd4e316486b007c893978c51ab9cd263ea0d

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2014 YOURNAME
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,3 @@
+= Spatial Features
+
+Adds spatial methods to a model.

data/Rakefile

@@ -0,0 +1,19 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+Bundler::GemHelper.install_tasks
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+
+task default: :test

data/lib/spatial_features/caching.rb

@@ -0,0 +1,66 @@
+module SpatialFeatures
+  mattr_accessor :default_cache_buffer_in_meters
+  self.default_cache_buffer_in_meters = 100
+
+  # Create or update the spatial cache of a spatial class in relation to another
+  # NOTE: Arguments are order independent, so their names do not reflect the _a _b
+  # naming scheme used in other cache methods
+  def self.cache_proximity(klass, clazz)
+    clear_cache(klass, clazz)
+
+    klass.find_each do |record|
+      create_spatial_proximities(record, clazz)
+      create_spatial_cache(record, clazz)
+    end
+
+    clazz.find_each do |record|
+      create_spatial_cache(record, klass)
+    end
+  end
+
+  # Create or update the spatial cache of a single record in relation to another spatial class
+  def self.cache_record_proximity(record, klass)
+    clear_record_cache(record, klass)
+    create_spatial_proximities(record, klass)
+    create_spatial_cache(record, klass)
+  end
+
+  # Delete all cache entries relating klass to clazz
+  def self.clear_cache(klass = nil, clazz = nil)
+    if klass.blank? && clazz.blank?
+      SpatialCache.delete_all
+      SpatialProximity.delete_all
+    else
+      SpatialCache.where(:spatial_model_type => klass, :intersection_model_type => clazz).delete_all
+      SpatialCache.where(:spatial_model_type => clazz, :intersection_model_type => klass).delete_all
+      SpatialProximity.where(:model_a_type => klass, :model_b_type => clazz).delete_all
+      SpatialProximity.where(:model_a_type => clazz, :model_b_type => klass).delete_all
+    end
+  end
+
+  def self.clear_record_cache(record, klass)
+    record.spatial_cache.where(:intersection_model_type => klass.name).delete_all
+    SpatialProximity.where(:model_a_type => record.class.name, :model_a_id => record.id, :model_b_type => klass.name).delete_all
+    SpatialProximity.where(:model_b_type => record.class.name, :model_b_id => record.id, :model_a_type => klass.name).delete_all
+  end
+
+  def self.create_spatial_proximities(record, klass)
+    record_is_a = record.class.name < klass.name
+
+    scope = klass.within_buffer(record, default_cache_buffer_in_meters, :intersection_area => true, :distance => true, :cache => false)
+    scope.find_each do |klass_record|
+      SpatialProximity.create!(
+        :model_a => record_is_a ? record : klass_record,
+        :model_b => record_is_a ? klass_record : record,
+        :distance_in_meters => klass_record.distance_in_meters,
+        :intersection_area_in_square_meters => klass_record.intersection_area_in_square_meters)
+    end
+  end
+
+  def self.create_spatial_cache(model, klass)
+    SpatialCache.create!(
+      :spatial_model => model,
+      :intersection_model_type => klass.name,
+      :cache_distance => default_cache_buffer_in_meters)
+  end
+end

data/lib/spatial_features/controller_helpers/spatial_extensions.rb

@@ -0,0 +1,35 @@
+module SpatialExtensions
+  private
+
+  def abstract_proximity_action(scope, target, distance, &block)
+    @nearby_records = scope_for_search(scope).within_buffer(target, distance, :distance => true, :intersection_area => true).order('distance_in_meters ASC, intersection_area_in_square_meters DESC, id ASC')
+    @target = target
+
+    yield if block_given?
+
+    respond_to do |format|
+      format.html { render :template => 'shared/spatial/feature_proximity', :layout => false }
+      format.kml { render :template => 'shared/spatial/feature_proximity' }
+    end
+  end
+
+  def abstract_venn_polygons_action(scope, target, &block)
+    @venn_polygons = SpatialFeatures.venn_polygons(scope_for_search(scope).intersecting(target), target.class.where(:id => target), :simplified => false)
+    @klass = klass_for_search(scope)
+    @target = target
+
+    yield if block_given?
+
+    respond_to do |format|
+      format.kml { render :template => 'shared/spatial/feature_venn_polygons' }
+    end
+  end
+
+  def klass_for_search(scope_or_class)
+    scope_or_class.is_a?(ActiveRecord::Relation) ? scope_or_class.klass : scope_or_class
+  end
+
+  def scope_for_search(scope)
+    params.key?(:ids) ? scope.where(:id => params[:ids]) : scope
+  end
+end

data/lib/spatial_features/has_spatial_features.rb

@@ -0,0 +1,158 @@
+module SpatialFeatures
+  module ActMethod
+    def has_spatial_features(options = {})
+      has_many :features, :as => :spatial_model, :dependent => :delete_all
+      scope :with_features, lambda { where(:id => Feature.select(:spatial_model_id).where(:spatial_model_type => name)) }
+      scope :without_features, lambda { where.not(:id => Feature.select(:spatial_model_id).where(:spatial_model_type => name)) }
+
+      has_many :spatial_cache, :as => :spatial_model
+
+      extend SpatialFeatures::ClassMethods
+      include SpatialFeatures::InstanceMethods
+    end      
+  end
+
+  module ClassMethods
+  	# Add methods to generate cache keys for a record or all records of this class
+		# NOTE: features are never updated, only deleted and created, therefore we can
+		# tell if they have changed by finding the maximum id and count instead of needing timestamps
+		def features_cache_key
+		  "#{name}/#{Feature.where(:spatial_model_type => self).maximum(:id)}-#{Feature.where(:spatial_model_type => self).count}"
+		end
+
+		def intersecting(other, options = {})
+		  within_buffer(other, 0, options)
+		end
+
+		def within_buffer(other, buffer_in_meters = 0, options = {})
+		  raise "Can't intersect with #{other} because it does not implement has_features" unless other.has_spatial_features?
+
+		  if other.spatial_cache_for?(self, buffer_in_meters) && options[:cache] != false # CACHED
+		    scope = cached_spatial_join(other)
+		      .select("#{table_name}.*, spatial_proximities.distance_in_meters, spatial_proximities.intersection_area_in_square_meters")
+
+		    scope = scope.where("spatial_proximities.distance_in_meters <= ?", buffer_in_meters) if buffer_in_meters
+		  else # NON-CACHED
+		    scope = joins_features_for(other)
+		      .select("#{table_name}.*")
+		      .group("#{table_name}.#{primary_key}")
+
+		    scope = scope.where('ST_DWithin(features_for.geog_lowres, features_for_other.geog_lowres, ?)', buffer_in_meters) if buffer_in_meters
+		    scope = scope.select("MIN(ST_Distance(features_for.geog_lowres, features_for_other.geog_lowres)) AS distance_in_meters") if options[:distance]
+		    scope = scope.select("SUM(ST_Area(ST_Intersection(features_for.geog_lowres, features_for_other.geog_lowres))) AS intersection_area_in_square_meters") if options[:intersection_area]
+		  end
+
+		  return scope
+		end
+
+		def polygons
+		  Feature.polygons.where(:spatial_model_type => self.class)
+		end
+
+		def lines
+		  Feature.lines.where(:spatial_model_type => self.class)
+		end
+
+		def points
+		  Feature.points.where(:spatial_model_type => self.class)
+		end
+
+		def cached_spatial_join(other)
+		  raise "Cannot use cached spatial join for the same class" if other.class.name == self.name
+
+		  other_column = other.class.name < self.name ? :model_a : :model_b
+		  self_column = other_column == :model_a ? :model_b : :model_a
+
+		  joins("INNER JOIN spatial_proximities ON spatial_proximities.#{self_column}_type = '#{self}' AND spatial_proximities.#{self_column}_id = #{table_name}.id AND spatial_proximities.#{other_column}_type = '#{other.class}' AND spatial_proximities.#{other_column}_id = '#{other.id}'")
+		end
+
+		def joins_features_for(other, table_alias = 'features_for')
+		  joins_features(table_alias)
+		  .joins(%Q(INNER JOIN features "#{table_alias}_other" ON "#{table_alias}_other".spatial_model_type = '#{other.class.name}' AND "#{table_alias}_other".spatial_model_id = #{other.id}))
+		end
+
+		def joins_features(table_alias = 'features_for')
+		  joins(%Q(INNER JOIN features "#{table_alias}" ON "#{table_alias}".spatial_model_type = '#{name}' AND "#{table_alias}".spatial_model_id = #{table_name}.id))
+		end
+  end
+
+  module InstanceMethods
+    def has_spatial_features?
+      true
+    end
+
+    def features_cache_key
+		  "#{self.class.name}/#{self.id}-#{features.maximum(:id)}-#{features.size}"
+		end
+
+		def polygons?
+		  !features.polygons.empty?
+		end
+
+		def lines?
+		  !features.lines.empty?
+		end
+
+		def points?
+		  !features.points.empty?
+		end
+
+		def features?
+		  features.present?
+		end
+
+		# Returns true if the model stores a hash of the features so we don't need to process the features if they haven't changed
+		def has_spatial_features_hash?
+		  respond_to?(:features_hash)
+		end
+
+		def intersects?(other)
+		  self.class.intersecting(other).exists?(self)
+		end
+
+		def total_intersection_area_in_square_meters(klass, options = {})
+		  self.class
+		    .select(%Q(ST_Area(ST_Intersection(ST_Union(features_for.geog_lowres::geometry), ST_Union(features_for_other.geog_lowres::geometry))::geography) AS intersection_area_in_square_meters))
+		    .joins(%Q(INNER JOIN features "features_for" ON "features_for".spatial_model_type = '#{self.class}' AND "features_for".spatial_model_id = #{self.class.table_name}.id))
+		    .joins(%Q(INNER JOIN features "features_for_other" ON "features_for_other".spatial_model_type = '#{klass}'))
+		    .where(:id => self.id)
+		    .where('ST_DWithin(features_for.geog_lowres, features_for_other.geog_lowres, 0)')
+		    .group("#{self.class.table_name}.id")
+		    .first
+		    .try(:intersection_area_in_square_meters) || 0
+		end
+
+		def total_intersection_area_in_hectares(klass)
+		  Formatters::HECTARES.call(total_intersection_area_in_square_meters(klass))
+		end
+
+		def total_intersection_area_percentage(klass)
+		  return 0.0 unless features_area_in_square_meters > 0
+
+		  ((total_intersection_area_in_square_meters(klass) / features_area_in_square_meters) * 100).round(1)
+		end
+
+		def features_area_in_square_meters
+		  @features_area_in_square_meters ||= features.sum('ST_Area(features.geog_lowres)')
+		end
+
+		def features_area_in_hectares
+		  Formatters::HECTARES.call(features_area_in_square_meters)
+		end
+
+		def spatial_cache_for(klass)
+		  spatial_cache.where(:intersection_model_type => klass).first
+		end
+
+		def spatial_cache_for?(klass, buffer_in_meters)
+		  if cache = spatial_cache_for(klass)
+		    return cache.cache_distance.nil? if buffer_in_meters.nil? # cache must be total if no buffer_in_meters
+		    return true if cache.cache_distance.nil? # always good if cache is total
+
+		    return buffer_in_meters <= cache.cache_distance
+		  else
+		    return false
+		  end
+		end
+  end
+end

data/lib/spatial_features/import/arcgis_kmz_features.rb

@@ -0,0 +1,104 @@
+module ArcGISKmzFeatures
+  require 'open-uri'
+  require 'digest/md5'
+
+  def update_features!
+    @feature_error_messages = []
+    kml_array = []
+    cache_kml = ''
+
+    Array(arcgis_kmz_url).each do |url|
+      kml_array << open_kmz_url(url)
+      cache_kml << kml_array.last.to_s
+    end
+
+    if has_spatial_features_hash?
+      new_features_hash = Digest::MD5.hexdigest(cache_kml) if cache_kml.present?
+
+      if new_features_hash != self.features_hash
+        replace_features(kml_array)
+        update_attributes(:features_hash => new_features_hash)
+      else
+        return false
+      end
+    else
+      replace_features(kml_array)
+    end
+
+    return true
+  end
+
+  private
+
+  def replace_features(kml_array)
+    new_features = []
+    kml_array.each {|kml| new_features.concat build_features(kml) }
+
+    ActiveRecord::Base.transaction do
+      self.features.destroy_all
+      new_features.each(&:save)
+
+      @feature_error_messages.concat new_features.collect {|feature| "Feature #{feature.name}: #{feature.errors.full_messages.to_sentence}" if feature.errors.present? }.compact.flatten
+      if @feature_error_messages.present?
+        raise UpdateError, "Error updating #{self.class} #{self.id}. #{@feature_error_messages.to_sentence}"
+      end
+    end
+  end
+
+  def build_features(kml)
+    new_type_features = []
+
+    extract_kml_features(kml) do |feature_type, feature, name, metadata|
+      begin
+        new_type_features << build_feature(feature_type, name, metadata, build_geom(feature))
+      rescue => e
+        @feature_error_messages << e.message
+      end
+    end
+
+    return new_type_features
+  end
+
+  # Use ST_Force_2D to discard z-coordinates that cause failures later in the process
+  def build_geom(feature)
+    if make_valid?
+      geom = ActiveRecord::Base.connection.select_value("SELECT ST_CollectionExtract(ST_MakeValid(ST_Force_2D(ST_GeomFromKML('#{feature}'))),3 )")
+    else
+      geom = ActiveRecord::Base.connection.select_value("SELECT ST_Force_2D(ST_GeomFromKML('#{feature}'))")
+    end
+  end
+
+  def extract_kml_features(kml, &block)
+    Nokogiri::XML(kml).css('Placemark').each do |placemark|
+      name = placemark.css('name').text
+      metadata = Hash[Nokogiri::XML(placemark.css('description').text).css('td').collect(&:text).each_slice(2).to_a]
+
+      {'Polygon' => 'POLYGON', 'LineString' => 'LINE', 'Point' => 'POINT'}.each do |kml_type, sql_type|
+        placemark.css(kml_type).each do |feature|
+          yield sql_type, feature, name, metadata
+        end
+      end
+    end
+  end
+
+  def build_feature(feature_type, name, metadata, geom)
+    Feature.new(spatial_model: self, name: name, metadata: metadata, feature_type: feature_type, geog: geom)
+  end
+
+  def open_kmz_url(url)
+    Zip::InputStream.open(open(url)) do |io|
+      while (entry = io.get_next_entry)
+        return io.read if entry.name.downcase == 'doc.kml'
+      end
+    end
+
+    return nil
+  end
+
+  # Can be overridden to use PostGIS to force geometry to be valid
+  def make_valid?
+    false
+  end
+
+  class UpdateError < StandardError; end
+end

data/lib/spatial_features/models/feature.rb

@@ -0,0 +1,59 @@
+class Feature < ActiveRecord::Base
+  belongs_to :spatial_model, :polymorphic => :true
+
+  self.rgeo_factory_generator = RGeo::Geos.factory_generator
+
+  before_validation :sanitize_feature_type
+  validates_presence_of :geog
+  validate :geometry_is_valid
+  validates_inclusion_of :feature_type, :in => ['polygon', 'point', 'line']
+  after_save :cache_derivatives
+
+  store :metadata
+
+  def self.polygons
+    where(:feature_type => 'polygon')
+  end
+
+  def self.lines
+    where(:feature_type => 'line')
+  end
+
+  def self.points
+    where(:feature_type => 'point')
+  end
+
+  def self.for_kml(options = {})
+    if options[:simplified]
+      select("features.name, features.kml, features.metadata").where("features.name IS NULL OR features.name NOT IN ('s', 't')")
+    else
+      select("features.name, ST_AsKML(features.geog, 6) AS kml, features.metadata")
+    end
+  end
+
+  def self.invalid
+    select('features.*, ST_IsValidReason(geog::geometry) AS invalid_geometry_message').where.not('ST_IsValid(geog::geometry)')
+  end
+
+  def envelope(buffer_in_meters = 0)
+    self.class.select("ST_Envelope(ST_Buffer(features.geog, #{buffer_in_meters})::geometry) AS result").where(:id => id).first.result.exterior_ring.points.values_at(0,2)
+  end
+
+  private
+
+  def cache_derivatives
+    self.class.connection.execute "UPDATE features SET geog_lowres = ST_SimplifyPreserveTopology(geog::geometry, 0.0001) WHERE id = #{self.id}"
+    self.class.connection.execute "UPDATE features SET kml = ST_AsKML(geog_lowres::geometry, 5) WHERE id = #{self.id}"
+  end
+
+  def geometry_is_valid
+    if geog?
+      instance = self.class.unscoped.invalid.from("(SELECT ST_GeometryFromText('#{self.geog}') AS geog) #{self.class.table_name}").to_a.first
+      errors.add :geog, instance.invalid_geometry_message if instance
+    end
+  end
+
+  def sanitize_feature_type
+    self.feature_type = self.feature_type.to_s.strip.downcase
+  end
+end

data/lib/spatial_features/models/spatial_cache.rb

@@ -0,0 +1,3 @@
+class SpatialCache < ActiveRecord::Base
+  belongs_to :spatial_model, :polymorphic => true
+end

data/lib/spatial_features/models/spatial_proximity.rb

@@ -0,0 +1,4 @@
+class SpatialProximity < ActiveRecord::Base
+  belongs_to :model_a, :polymorphic => true
+  belongs_to :model_b, :polymorphic => true
+end

data/lib/spatial_features/venn_polygons.rb

@@ -0,0 +1,56 @@
+module SpatialFeatures
+  # Splits overlapping features into separate polygons at their areas of overlap, and returns an array of objects
+  # with kml for the overlapping area and a list of the record ids whose kml overlapped within that area
+  def self.venn_polygons(*scopes)
+    options = scopes.extract_options!
+    column = options[:simplified] ? 'geog_lowres' : 'geog'
+    scope = scopes.collect do |scope|
+      scope.klass.from(scope, scope.klass.table_name).joins(:features).where('features.feature_type = ?', 'polygon').select("features.#{column}::geometry AS the_geom").to_sql
+    end.join(' UNION ')
+
+    sql = "
+      SELECT scope.id, scope.type, ST_AsKML(geom) AS kml FROM ST_Dump((
+        SELECT ST_Polygonize(the_geom) AS the_geom FROM (
+
+          SELECT ST_Union(the_geom) AS the_geom FROM (
+
+              -- Handle Multigeometry
+              SELECT ST_ExteriorRing((ST_DumpRings(the_geom)).geom) AS the_geom
+              FROM (#{scope}) AS scope
+
+          ) AS exterior_lines
+
+        ) AS noded_lines
+        WHERE NOT ST_IsEmpty(the_geom) -- Ignore empty geometry from ST_Union if there are no polygons because polygonize will explode
+
+      )) AS venn_polygons
+    "
+
+    # Join with the original polygons so we can determine which original polygons each venn polygon came from
+    scope = scopes.collect do |scope|
+      scope.klass.from(scope, scope.klass.table_name).joins(:features).where('features.feature_type = ?', 'polygon').select("#{scope.klass.table_name}.id, features.spatial_model_type AS type, features.#{column}").to_sql
+    end.join(' UNION ')
+    sql <<
+      "INNER JOIN (#{scope}) AS scope
+        ON ST_Covers(scope.#{column}, ST_PointOnSurface(venn_polygons.geom)) -- Shrink the venn polygons so they don't share edges with the original polygons which could cause varying results due to tiny inaccuracy"
+
+    # Eager load the records for each venn polygon
+    eager_load_hash = Hash.new {|hash, key| hash[key] = []}
+    polygons = ActiveRecord::Base.connection.select_all(sql)
+    polygons.group_by{|row| row['type']}.each do |record_type, rows|
+      rows.each do |row|
+        eager_load_hash[record_type] << row['id']
+      end
+    end
+    eager_load_hash.each do |record_type, ids|
+      eager_load_hash[record_type] = record_type.constantize.find(ids)
+    end
+
+    # Instantiate objects to hold the kml and records for each venn polygon
+    polygons.group_by{|row| row['kml']}.collect do |kml, rows|
+      # Uniq on row id in case a single record had self intersecting multi geometry, which would cause it to appear duplicated on a single venn polygon
+      records = rows.uniq{|row| row.values_at('id', 'type') }.collect{|row| eager_load_hash.fetch(row['type']).detect{|record| record.id == row['id'].to_i } }
+      OpenStruct.new(:kml => kml, :records => records)
+    end
+  end
+end

data/lib/spatial_features/version.rb

@@ -0,0 +1,3 @@
+module SpatialFeatures
+  VERSION = "0.0.1"
+end

data/lib/spatial_features.rb

@@ -0,0 +1,21 @@
+# GEMS
+require "activerecord-postgis-adapter"
+
+# LIB
+require 'spatial_features/caching'
+require 'spatial_features/venn_polygons'
+require 'spatial_features/has_spatial_features'
+
+require 'spatial_features/import/arcgis_kmz_features'
+
+require 'spatial_features/controller_helpers/spatial_extensions'
+
+require 'spatial_features/models/feature'
+require 'spatial_features/models/spatial_cache'
+require 'spatial_features/models/spatial_proximity'
+
+module SpatialFeatures
+end
+
+# Load the act method
+ActiveRecord::Base.send :extend, SpatialFeatures::ActMethod

data/lib/tasks/spatial_features_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :spatial_features do
+#   # Task goes here
+# end

data/test/dummy/README.rdoc

@@ -0,0 +1,28 @@
+== README
+
+This README would normally document whatever steps are necessary to get the
+application up and running.
+
+Things you may want to cover:
+
+* Ruby version
+
+* System dependencies
+
+* Configuration
+
+* Database creation
+
+* Database initialization
+
+* How to run the test suite
+
+* Services (job queues, cache servers, search engines, etc.)
+
+* Deployment instructions
+
+* ...
+
+
+Please feel free to use a different markup language if you do not plan to run
+<tt>rake doc:app</tt>.

data/test/dummy/Rakefile

@@ -0,0 +1,6 @@
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
+
+require File.expand_path('../config/application', __FILE__)
+
+Rails.application.load_tasks

data/test/dummy/app/assets/javascripts/application.js

@@ -0,0 +1,13 @@
+// This is a manifest file that'll be compiled into application.js, which will include all the files
+// listed below.
+//
+// Any JavaScript/Coffee file within this directory, lib/assets/javascripts, vendor/assets/javascripts,
+// or vendor/assets/javascripts of plugins, if any, can be referenced here using a relative path.
+//
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
+// compiled file.
+//
+// Read Sprockets README (https://github.com/sstephenson/sprockets#sprockets-directives) for details
+// about supported directives.
+//
+//= require_tree .

data/test/dummy/app/assets/stylesheets/application.css

@@ -0,0 +1,15 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or vendor/assets/stylesheets of plugins, if any, can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any styles
+ * defined in the other CSS/SCSS files in this directory. It is generally better to create a new
+ * file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */

data/test/dummy/app/controllers/application_controller.rb

@@ -0,0 +1,5 @@
+class ApplicationController < ActionController::Base
+  # Prevent CSRF attacks by raising an exception.
+  # For APIs, you may want to use :null_session instead.
+  protect_from_forgery with: :exception
+end

data/test/dummy/app/helpers/application_helper.rb

@@ -0,0 +1,2 @@
+module ApplicationHelper
+end

data/test/dummy/app/views/layouts/application.html.erb

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Dummy</title>
+  <%= stylesheet_link_tag    'application', media: 'all', 'data-turbolinks-track' => true %>
+  <%= javascript_include_tag 'application', 'data-turbolinks-track' => true %>
+  <%= csrf_meta_tags %>
+</head>
+<body>
+
+<%= yield %>
+
+</body>
+</html>