ajax_validator 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7ea11a9a26ae42ec77a8b1513400c90c09299e53
+  data.tar.gz: 39a0f8bb6725c27919e8eba0534585c816bddc1e
+SHA512:
+  metadata.gz: 6bf4253121c5c57cd0590f7f7a9c3d6c767195a1831523d9e7615224d456e186c768ff9063e1396e3d93f0069be3b4cb4c156d8b238ab7eb58dec90f43661349
+  data.tar.gz: dc01803395572d253fd2e0d86b52fd38f59d5530759c84222271e78d520bccf40b102d1f976f2a968774f45d89cc0b6235828be57788a7214c691109d5b415e1

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2016 efigence
+
+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.md

@@ -0,0 +1,87 @@
+# Ajax Validator [![Build Status](https://travis-ci.org/efigence/ajax_validator.svg?branch=master)](http://travis-ci.org/efigence/ajax_validator)
+
+### Ajax Live Form Validation Rails Engine
+
+## How to install
+
+1. Add to `Gemfile`
+
+        gem 'ajax_validator', path: 'vendor/engines/ajax_validator'
+2. Bundle
+
+        bundle install
+3. Create file `config/initializers/ajax_validator.rb` and specify validatable models
+
+        AjaxValidator::Engine.setup do |config|
+          config.ajax_validator_engine = {
+            # if form object is used, both classes must be put here
+            whitelist_models: ['some_klass', 'some_module/some_klass']
+          }
+        end
+4. Copy migration (currently, not needed)
+
+        bundle exec rake ajax_validator:install:migrations
+5. Run migration (currently, not needed)
+
+        bundle exec rake db:migrate SCOPE=ajax_validator
+6. Run seeds (currently, not needed)
+
+        bundle exec rake ajax_validator:db:seed
+7. Add to `config/routes.rb`
+
+        mount AjaxValidator::Engine, at: '/ajax_validator'
+
+## How to use helpers
+
+Include the needed javascript file in your application.js or application.js.coffee
+
+        Javascript
+        //= require ajax_validator/application
+
+        or CoffeeScript
+        #= require ajax_validator/application
+
+        Script will add class 'has-error' or 'has-success' to the field wrapping div, based on the result.
+
+        Add these attributes on text input field:
+            class: 'ajax_validator__field'
+            data-form-object='validations/signup_form_company_name' [Optional, leave empty string '' validate on model directly]
+            data-resource-model='company'
+            data-resource-attr-name='name'
+            data-ignore-resource-attr-value='false' [Optional, set to 'true' when attribute is assembled from additional params instead]
+            data-resource-instance-additional-params='{"something": true, "something_else": ""}' [Optional]
+
+        Example on Bootstrap:
+
+        ERB:
+        <div class="input-group">
+            <input class='form-control ajax_validator__field' data-form-object='validations/signup_form_company_name' data-resource-model='company' data-resource-attr-name='name' type='text' name='signup_form[company]' id='signup_form_company'>
+        </div>
+
+        or HAML:
+        .input-group
+            = f.text_field :company, class: 'form-control ajax_validator__field', data: {form_object: 'validations/signup_form_company_name', resource_model: 'company', resource_attr_name: 'name'}
+
+### How to add a new gem to the engine
+- Add a gem to `Gemfile`
+- Run: `bundle`
+- Copy over to multiple gemfiles: `bundle exec appraisal install`
+
+### How to test
+    cd vendor/engines/ajax_validator/
+    export DATABASE_URL='postgres://localhost:5432' AJAX_VALIDATOR_DATABASE_USERNAME=postgres AJAX_VALIDATOR_DATABASE_PASSWORD=p
+
+    bundle exec appraisal rails-4.1 rake db:create db:migrate db:seed
+---
+- Optional:
+
+        bundle exec appraisal rails-4.1 rake db:schema:load RAILS_ENV=test
+---
+
+    bundle exec appraisal rails-4.1 rake spec
+    bundle exec appraisal rails-4.1 rake app:cucumber
+
+## How to develop
+    bundle exec rails g scaffold Post name:string --integration_tool=rspec --helper=false --assets=false
+    bundle exec rails g cucumber_scaffold:feature Post name:string
+    bundle exec rails db:migrate

data/Rakefile

@@ -0,0 +1,36 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+APP_RAKEFILE = File.expand_path("../spec/dummy/Rakefile", __FILE__)
+load 'rails/tasks/engine.rake'
+
+#load 'rails/tasks/statistics.rake'
+
+Bundler::GemHelper.install_tasks
+
+Dir[File.join(File.dirname(__FILE__), 'tasks/**/*.rake')].each {|f| load f }
+require 'rspec/core'
+require 'rspec/core/rake_task'
+require 'appraisal'
+
+task :default => :spec
+
+# RSpec::Core::RakeTask.new(:spec)
+RSpec::Core::RakeTask.new(:spec => 'app:db:test:prepare')
+
+desc 'Default'
+task :default do
+  if ENV['BUNDLE_GEMFILE'] =~ /gemfiles/
+    #Rake::Task['app:db:test:prepare'].invoke
+    Rake::Task['spec'].invoke
+  else
+    Rake::Task['appraise'].invoke
+  end
+end
+
+task :appraise do
+  exec 'appraisal install && appraisal rake'
+end

data/app/assets/javascripts/ajax_validator/ajax_validator.js.coffee

@@ -0,0 +1,46 @@
+window.ajax_validator_timeout = undefined
+
+$(document).on 'ready', (_event) ->
+  $('form').on 'keydown', '.ajax_validator__field', (e) ->
+
+    form_object = $(@).data('form-object')
+    resource_model = $(@).data('resource-model')
+    resource_attr_name = $(@).data('resource-attr-name')
+    ignore_resource_attr_value = $(@).data('ignore-resource-attr-value')
+    resource_instance_additional_params = $(@).data('resource-instance-additional-params')
+
+    queue_id = form_object + '-' + resource_model + resource_attr_name
+
+    $(document).queue queue_id, (next) =>
+
+      parent_div = $(@).parents('div').eq(0)
+      resource_attr_value = $(@).val()
+
+      $.ajax
+        url: "/ajax_validator/validators"
+        type: "POST"
+        dataType: "json"
+        data:
+          'validator':
+            'form_object': form_object
+            'resource_model': resource_model
+            'resource_attr_name': resource_attr_name
+            'resource_attr_value': resource_attr_value
+            'ignore_resource_attr_value': ignore_resource_attr_value
+            'resource_instance_additional_params': resource_instance_additional_params
+        success: (returnData) ->
+          if parent_div
+            if returnData['errors'].length > 0
+              $(parent_div).removeClass("has-error has-success").addClass("has-error")
+            else
+              $(parent_div).removeClass("has-error has-success").addClass("has-success")
+          else
+            $('body').html(JSON.stringify returnData)
+        error: (e) ->
+          # console.log(JSON.stringify e)
+
+    clearTimeout(ajax_validator_timeout);
+
+    window.ajax_validator_timeout = setTimeout((->
+      $(document).dequeue queue_id
+    ), 1000)

data/app/assets/javascripts/ajax_validator/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 any plugin's vendor/assets/javascripts directory 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/rails/sprockets#sprockets-directives) for details
+// about supported directives.
+//
+//= require_tree .

data/app/assets/stylesheets/ajax_validator/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 any plugin's vendor/assets/stylesheets directory 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/app/controllers/ajax_validator/application_controller.rb

@@ -0,0 +1,4 @@
+module AjaxValidator
+  class ApplicationController < ActionController::Base
+  end
+end

data/app/controllers/ajax_validator/validators_controller.rb

@@ -0,0 +1,68 @@
+require_dependency 'ajax_validator/application_controller'
+
+module AjaxValidator
+  class ValidatorsController < ApplicationController
+    skip_before_action :verify_authenticity_token, only: [:create]
+
+    # POST /validators
+    #
+    # {
+    #     'validator': {
+    #         'form_object': 'validations/signup_form_company_name',
+    #         'resource_model': 'company'
+    #         'resource_attr_name': 'name',
+    #         'resource_attr_value': 'Efigence'
+    #     }
+    # }
+    #
+    # or:
+    #
+    # {
+    #     'validator': {
+    #         'form_object': '',
+    #         'resource_model': 'company'
+    #         'resource_attr_name': 'name',
+    #         'resource_attr_value': 'Efigence'
+    #     }
+    # }
+    #
+    # Response (jsonapi.org format)
+    #
+    # on success:
+    #
+    # {
+    #   'errors': []
+    # }
+    #
+    # on failure:
+    #
+    # {
+    #   'errors': [
+    #     {
+    #       'name': [
+    #         'has already been taken'
+    #       ]
+    #     }
+    #   ]
+    # }
+    def create
+      validated = Validator.new(validator_params).validate
+      response = { 'errors' => validated.errors.messages.stringify_keys.map{|i| {i[0] => i[1]}} }
+      render json: response.to_json
+    end
+
+    private
+
+    # Only allow a trusted parameter 'white list' through.
+    def validator_params
+      wildcard = params.try(:[], :validator).try(:[], :resource_instance_additional_params).try(:keys)
+      params.require(:validator).
+      permit(:form_object,
+             :resource_model,
+             :resource_attr_name,
+             :resource_attr_value,
+             :ignore_resource_attr_value,
+             :resource_instance_additional_params => wildcard)
+    end
+  end
+end

data/app/helpers/ajax_validator/application_helper.rb

@@ -0,0 +1,4 @@
+module AjaxValidator
+  module ApplicationHelper
+  end
+end

data/app/models/ajax_validator/concerns/validation.rb

@@ -0,0 +1,21 @@
+module AjaxValidator
+  module Concerns
+    module Validation
+      extend ActiveSupport::Concern
+      included do
+        private
+        def ajax_validator_valid_attribute?(resource_attr_name, resource_attr_value, model_instance = self)
+          model_instance.class.validators_on(resource_attr_name.to_sym).each do |validator|
+            if validator.options[:if]
+              next unless !!model_instance.send(validator.options[:if])
+            end
+            if validator.options[:unless]
+              next if !!model_instance.send(validator.options[:unless])
+            end
+            validator.validate_each(model_instance, resource_attr_name.to_sym, resource_attr_value)
+          end
+        end
+      end
+    end
+  end
+end

data/app/models/ajax_validator/validator.rb

@@ -0,0 +1,128 @@
+# Use with form object that responds to `validate` method,
+# e.g. use Reform or Virtus with ActiveModel::Validations
+#
+# Open the console and try:
+#
+#   validator_params = { form_object: 'validations/signup_form_company_name',
+#                        resource_model: 'company',
+#                        resource_attr_name: 'name',
+#                        resource_attr_value: 'Efigence' }
+#
+# One can use the engine with any ActiveModel::Model object with ActiveModel::Validations
+# included. For performance, even if the model is clobbered with validations, only validations
+# on the specified field one will be fired. Examples:
+#
+#   validator_params = { form_object: '',
+#                        resource_model: 'company',
+#                        resource_attr_name: 'name',
+#                        resource_attr_value: 'efigence' }
+#
+# Validate (also conditionally) virtual or model attribute set inside some before validation callback:
+#
+#   validator_params = { form_object: '',
+#                        resource_model: 'company',
+#                        resource_attr_name: 'vat_number_with_prefix',
+#                        resource_attr_value: '',
+#                        ignore_resource_attr_value: 'true',
+#                        resource_instance_additional_params: {country: 'Poland',
+#                                                              vat_number: '0123456789'} }
+#
+#   validator_params = { form_object: '',
+#                        resource_model: 'company',
+#                        resource_attr_name: 'vat_number',
+#                        resource_attr_value: '',
+#                        ignore_resource_attr_value: 'true',
+#                        resource_instance_additional_params: {business_owner: true,
+#                                                              vat_number: ''} }
+#
+# validator = AjaxValidator::Validator.new(validator_params)
+# tested_company = validator.validate
+# tested_company.errors.to_a
+#
+# - `resource_instance_additional_params` hash is passed as args to given active model instance,
+# to handle before validation callbacks' dependencies, however, if form object is used,
+# additional params - if specified - must be handled by form object instance itself,
+# implementations may vary.
+# - set `ignore_resource_attr_value` to 'true' if attribute value is assembled inside before validation
+# callback
+# - validating virtual attributes, custom validation methods and custom validators are all supported
+module AjaxValidator
+  class Validator
+
+    def initialize(params = {})
+      @form_object = params[:form_object] # optional
+      @resource_model = params[:resource_model]
+      @resource_attr_name = params[:resource_attr_name]
+      @resource_attr_value = params[:resource_attr_value]
+      # skip setter if attribute is being assembled inside before validation callback
+      @ignore_resource_attr_value = params[:ignore_resource_attr_value].to_s == 'true'
+      if params[:resource_instance_additional_params].present?
+        @resource_instance_additional_params = params[:resource_instance_additional_params]
+      end
+      @bypass_whitelist = false
+    end
+
+    attr_accessor :form_object, :resource_model, :resource_attr_name, :resource_attr_value, :resource_instance_additional_params, :ignore_resource_attr_value, :bypass_whitelist
+
+    def validate
+      form_object_klass, resource_model_klass = safely_constantized_klasses
+      if form_object_klass
+        validate_form_object(resource_model_klass, form_object_klass)
+      else
+        validate_resource_model(resource_model_klass)
+      end
+    end
+
+    private
+
+    def safely_constantized_klasses
+      if form_object.present?
+        guard_whitelist(form_object)
+        form_object_klass = constantize_klass(form_object)
+      else
+        form_object_klass = nil
+      end
+      guard_whitelist(resource_model)
+      resource_model_klass = constantize_klass(resource_model)
+      [form_object_klass, resource_model_klass]
+    end
+
+    def constantize_klass(klass)
+      klass.to_s.classify.constantize
+    end
+
+    def validate_form_object(resource_model_klass, form_object_klass)
+      if resource_instance_additional_params
+        resource_instance = resource_model_klass.new(resource_instance_additional_params)
+      else
+        resource_instance = resource_model_klass.new
+      end
+      # support composition
+      klass_object = form_object_klass.new(resource_model.to_s => resource_instance) rescue nil
+      klass_object ||= form_object_klass.new(resource_instance)
+      klass_object.validate(resource_attr_name.to_s => resource_attr_value.to_s)
+      klass_object
+    end
+
+    def validate_resource_model(resource_model_klass)
+      klass_object = resource_model_klass.new(resource_instance_additional_params)
+      # run before_validation callback for active model (https://github.com/rails/rails/issues/718#issuecomment-1170499)
+      klass_object.try(:run_callbacks, :validation) { false }
+      if ignore_resource_attr_value
+        klass_object.send(:ajax_validator_valid_attribute?, resource_attr_name.to_s, klass_object.try(:send, resource_attr_name))
+      else
+        klass_object.send(:ajax_validator_valid_attribute?, resource_attr_name.to_s, resource_attr_value.to_s)
+      end
+      klass_object
+    end
+
+    def guard_whitelist(object)
+      unless bypass_whitelist
+        unless AjaxValidator::Engine.config[:whitelist_klasses].to_a.map{|i| i.to_s.underscore}.include?(object.to_s.underscore)
+          raise 'Class was not whitelisted!'
+        end
+      end
+    end
+  end
+end
+

data/app/views/layouts/ajax_validator/application.html.erb

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>AjaxValidator</title>
+  <%= stylesheet_link_tag    "ajax_validator/application", media: "all" %>
+  <%= javascript_include_tag "ajax_validator/application" %>
+  <%= csrf_meta_tags %>
+</head>
+<body>
+
+<%= yield %>
+
+</body>
+</html>

data/config/cucumber.yml

@@ -0,0 +1,8 @@
+<%
+rerun = File.file?('rerun.txt') ? IO.read('rerun.txt') : ""
+rerun_opts = rerun.to_s.strip.empty? ? "--format #{ENV['CUCUMBER_FORMAT'] || 'progress'} features" : "--format #{ENV['CUCUMBER_FORMAT'] || 'pretty'} #{rerun}"
+std_opts = "--format #{ENV['CUCUMBER_FORMAT'] || 'pretty'} --strict --tags ~@wip"
+%>
+default: <%= std_opts %> features
+wip: --tags @wip:3 --wip features
+rerun: <%= rerun_opts %> --format rerun --out rerun.txt --strict --tags ~@wip

data/config/routes.rb

@@ -0,0 +1,3 @@
+AjaxValidator::Engine.routes.draw do
+  resources :validators, only: [:create]
+end

data/lib/ajax_validator/engine.rb

@@ -0,0 +1,42 @@
+module AjaxValidator
+  class Engine < ::Rails::Engine
+    isolate_namespace AjaxValidator
+
+    config.generators do |g|
+      g.test_framework      :rspec,        :fixture => false
+      g.fixture_replacement :factory_girl, :dir => 'spec/factories'
+    end
+
+    config.to_prepare do
+      Rails.application.config.try(:ajax_validator_engine).try(:[], :whitelist_klasses).to_a.each do |whitelist_klass|
+        begin
+          klass = whitelist_klass.to_s.classify.constantize
+        rescue
+          raise "Can\'t constantize from \'#{whitelist_klass}\'. Check if class exists."
+        end
+        klass.include AjaxValidator::Concerns::Validation
+      end
+    end
+
+    def self.setup(&block)
+      @@config ||= AjaxValidator::Engine::Configuration.new
+      yield @@config if block
+      return @@config
+    end
+
+    def self.config
+      puts 'WARNING: ajax_validator_engine not configured' unless Rails.application.config.try(:ajax_validator_engine)
+      Rails.application.config.ajax_validator_engine
+    end
+
+    # will not reload in development
+    #initializer :prepare_models_for_ajax_validator do |app|
+    #end
+
+    #config.to_prepare do
+    #  Dir.glob(Rails.root + "app/decorators/**/*_decorator*.rb").each do |c|
+    #    require_dependency(c)
+    #  end
+    #end
+  end
+end

data/lib/ajax_validator/version.rb

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

data/lib/ajax_validator.rb

@@ -0,0 +1,4 @@
+require "ajax_validator/engine"
+
+module AjaxValidator
+end

data/lib/tasks/ajax_validator_tasks.rake

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

data/lib/tasks/cucumber.rake

@@ -0,0 +1,65 @@
+# IMPORTANT: This file is generated by cucumber-rails - edit at your own peril.
+# It is recommended to regenerate this file in the future when you upgrade to a 
+# newer version of cucumber-rails. Consider adding your own code to a new file 
+# instead of editing this one. Cucumber will automatically load all features/**/*.rb
+# files.
+
+
+unless ARGV.any? {|a| a =~ /^gems/} # Don't load anything when running the gems:* tasks
+
+vendored_cucumber_bin = Dir["#{Rails.root}/vendor/{gems,plugins}/cucumber*/bin/cucumber"].first
+$LOAD_PATH.unshift(File.dirname(vendored_cucumber_bin) + '/../lib') unless vendored_cucumber_bin.nil?
+
+begin
+  require 'cucumber/rake/task'
+
+  namespace :cucumber do
+    Cucumber::Rake::Task.new({:ok => 'db:test:prepare'}, 'Run features that should pass') do |t|
+      t.binary = vendored_cucumber_bin # If nil, the gem's binary is used.
+      t.fork = true # You may get faster startup if you set this to false
+      t.profile = 'default'
+    end
+
+    Cucumber::Rake::Task.new({:wip => 'db:test:prepare'}, 'Run features that are being worked on') do |t|
+      t.binary = vendored_cucumber_bin
+      t.fork = true # You may get faster startup if you set this to false
+      t.profile = 'wip'
+    end
+
+    Cucumber::Rake::Task.new({:rerun => 'db:test:prepare'}, 'Record failing features and run only them if any exist') do |t|
+      t.binary = vendored_cucumber_bin
+      t.fork = true # You may get faster startup if you set this to false
+      t.profile = 'rerun'
+    end
+
+    desc 'Run all features'
+    task :all => [:ok, :wip]
+
+    task :statsetup do
+      require 'rails/code_statistics'
+      ::STATS_DIRECTORIES << %w(Cucumber\ features features) if File.exist?('features')
+      ::CodeStatistics::TEST_TYPES << "Cucumber features" if File.exist?('features')
+    end
+  end
+  desc 'Alias for cucumber:ok'
+  task :cucumber => 'cucumber:ok'
+
+  task :default => :cucumber
+
+  task :features => :cucumber do
+    STDERR.puts "*** The 'features' task is deprecated. See rake -T cucumber ***"
+  end
+
+  # In case we don't have ActiveRecord, append a no-op task that we can depend upon.
+  task 'db:test:prepare' do
+  end
+
+  task :stats => 'cucumber:statsetup'
+rescue LoadError
+  desc 'cucumber rake task not available (cucumber not installed)'
+  task :cucumber do
+    abort 'Cucumber rake task is not available. Be sure to install cucumber as a gem or plugin'
+  end
+end
+
+end

data/spec/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/spec/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/spec/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 any plugin's vendor/assets/javascripts directory 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/rails/sprockets#sprockets-directives) for details
+// about supported directives.
+//
+//= require_tree .