diff --git a/.gitignore b/.gitignore index d8c256c..6cbbd99 100644 --- a/.gitignore +++ b/.gitignore @@ -40,3 +40,7 @@ bower.json # Ignore Byebug command history file. .byebug_history + +.idea/ +/test/dummy/tmp/ +/test/dummy/log/ diff --git a/.ruby-gemset b/.ruby-gemset new file mode 100644 index 0000000..dc1d287 --- /dev/null +++ b/.ruby-gemset @@ -0,0 +1 @@ +abraham diff --git a/.ruby-version b/.ruby-version new file mode 100644 index 0000000..f90b1af --- /dev/null +++ b/.ruby-version @@ -0,0 +1 @@ +2.3.2 diff --git a/Gemfile b/Gemfile new file mode 100644 index 0000000..aa05482 --- /dev/null +++ b/Gemfile @@ -0,0 +1,16 @@ +# frozen_string_literal: true +source 'http://rubygems.org' +source 'http://rails-assets.org' + +# Declare your gem's dependencies in abraham.gemspec. +# Bundler will treat runtime dependencies like base dependencies, and +# development dependencies will be added by default to the :development group. +gemspec + +# Declare any dependencies that are still in development here instead of in +# your gemspec. These might include edge Rails or gems from your path or +# Git. Remember to move these dependencies to your gemspec before releasing +# your gem to rubygems.org. + +# To use a debugger +# gem 'byebug', group: [:development, :test] diff --git a/Gemfile.lock b/Gemfile.lock new file mode 100644 index 0000000..e052412 --- /dev/null +++ b/Gemfile.lock @@ -0,0 +1,151 @@ +PATH + remote: . + specs: + abraham (0.1.1) + jquery-rails + rails (~> 5.0.0, >= 5.0.0.1) + rails-assets-shepherd.js (~> 1.8) + sass-rails (~> 5.0) + +GEM + remote: http://rubygems.org/ + remote: http://rails-assets.org/ + specs: + actioncable (5.0.0.1) + actionpack (= 5.0.0.1) + nio4r (~> 1.2) + websocket-driver (~> 0.6.1) + actionmailer (5.0.0.1) + actionpack (= 5.0.0.1) + actionview (= 5.0.0.1) + activejob (= 5.0.0.1) + mail (~> 2.5, >= 2.5.4) + rails-dom-testing (~> 2.0) + actionpack (5.0.0.1) + actionview (= 5.0.0.1) + activesupport (= 5.0.0.1) + rack (~> 2.0) + rack-test (~> 0.6.3) + rails-dom-testing (~> 2.0) + rails-html-sanitizer (~> 1.0, >= 1.0.2) + actionview (5.0.0.1) + activesupport (= 5.0.0.1) + builder (~> 3.1) + erubis (~> 2.7.0) + rails-dom-testing (~> 2.0) + rails-html-sanitizer (~> 1.0, >= 1.0.2) + activejob (5.0.0.1) + activesupport (= 5.0.0.1) + globalid (>= 0.3.6) + activemodel (5.0.0.1) + activesupport (= 5.0.0.1) + activerecord (5.0.0.1) + activemodel (= 5.0.0.1) + activesupport (= 5.0.0.1) + arel (~> 7.0) + activesupport (5.0.0.1) + concurrent-ruby (~> 1.0, >= 1.0.2) + i18n (~> 0.7) + minitest (~> 5.1) + tzinfo (~> 1.1) + arel (7.1.4) + ast (2.3.0) + builder (3.2.2) + concurrent-ruby (1.0.2) + erubis (2.7.0) + globalid (0.3.7) + activesupport (>= 4.1.0) + i18n (0.7.0) + jquery-rails (4.2.1) + rails-dom-testing (>= 1, < 3) + railties (>= 4.2.0) + thor (>= 0.14, < 2.0) + loofah (2.0.3) + nokogiri (>= 1.5.9) + mail (2.6.4) + mime-types (>= 1.16, < 4) + method_source (0.8.2) + mime-types (3.1) + mime-types-data (~> 3.2015) + mime-types-data (3.2016.0521) + mini_portile2 (2.1.0) + minitest (5.9.1) + nio4r (1.2.1) + nokogiri (1.6.8.1) + mini_portile2 (~> 2.1.0) + parser (2.3.2.0) + ast (~> 2.2) + powerpack (0.1.1) + rack (2.0.1) + rack-test (0.6.3) + rack (>= 1.0) + rails (5.0.0.1) + actioncable (= 5.0.0.1) + actionmailer (= 5.0.0.1) + actionpack (= 5.0.0.1) + actionview (= 5.0.0.1) + activejob (= 5.0.0.1) + activemodel (= 5.0.0.1) + activerecord (= 5.0.0.1) + activesupport (= 5.0.0.1) + bundler (>= 1.3.0, < 2.0) + railties (= 5.0.0.1) + sprockets-rails (>= 2.0.0) + rails-assets-shepherd.js (1.8.1) + rails-assets-tether (>= 1.0.1, < 2) + rails-assets-tether (1.3.7) + rails-dom-testing (2.0.1) + activesupport (>= 4.2.0, < 6.0) + nokogiri (~> 1.6.0) + rails-html-sanitizer (1.0.3) + loofah (~> 2.0) + railties (5.0.0.1) + actionpack (= 5.0.0.1) + activesupport (= 5.0.0.1) + method_source + rake (>= 0.8.7) + thor (>= 0.18.1, < 2.0) + rainbow (2.1.0) + rake (11.3.0) + rubocop (0.45.0) + parser (>= 2.3.1.1, < 3.0) + powerpack (~> 0.1) + rainbow (>= 1.99.1, < 3.0) + ruby-progressbar (~> 1.7) + unicode-display_width (~> 1.0, >= 1.0.1) + ruby-progressbar (1.8.1) + sass (3.4.22) + sass-rails (5.0.6) + railties (>= 4.0.0, < 6) + sass (~> 3.1) + sprockets (>= 2.8, < 4.0) + sprockets-rails (>= 2.0, < 4.0) + tilt (>= 1.1, < 3) + sprockets (3.7.0) + concurrent-ruby (~> 1.0) + rack (> 1, < 3) + sprockets-rails (3.2.0) + actionpack (>= 4.0) + activesupport (>= 4.0) + sprockets (>= 3.0.0) + sqlite3 (1.3.12) + thor (0.19.1) + thread_safe (0.3.5) + tilt (2.0.5) + tzinfo (1.2.2) + thread_safe (~> 0.1) + unicode-display_width (1.1.1) + websocket-driver (0.6.4) + websocket-extensions (>= 0.1.0) + websocket-extensions (0.1.2) + +PLATFORMS + ruby + +DEPENDENCIES + abraham! + rubocop + sqlite3 + +BUNDLED WITH + 1.13.6 diff --git a/LICENSE b/LICENSE index b3f53e4..1c7dc68 100644 --- a/LICENSE +++ b/LICENSE @@ -1,21 +1,20 @@ -MIT License +Copyright 2016 Jonathan Abbett -Copyright (c) 2016 ACT.md +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: -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 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. +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. diff --git a/README.md b/README.md index b161934..1028e2d 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,119 @@ -# abraham -Trackable application tours for Rails with i18n support +# Abraham + +_Guide your users in the one true path._ + +![Watercolor Sheep](https://upload.wikimedia.org/wikipedia/commons/e/e4/Watercolor_Sheep_Drawing.jpg) + +Abraham injects dynamically-generated [Shepherd.js](http://github.hubspot.com/shepherd/docs/welcome/) code into your Rails application whenever a user should see a guided tour. Skip a tour, and we'll try again next time; complete a tour, and it won't show up again. + +* Define tour content with simple YAML files, in any/many languages. +* Organize tours by controller and action. +* Plays nicely with Turbolinks. + +## Requirements + +Abraham needs to know the current user to track tour views, e.g. `current_user` from Devise. + +## Installation + +Add Abraham to your Gemfile: + +``` +gem 'abraham' +``` + +Then run: + +``` +$ bundle install +$ rails generate abraham:install +``` + +Require Shepherd.js in `app/assets/javascripts/application.js` + +``` +//= require shepherd.js.js +``` + +Require a Shepherd.js CSS theme in `app/assets/stylesheets/application.scss` + +``` +//= require "shepherd.js/dist/css/shepherd-theme-default" +``` + +Shepherd.js provides the following themes: + +- `shepherd-theme-arrows` +- `shepherd-theme-arrows-fix` +- `shepherd-theme-arrows-plain-buttons` +- `shepherd-theme-dark` +- `shepherd-theme-default` +- `shepherd-theme-square` +- `shepherd-theme-square-dark` + +Update `config/abraham.yml` if you choose a different theme: + +``` +defaults: &defaults + :default_theme: 'shepherd-theme-arrows' +``` + +Tell Abraham where to insert its generated JavaScript in `app/views/layouts/application.html.erb`, just before the closing `body` tag: + +```erb +<%= abraham_tour %> + + +``` + +## Defining your tours + +Define your tours in the `config/tours` directory. Its directory structure should mirror your application's controllers, and the tour files should mirror your actions/views. + +``` +config/ +└── tours/ + └── blog/ + │ ├── show.en.yml + │ └── show.es.yml + └── articles/ + ├── index.en.yml + ├── index.es.yml + ├── show.en.yml + └── show.es.yml +``` + +NB: You must specify a locale in the filename, even if you're only supporting one language. + +### Tour content + +A tour is composed of a series of steps. A step may have a title and must have a description. You may attach a step to a particular element on the page, and place the callout to the left, right, top, or bottom. + +```yaml +intro: + steps: + 1: + text: "Welcome to your dashboard! This is where we'll highlight key information to manage your day." + 2: + title: "Events" + text: "If you're participating in any events today, we'll show that here." + attachTo: + element: ".dashboard-events" + placement: "right" + 3: + title: "Search" + text: "You can find anything else by using the search bar." + attachTo: + element: ".navbar-primary form" + placement: "bottom" +``` + +Abraham takes care of which buttons should appear with each step: + +* "Later" and "Continue" buttons on the first step +* "Exit" and "Next" buttons on intermediate steps +* "Done" button on the last step + +### Testing your tours + +Abraham loads tour definitions once when you start your server. Restart your server to see tour changes. diff --git a/Rakefile b/Rakefile new file mode 100644 index 0000000..0ca2ff1 --- /dev/null +++ b/Rakefile @@ -0,0 +1,34 @@ +# frozen_string_literal: true +begin + require 'bundler/setup' +rescue LoadError + puts 'You must `gem install bundler` and `bundle install` to run rake tasks' +end + +require 'rdoc/task' + +RDoc::Task.new(:rdoc) do |rdoc| + rdoc.rdoc_dir = 'rdoc' + rdoc.title = 'Abraham' + rdoc.options << '--line-numbers' + rdoc.rdoc_files.include('README.md') + rdoc.rdoc_files.include('lib/**/*.rb') +end + +APP_RAKEFILE = File.expand_path('../test/dummy/Rakefile', __FILE__) +load 'rails/tasks/engine.rake' + +load 'rails/tasks/statistics.rake' + +require 'bundler/gem_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 diff --git a/abraham.gemspec b/abraham.gemspec new file mode 100644 index 0000000..68745aa --- /dev/null +++ b/abraham.gemspec @@ -0,0 +1,28 @@ +# frozen_string_literal: true +$LOAD_PATH.push File.expand_path('../lib', __FILE__) + +# Maintain your gem's version: +require 'abraham/version' + +# Describe your gem and declare its dependencies: +Gem::Specification.new do |s| + s.name = 'abraham' + s.version = Abraham::VERSION + s.authors = ['Jonathan Abbett'] + s.email = ['jonathan@act.md'] + s.homepage = 'http://getabraham.com' + s.summary = 'Trackable application tours for Rails with i18n support.' + s.description = 'Guide your users in the one true path.' + s.license = 'MIT' + + s.files = Dir['{app,config,db,lib}/**/*', 'MIT-LICENSE', 'Rakefile', 'README.md'] + + s.add_dependency 'rails', '~> 5.0.0', '>= 5.0.0.1' + s.add_dependency 'sass-rails', '~> 5.0' + s.add_dependency 'rails-assets-shepherd.js', '~> 1.8' + + s.add_development_dependency 'sqlite3' + s.add_development_dependency 'rubocop' + + s.add_runtime_dependency 'jquery-rails' +end diff --git a/app/assets/config/abraham_manifest.js b/app/assets/config/abraham_manifest.js new file mode 100644 index 0000000..e69de29 diff --git a/app/assets/images/abraham/.keep b/app/assets/images/abraham/.keep new file mode 100644 index 0000000..e69de29 diff --git a/app/assets/javascripts/abraham/.keep b/app/assets/javascripts/abraham/.keep new file mode 100644 index 0000000..e69de29 diff --git a/app/assets/stylesheets/abraham/.keep b/app/assets/stylesheets/abraham/.keep new file mode 100644 index 0000000..e69de29 diff --git a/app/controllers/.keep b/app/controllers/.keep new file mode 100644 index 0000000..e69de29 diff --git a/app/controllers/abraham_histories_controller.rb b/app/controllers/abraham_histories_controller.rb new file mode 100644 index 0000000..d22446a --- /dev/null +++ b/app/controllers/abraham_histories_controller.rb @@ -0,0 +1,21 @@ +# frozen_string_literal: true +class AbrahamHistoriesController < ApplicationController + def create + @abraham_history = AbrahamHistory.new(abraham_history_params) + @abraham_history.creator_id = current_user.id + respond_to do |format| + if @abraham_history.save + format.json { render json: @abraham_history, status: :created } + else + format.json { render json: @abraham_history.errors, status: :unprocessable_entity } + end + end + end + + private + + # Never trust parameters from the scary internet, only allow the white list through. + def abraham_history_params + params.require(:abraham_history).permit(:controller_name, :action_name, :tour_name) + end +end diff --git a/app/helpers/.keep b/app/helpers/.keep new file mode 100644 index 0000000..e69de29 diff --git a/app/helpers/abraham_helper.rb b/app/helpers/abraham_helper.rb new file mode 100644 index 0000000..4cd4b88 --- /dev/null +++ b/app/helpers/abraham_helper.rb @@ -0,0 +1,28 @@ +# frozen_string_literal: true +module AbrahamHelper + def abraham_tour + # Do we have tours for this controller/action in the user's locale? + tours = Rails.configuration.abraham.tours["#{controller_name}.#{action_name}.#{I18n.locale}"] + + unless tours + # How about the default locale? + tours = Rails.configuration.abraham.tours["#{controller_name}.#{action_name}.#{I18n.default_locale}"] + end + + if tours + completed = AbrahamHistory.where( + creator_id: current_user.id, + controller_name: controller_name, + action_name: action_name + ) + remaining = tours.keys - completed.map(&:tour_name) + + if remaining.any? + # Generate the javascript snippet for the next remaining tour + render(partial: 'application/abraham', + locals: { tour_name: remaining.first, + steps: tours[remaining.first]['steps'] }) + end + end + end +end diff --git a/app/mailers/.keep b/app/mailers/.keep new file mode 100644 index 0000000..e69de29 diff --git a/app/models/.keep b/app/models/.keep new file mode 100644 index 0000000..e69de29 diff --git a/app/models/abraham_history.rb b/app/models/abraham_history.rb new file mode 100644 index 0000000..7db45f9 --- /dev/null +++ b/app/models/abraham_history.rb @@ -0,0 +1,3 @@ +# frozen_string_literal: true +class AbrahamHistory < ActiveRecord::Base +end diff --git a/app/models/application_record.rb b/app/models/application_record.rb new file mode 100644 index 0000000..767a072 --- /dev/null +++ b/app/models/application_record.rb @@ -0,0 +1,4 @@ +# frozen_string_literal: true +class ApplicationRecord < ActiveRecord::Base + self.abstract_class = true +end diff --git a/app/views/.keep b/app/views/.keep new file mode 100644 index 0000000..e69de29 diff --git a/app/views/application/_abraham.html.erb b/app/views/application/_abraham.html.erb new file mode 100644 index 0000000..cb6df8c --- /dev/null +++ b/app/views/application/_abraham.html.erb @@ -0,0 +1,49 @@ + diff --git a/bin/rails b/bin/rails new file mode 100755 index 0000000..4824017 --- /dev/null +++ b/bin/rails @@ -0,0 +1,14 @@ +#!/usr/bin/env ruby +# frozen_string_literal: true +# This command will automatically be run when you run "rails" with Rails gems +# installed from the root of your application. + +ENGINE_ROOT = File.expand_path('../..', __FILE__) +ENGINE_PATH = File.expand_path('../../lib/abraham/engine', __FILE__) + +# Set up gems listed in the Gemfile. +ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile', __FILE__) +require 'bundler/setup' if File.exist?(ENV['BUNDLE_GEMFILE']) + +require 'rails/all' +require 'rails/engine/commands' diff --git a/config/locales/en.yml b/config/locales/en.yml new file mode 100644 index 0000000..8cc28ea --- /dev/null +++ b/config/locales/en.yml @@ -0,0 +1,7 @@ +en: + abraham: + later: "Later" + continue: "Continue" + exit: "Exit" + done: "Done" + next: "Next" diff --git a/config/locales/es.yml b/config/locales/es.yml new file mode 100644 index 0000000..d1933c7 --- /dev/null +++ b/config/locales/es.yml @@ -0,0 +1,7 @@ +es: + abraham: + later: "Luego" + continue: "Continuar" + exit: "Dejar" + done: "Hecho" + next: "Siguiente" diff --git a/config/routes.rb b/config/routes.rb new file mode 100644 index 0000000..773d296 --- /dev/null +++ b/config/routes.rb @@ -0,0 +1,4 @@ +# frozen_string_literal: true +Rails.application.routes.draw do + resources :abraham_histories, only: :create +end diff --git a/lib/abraham.rb b/lib/abraham.rb new file mode 100644 index 0000000..d4213bf --- /dev/null +++ b/lib/abraham.rb @@ -0,0 +1,5 @@ +# frozen_string_literal: true +require 'abraham/engine' + +module Abraham +end diff --git a/lib/abraham/engine.rb b/lib/abraham/engine.rb new file mode 100644 index 0000000..b1aed73 --- /dev/null +++ b/lib/abraham/engine.rb @@ -0,0 +1,9 @@ +# frozen_string_literal: true +require 'rubygems' +require 'rails-assets-shepherd.js' +require 'jquery-rails' + +module Abraham + class Engine < ::Rails::Engine + end +end diff --git a/lib/abraham/version.rb b/lib/abraham/version.rb new file mode 100644 index 0000000..afe7f93 --- /dev/null +++ b/lib/abraham/version.rb @@ -0,0 +1,4 @@ +# frozen_string_literal: true +module Abraham + VERSION = '0.1.1' +end diff --git a/lib/generators/abraham/install_generator.rb b/lib/generators/abraham/install_generator.rb new file mode 100644 index 0000000..570471d --- /dev/null +++ b/lib/generators/abraham/install_generator.rb @@ -0,0 +1,28 @@ +# frozen_string_literal: true +require 'rails/generators' +require 'rails/generators/active_record' + +module Abraham + module Generators + class InstallGenerator < ActiveRecord::Generators::Base + argument :name, type: :string, default: 'random_name' + + class_option :'skip-migration', type: :boolean, desc: "Don't generate a migration for the histories table" + class_option :'skip-initializer', type: :boolean, desc: "Don't generate an initializer" + + source_root File.expand_path(File.join(File.dirname(__FILE__), 'templates')) + + # Copies the migration template to db/migrate. + def copy_files + return if options['skip-migration'] + migration_template 'migration.rb', 'db/migrate/create_abraham_histories.rb' + end + + def create_initializer + return if options['skip-initializer'] + copy_file 'initializer.rb', 'config/initializers/abraham.rb' + copy_file 'abraham.yml', 'config/abraham.yml' + end + end + end +end diff --git a/lib/generators/abraham/templates/abraham.yml b/lib/generators/abraham/templates/abraham.yml new file mode 100644 index 0000000..9b94abb --- /dev/null +++ b/lib/generators/abraham/templates/abraham.yml @@ -0,0 +1,11 @@ +defaults: &defaults + :default_theme: 'shepherd-theme-default' + +development: + <<: *defaults + +test: + <<: *defaults + +production: + <<: *defaults diff --git a/lib/generators/abraham/templates/initializer.rb b/lib/generators/abraham/templates/initializer.rb new file mode 100644 index 0000000..c3fc522 --- /dev/null +++ b/lib/generators/abraham/templates/initializer.rb @@ -0,0 +1,23 @@ +# frozen_string_literal: true +Rails.application.configure do + tours = {} + + if Rails.root.join('config/tours').exist? + Dir[Rails.root.join('config/tours/*/')].each do |dir| + Dir[dir + '*.yml'].each do |yml| + path_parts = yml.split(File::SEPARATOR) + controller = path_parts[path_parts.size - 2] + file_parts = path_parts[path_parts.size - 1].split('.') + action = file_parts[0] + locale = file_parts[1] + t = YAML.load_file(yml) + tours["#{controller}.#{action}.#{locale}"] = t + end + end + end + + abraham_config = Rails.application.config_for :abraham + config.abraham = ActiveSupport::OrderedOptions.new + config.abraham.default_theme = abraham_config[:default_theme] + config.abraham.tours = tours +end diff --git a/lib/generators/abraham/templates/migration.rb b/lib/generators/abraham/templates/migration.rb new file mode 100644 index 0000000..295ebdd --- /dev/null +++ b/lib/generators/abraham/templates/migration.rb @@ -0,0 +1,13 @@ +# frozen_string_literal: true +class CreateAbrahamHistories < ActiveRecord::Migration[5.0] + def change + create_table :abraham_histories do |t| + t.string :controller_name + t.string :action_name + t.string :tour_name + t.references :creator, null: false, index: true + + t.timestamps index: true + end + end +end diff --git a/lib/tasks/abraham_tasks.rake b/lib/tasks/abraham_tasks.rake new file mode 100644 index 0000000..c87398e --- /dev/null +++ b/lib/tasks/abraham_tasks.rake @@ -0,0 +1,5 @@ +# frozen_string_literal: true +# desc "Explaining what the task does" +# task :abraham do +# # Task goes here +# end diff --git a/test/abraham_test.rb b/test/abraham_test.rb new file mode 100644 index 0000000..845f33e --- /dev/null +++ b/test/abraham_test.rb @@ -0,0 +1,8 @@ +# frozen_string_literal: true +require 'test_helper' + +class Abraham::Test < ActiveSupport::TestCase + test 'truth' do + assert_kind_of Module, Abraham + end +end diff --git a/test/dummy/Rakefile b/test/dummy/Rakefile new file mode 100644 index 0000000..84f2bc3 --- /dev/null +++ b/test/dummy/Rakefile @@ -0,0 +1,7 @@ +# frozen_string_literal: true +# 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_relative 'config/application' + +Rails.application.load_tasks diff --git a/test/dummy/app/assets/config/manifest.js b/test/dummy/app/assets/config/manifest.js new file mode 100644 index 0000000..c8e290c --- /dev/null +++ b/test/dummy/app/assets/config/manifest.js @@ -0,0 +1,4 @@ + +//= link_tree ../images +//= link_directory ../javascripts .js +//= link_directory ../stylesheets .css diff --git a/test/dummy/app/assets/images/.keep b/test/dummy/app/assets/images/.keep new file mode 100644 index 0000000..e69de29 diff --git a/test/dummy/app/assets/javascripts/application.js b/test/dummy/app/assets/javascripts/application.js new file mode 100644 index 0000000..79a314e --- /dev/null +++ b/test/dummy/app/assets/javascripts/application.js @@ -0,0 +1,17 @@ +// 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. JavaScript code in this file should be added after the last require_* statement. +// +// Read Sprockets README (https://github.com/rails/sprockets#sprockets-directives) for details +// about supported directives. +// +//= require jquery +//= require jquery_ujs +//= require tether +//= require shepherd.js.js +//= require_tree . diff --git a/test/dummy/app/assets/javascripts/cable.js b/test/dummy/app/assets/javascripts/cable.js new file mode 100644 index 0000000..71ee1e6 --- /dev/null +++ b/test/dummy/app/assets/javascripts/cable.js @@ -0,0 +1,13 @@ +// Action Cable provides the framework to deal with WebSockets in Rails. +// You can generate new channels where WebSocket features live using the rails generate channel command. +// +//= require action_cable +//= require_self +//= require_tree ./channels + +(function() { + this.App || (this.App = {}); + + App.cable = ActionCable.createConsumer(); + +}).call(this); diff --git a/test/dummy/app/assets/javascripts/channels/.keep b/test/dummy/app/assets/javascripts/channels/.keep new file mode 100644 index 0000000..e69de29 diff --git a/test/dummy/app/assets/javascripts/dashboard.js b/test/dummy/app/assets/javascripts/dashboard.js new file mode 100644 index 0000000..dee720f --- /dev/null +++ b/test/dummy/app/assets/javascripts/dashboard.js @@ -0,0 +1,2 @@ +// Place all the behaviors and hooks related to the matching controller here. +// All this logic will automatically be available in application.js. diff --git a/test/dummy/app/assets/stylesheets/application.css b/test/dummy/app/assets/stylesheets/application.css new file mode 100644 index 0000000..24e6c64 --- /dev/null +++ b/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 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 other CSS/SCSS + * files in this directory. Styles in this file should be added after the last require_* statement. + * It is generally better to create a new file per style scope. + * + *= require "shepherd.js/dist/css/shepherd-theme-default" + *= require_tree . + */ diff --git a/test/dummy/app/assets/stylesheets/dashboard.css b/test/dummy/app/assets/stylesheets/dashboard.css new file mode 100644 index 0000000..afad32d --- /dev/null +++ b/test/dummy/app/assets/stylesheets/dashboard.css @@ -0,0 +1,4 @@ +/* + Place all the styles related to the matching controller here. + They will automatically be included in application.css. +*/ diff --git a/test/dummy/app/channels/application_cable/channel.rb b/test/dummy/app/channels/application_cable/channel.rb new file mode 100644 index 0000000..51e3e93 --- /dev/null +++ b/test/dummy/app/channels/application_cable/channel.rb @@ -0,0 +1,5 @@ +# frozen_string_literal: true +module ApplicationCable + class Channel < ActionCable::Channel::Base + end +end diff --git a/test/dummy/app/channels/application_cable/connection.rb b/test/dummy/app/channels/application_cable/connection.rb new file mode 100644 index 0000000..fa70319 --- /dev/null +++ b/test/dummy/app/channels/application_cable/connection.rb @@ -0,0 +1,5 @@ +# frozen_string_literal: true +module ApplicationCable + class Connection < ActionCable::Connection::Base + end +end diff --git a/test/dummy/app/controllers/application_controller.rb b/test/dummy/app/controllers/application_controller.rb new file mode 100644 index 0000000..5acba08 --- /dev/null +++ b/test/dummy/app/controllers/application_controller.rb @@ -0,0 +1,9 @@ +# frozen_string_literal: true +class ApplicationController < ActionController::Base + protect_from_forgery with: :exception + helper_method :current_user + + def current_user + OpenStruct.new(id: Random.rand(1..99999)) + end +end diff --git a/test/dummy/app/controllers/concerns/.keep b/test/dummy/app/controllers/concerns/.keep new file mode 100644 index 0000000..e69de29 diff --git a/test/dummy/app/controllers/dashboard_controller.rb b/test/dummy/app/controllers/dashboard_controller.rb new file mode 100644 index 0000000..9c70ebc --- /dev/null +++ b/test/dummy/app/controllers/dashboard_controller.rb @@ -0,0 +1,8 @@ +# frozen_string_literal: true +class DashboardController < ApplicationController + def home + end + + def other + end +end diff --git a/test/dummy/app/helpers/application_helper.rb b/test/dummy/app/helpers/application_helper.rb new file mode 100644 index 0000000..71249b9 --- /dev/null +++ b/test/dummy/app/helpers/application_helper.rb @@ -0,0 +1,3 @@ +# frozen_string_literal: true +module ApplicationHelper +end diff --git a/test/dummy/app/helpers/dashboard_helper.rb b/test/dummy/app/helpers/dashboard_helper.rb new file mode 100644 index 0000000..79ce46b --- /dev/null +++ b/test/dummy/app/helpers/dashboard_helper.rb @@ -0,0 +1,3 @@ +# frozen_string_literal: true +module DashboardHelper +end diff --git a/test/dummy/app/jobs/application_job.rb b/test/dummy/app/jobs/application_job.rb new file mode 100644 index 0000000..32fe70b --- /dev/null +++ b/test/dummy/app/jobs/application_job.rb @@ -0,0 +1,3 @@ +# frozen_string_literal: true +class ApplicationJob < ActiveJob::Base +end diff --git a/test/dummy/app/mailers/application_mailer.rb b/test/dummy/app/mailers/application_mailer.rb new file mode 100644 index 0000000..2428900 --- /dev/null +++ b/test/dummy/app/mailers/application_mailer.rb @@ -0,0 +1,5 @@ +# frozen_string_literal: true +class ApplicationMailer < ActionMailer::Base + default from: 'from@example.com' + layout 'mailer' +end diff --git a/test/dummy/app/models/application_record.rb b/test/dummy/app/models/application_record.rb new file mode 100644 index 0000000..767a072 --- /dev/null +++ b/test/dummy/app/models/application_record.rb @@ -0,0 +1,4 @@ +# frozen_string_literal: true +class ApplicationRecord < ActiveRecord::Base + self.abstract_class = true +end diff --git a/test/dummy/app/models/concerns/.keep b/test/dummy/app/models/concerns/.keep new file mode 100644 index 0000000..e69de29 diff --git a/test/dummy/app/views/dashboard/home.html.erb b/test/dummy/app/views/dashboard/home.html.erb new file mode 100644 index 0000000..c04268d --- /dev/null +++ b/test/dummy/app/views/dashboard/home.html.erb @@ -0,0 +1,6 @@ +

Dashboard#home

+

Find me in app/views/dashboard/home.html.erb

+ +
+ a content element to notice +
diff --git a/test/dummy/app/views/dashboard/other.html.erb b/test/dummy/app/views/dashboard/other.html.erb new file mode 100644 index 0000000..cbef03f --- /dev/null +++ b/test/dummy/app/views/dashboard/other.html.erb @@ -0,0 +1,2 @@ +

Dashboard#other

+

Find me in app/views/dashboard/other.html.erb

diff --git a/test/dummy/app/views/layouts/application.html.erb b/test/dummy/app/views/layouts/application.html.erb new file mode 100644 index 0000000..25b0bea --- /dev/null +++ b/test/dummy/app/views/layouts/application.html.erb @@ -0,0 +1,16 @@ + + + + Dummy + <%= csrf_meta_tags %> + + <%= stylesheet_link_tag 'application', media: 'all', 'data-turbolinks-track': 'reload' %> + <%= javascript_include_tag 'application', 'data-turbolinks-track': 'reload' %> + + + + <%= yield %> + + <%= abraham_tour %> + + diff --git a/test/dummy/app/views/layouts/mailer.html.erb b/test/dummy/app/views/layouts/mailer.html.erb new file mode 100644 index 0000000..cbd34d2 --- /dev/null +++ b/test/dummy/app/views/layouts/mailer.html.erb @@ -0,0 +1,13 @@ + + + + + + + + + <%= yield %> + + diff --git a/test/dummy/app/views/layouts/mailer.text.erb b/test/dummy/app/views/layouts/mailer.text.erb new file mode 100644 index 0000000..37f0bdd --- /dev/null +++ b/test/dummy/app/views/layouts/mailer.text.erb @@ -0,0 +1 @@ +<%= yield %> diff --git a/test/dummy/bin/bundle b/test/dummy/bin/bundle new file mode 100755 index 0000000..86f3466 --- /dev/null +++ b/test/dummy/bin/bundle @@ -0,0 +1,4 @@ +#!/usr/bin/env ruby +# frozen_string_literal: true +ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile', __FILE__) +load Gem.bin_path('bundler', 'bundle') diff --git a/test/dummy/bin/rails b/test/dummy/bin/rails new file mode 100755 index 0000000..dd027b4 --- /dev/null +++ b/test/dummy/bin/rails @@ -0,0 +1,5 @@ +#!/usr/bin/env ruby +# frozen_string_literal: true +APP_PATH = File.expand_path('../config/application', __dir__) +require_relative '../config/boot' +require 'rails/commands' diff --git a/test/dummy/bin/rake b/test/dummy/bin/rake new file mode 100755 index 0000000..609af74 --- /dev/null +++ b/test/dummy/bin/rake @@ -0,0 +1,5 @@ +#!/usr/bin/env ruby +# frozen_string_literal: true +require_relative '../config/boot' +require 'rake' +Rake.application.run diff --git a/test/dummy/bin/setup b/test/dummy/bin/setup new file mode 100755 index 0000000..ffca742 --- /dev/null +++ b/test/dummy/bin/setup @@ -0,0 +1,35 @@ +#!/usr/bin/env ruby +# frozen_string_literal: true +require 'pathname' +require 'fileutils' +include FileUtils + +# path to your application root. +APP_ROOT = Pathname.new File.expand_path('../../', __FILE__) + +def system!(*args) + system(*args) || abort("\n== Command #{args} failed ==") +end + +chdir APP_ROOT do + # This script is a starting point to setup your application. + # Add necessary setup steps to this file. + + puts '== Installing dependencies ==' + system! 'gem install bundler --conservative' + system('bundle check') || system!('bundle install') + + # puts "\n== Copying sample files ==" + # unless File.exist?('config/database.yml') + # cp 'config/database.yml.sample', 'config/database.yml' + # end + + puts "\n== Preparing database ==" + system! 'bin/rails db:setup' + + puts "\n== Removing old logs and tempfiles ==" + system! 'bin/rails log:clear tmp:clear' + + puts "\n== Restarting application server ==" + system! 'bin/rails restart' +end diff --git a/test/dummy/bin/update b/test/dummy/bin/update new file mode 100755 index 0000000..3f81e54 --- /dev/null +++ b/test/dummy/bin/update @@ -0,0 +1,30 @@ +#!/usr/bin/env ruby +# frozen_string_literal: true +require 'pathname' +require 'fileutils' +include FileUtils + +# path to your application root. +APP_ROOT = Pathname.new File.expand_path('../../', __FILE__) + +def system!(*args) + system(*args) || abort("\n== Command #{args} failed ==") +end + +chdir APP_ROOT do + # This script is a way to update your development environment automatically. + # Add necessary update steps to this file. + + puts '== Installing dependencies ==' + system! 'gem install bundler --conservative' + system('bundle check') || system!('bundle install') + + puts "\n== Updating database ==" + system! 'bin/rails db:migrate' + + puts "\n== Removing old logs and tempfiles ==" + system! 'bin/rails log:clear tmp:clear' + + puts "\n== Restarting application server ==" + system! 'bin/rails restart' +end diff --git a/test/dummy/config.ru b/test/dummy/config.ru new file mode 100644 index 0000000..7eae264 --- /dev/null +++ b/test/dummy/config.ru @@ -0,0 +1,6 @@ +# frozen_string_literal: true +# This file is used by Rack-based servers to start the application. + +require_relative 'config/environment' + +run Rails.application diff --git a/test/dummy/config/abraham.yml b/test/dummy/config/abraham.yml new file mode 100644 index 0000000..9b94abb --- /dev/null +++ b/test/dummy/config/abraham.yml @@ -0,0 +1,11 @@ +defaults: &defaults + :default_theme: 'shepherd-theme-default' + +development: + <<: *defaults + +test: + <<: *defaults + +production: + <<: *defaults diff --git a/test/dummy/config/application.rb b/test/dummy/config/application.rb new file mode 100644 index 0000000..6b3a2da --- /dev/null +++ b/test/dummy/config/application.rb @@ -0,0 +1,15 @@ +# frozen_string_literal: true +require_relative 'boot' + +require 'rails/all' + +Bundler.require(*Rails.groups) +require 'abraham' + +module Dummy + class Application < Rails::Application + # Settings in config/environments/* take precedence over those specified here. + # Application configuration should go into files in config/initializers + # -- all .rb files in that directory are automatically loaded. + end +end diff --git a/test/dummy/config/boot.rb b/test/dummy/config/boot.rb new file mode 100644 index 0000000..c90021f --- /dev/null +++ b/test/dummy/config/boot.rb @@ -0,0 +1,6 @@ +# frozen_string_literal: true +# Set up gems listed in the Gemfile. +ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../../Gemfile', __dir__) + +require 'bundler/setup' if File.exist?(ENV['BUNDLE_GEMFILE']) +$LOAD_PATH.unshift File.expand_path('../../../lib', __dir__) diff --git a/test/dummy/config/cable.yml b/test/dummy/config/cable.yml new file mode 100644 index 0000000..0bbde6f --- /dev/null +++ b/test/dummy/config/cable.yml @@ -0,0 +1,9 @@ +development: + adapter: async + +test: + adapter: async + +production: + adapter: redis + url: redis://localhost:6379/1 diff --git a/test/dummy/config/database.yml b/test/dummy/config/database.yml new file mode 100644 index 0000000..1c1a37c --- /dev/null +++ b/test/dummy/config/database.yml @@ -0,0 +1,25 @@ +# SQLite version 3.x +# gem install sqlite3 +# +# Ensure the SQLite 3 gem is defined in your Gemfile +# gem 'sqlite3' +# +default: &default + adapter: sqlite3 + pool: 5 + timeout: 5000 + +development: + <<: *default + database: db/development.sqlite3 + +# Warning: The database defined as "test" will be erased and +# re-generated from your development database when you run "rake". +# Do not set this db to the same as development or production. +test: + <<: *default + database: db/test.sqlite3 + +production: + <<: *default + database: db/production.sqlite3 diff --git a/test/dummy/config/environment.rb b/test/dummy/config/environment.rb new file mode 100644 index 0000000..12ea62f --- /dev/null +++ b/test/dummy/config/environment.rb @@ -0,0 +1,6 @@ +# frozen_string_literal: true +# Load the Rails application. +require_relative 'application' + +# Initialize the Rails application. +Rails.application.initialize! diff --git a/test/dummy/config/environments/development.rb b/test/dummy/config/environments/development.rb new file mode 100644 index 0000000..8f4ad21 --- /dev/null +++ b/test/dummy/config/environments/development.rb @@ -0,0 +1,55 @@ +# frozen_string_literal: true +Rails.application.configure do + # Settings specified here will take precedence over those in config/application.rb. + + # In the development environment your application's code is reloaded on + # every request. This slows down response time but is perfect for development + # since you don't have to restart the web server when you make code changes. + config.cache_classes = false + + # Do not eager load code on boot. + config.eager_load = false + + # Show full error reports. + config.consider_all_requests_local = true + + # Enable/disable caching. By default caching is disabled. + if Rails.root.join('tmp/caching-dev.txt').exist? + config.action_controller.perform_caching = true + + config.cache_store = :memory_store + config.public_file_server.headers = { + 'Cache-Control' => 'public, max-age=172800' + } + else + config.action_controller.perform_caching = false + + config.cache_store = :null_store + end + + # Don't care if the mailer can't send. + config.action_mailer.raise_delivery_errors = false + + config.action_mailer.perform_caching = false + + # Print deprecation notices to the Rails logger. + config.active_support.deprecation = :log + + # Raise an error on page load if there are pending migrations. + config.active_record.migration_error = :page_load + + # Debug mode disables concatenation and preprocessing of assets. + # This option may cause significant delays in view rendering with a large + # number of complex assets. + config.assets.debug = true + + # Suppress logger output for asset requests. + config.assets.quiet = true + + # Raises error for missing translations + # config.action_view.raise_on_missing_translations = true + + # Use an evented file watcher to asynchronously detect changes in source code, + # routes, locales, etc. This feature depends on the listen gem. + # config.file_watcher = ActiveSupport::EventedFileUpdateChecker +end diff --git a/test/dummy/config/environments/production.rb b/test/dummy/config/environments/production.rb new file mode 100644 index 0000000..cbdb208 --- /dev/null +++ b/test/dummy/config/environments/production.rb @@ -0,0 +1,87 @@ +# frozen_string_literal: true +Rails.application.configure do + # Settings specified here will take precedence over those in config/application.rb. + + # Code is not reloaded between requests. + config.cache_classes = true + + # Eager load code on boot. This eager loads most of Rails and + # your application in memory, allowing both threaded web servers + # and those relying on copy on write to perform better. + # Rake tasks automatically ignore this option for performance. + config.eager_load = true + + # Full error reports are disabled and caching is turned on. + config.consider_all_requests_local = false + config.action_controller.perform_caching = true + + # Disable serving static files from the `/public` folder by default since + # Apache or NGINX already handles this. + config.public_file_server.enabled = ENV['RAILS_SERVE_STATIC_FILES'].present? + + # Compress JavaScripts and CSS. + config.assets.js_compressor = :uglifier + # config.assets.css_compressor = :sass + + # Do not fallback to assets pipeline if a precompiled asset is missed. + config.assets.compile = false + + # `config.assets.precompile` and `config.assets.version` have moved to config/initializers/assets.rb + + # Enable serving of images, stylesheets, and JavaScripts from an asset server. + # config.action_controller.asset_host = 'http://assets.example.com' + + # Specifies the header that your server uses for sending files. + # config.action_dispatch.x_sendfile_header = 'X-Sendfile' # for Apache + # config.action_dispatch.x_sendfile_header = 'X-Accel-Redirect' # for NGINX + + # Mount Action Cable outside main process or domain + # config.action_cable.mount_path = nil + # config.action_cable.url = 'wss://example.com/cable' + # config.action_cable.allowed_request_origins = [ 'http://example.com', /http:\/\/example.*/ ] + + # Force all access to the app over SSL, use Strict-Transport-Security, and use secure cookies. + # config.force_ssl = true + + # Use the lowest log level to ensure availability of diagnostic information + # when problems arise. + config.log_level = :debug + + # Prepend all log lines with the following tags. + config.log_tags = [:request_id] + + # Use a different cache store in production. + # config.cache_store = :mem_cache_store + + # Use a real queuing backend for Active Job (and separate queues per environment) + # config.active_job.queue_adapter = :resque + # config.active_job.queue_name_prefix = "dummy_#{Rails.env}" + config.action_mailer.perform_caching = false + + # Ignore bad email addresses and do not raise email delivery errors. + # Set this to true and configure the email server for immediate delivery to raise delivery errors. + # config.action_mailer.raise_delivery_errors = false + + # Enable locale fallbacks for I18n (makes lookups for any locale fall back to + # the I18n.default_locale when a translation cannot be found). + config.i18n.fallbacks = true + + # Send deprecation notices to registered listeners. + config.active_support.deprecation = :notify + + # Use default logging formatter so that PID and timestamp are not suppressed. + config.log_formatter = ::Logger::Formatter.new + + # Use a different logger for distributed setups. + # require 'syslog/logger' + # config.logger = ActiveSupport::TaggedLogging.new(Syslog::Logger.new 'app-name') + + if ENV['RAILS_LOG_TO_STDOUT'].present? + logger = ActiveSupport::Logger.new(STDOUT) + logger.formatter = config.log_formatter + config.logger = ActiveSupport::TaggedLogging.new(logger) + end + + # Do not dump schema after migrations. + config.active_record.dump_schema_after_migration = false +end diff --git a/test/dummy/config/environments/test.rb b/test/dummy/config/environments/test.rb new file mode 100644 index 0000000..416a71c --- /dev/null +++ b/test/dummy/config/environments/test.rb @@ -0,0 +1,43 @@ +# frozen_string_literal: true +Rails.application.configure do + # Settings specified here will take precedence over those in config/application.rb. + + # The test environment is used exclusively to run your application's + # test suite. You never need to work with it otherwise. Remember that + # your test database is "scratch space" for the test suite and is wiped + # and recreated between test runs. Don't rely on the data there! + config.cache_classes = true + + # Do not eager load code on boot. This avoids loading your whole application + # just for the purpose of running a single test. If you are using a tool that + # preloads Rails for running tests, you may have to set it to true. + config.eager_load = false + + # Configure public file server for tests with Cache-Control for performance. + config.public_file_server.enabled = true + config.public_file_server.headers = { + 'Cache-Control' => 'public, max-age=3600' + } + + # Show full error reports and disable caching. + config.consider_all_requests_local = true + config.action_controller.perform_caching = false + + # Raise exceptions instead of rendering exception templates. + config.action_dispatch.show_exceptions = false + + # Disable request forgery protection in test environment. + config.action_controller.allow_forgery_protection = false + config.action_mailer.perform_caching = false + + # Tell Action Mailer not to deliver emails to the real world. + # The :test delivery method accumulates sent emails in the + # ActionMailer::Base.deliveries array. + config.action_mailer.delivery_method = :test + + # Print deprecation notices to the stderr. + config.active_support.deprecation = :stderr + + # Raises error for missing translations + # config.action_view.raise_on_missing_translations = true +end diff --git a/test/dummy/config/initializers/abraham.rb b/test/dummy/config/initializers/abraham.rb new file mode 100644 index 0000000..c3fc522 --- /dev/null +++ b/test/dummy/config/initializers/abraham.rb @@ -0,0 +1,23 @@ +# frozen_string_literal: true +Rails.application.configure do + tours = {} + + if Rails.root.join('config/tours').exist? + Dir[Rails.root.join('config/tours/*/')].each do |dir| + Dir[dir + '*.yml'].each do |yml| + path_parts = yml.split(File::SEPARATOR) + controller = path_parts[path_parts.size - 2] + file_parts = path_parts[path_parts.size - 1].split('.') + action = file_parts[0] + locale = file_parts[1] + t = YAML.load_file(yml) + tours["#{controller}.#{action}.#{locale}"] = t + end + end + end + + abraham_config = Rails.application.config_for :abraham + config.abraham = ActiveSupport::OrderedOptions.new + config.abraham.default_theme = abraham_config[:default_theme] + config.abraham.tours = tours +end diff --git a/test/dummy/config/initializers/application_controller_renderer.rb b/test/dummy/config/initializers/application_controller_renderer.rb new file mode 100644 index 0000000..315ac48 --- /dev/null +++ b/test/dummy/config/initializers/application_controller_renderer.rb @@ -0,0 +1,7 @@ +# frozen_string_literal: true +# Be sure to restart your server when you modify this file. + +# ApplicationController.renderer.defaults.merge!( +# http_host: 'example.org', +# https: false +# ) diff --git a/test/dummy/config/initializers/assets.rb b/test/dummy/config/initializers/assets.rb new file mode 100644 index 0000000..9287bcd --- /dev/null +++ b/test/dummy/config/initializers/assets.rb @@ -0,0 +1,12 @@ +# frozen_string_literal: true +# Be sure to restart your server when you modify this file. + +# Version of your assets, change this if you want to expire all your assets. +Rails.application.config.assets.version = '1.0' + +# Add additional assets to the asset load path +# Rails.application.config.assets.paths << Emoji.images_path + +# Precompile additional assets. +# application.js, application.css, and all non-JS/CSS in app/assets folder are already added. +# Rails.application.config.assets.precompile += %w( search.js ) diff --git a/test/dummy/config/initializers/backtrace_silencers.rb b/test/dummy/config/initializers/backtrace_silencers.rb new file mode 100644 index 0000000..d0f0d3b --- /dev/null +++ b/test/dummy/config/initializers/backtrace_silencers.rb @@ -0,0 +1,8 @@ +# frozen_string_literal: true +# Be sure to restart your server when you modify this file. + +# You can add backtrace silencers for libraries that you're using but don't wish to see in your backtraces. +# Rails.backtrace_cleaner.add_silencer { |line| line =~ /my_noisy_library/ } + +# You can also remove all the silencers if you're trying to debug a problem that might stem from framework code. +# Rails.backtrace_cleaner.remove_silencers! diff --git a/test/dummy/config/initializers/cookies_serializer.rb b/test/dummy/config/initializers/cookies_serializer.rb new file mode 100644 index 0000000..2a72959 --- /dev/null +++ b/test/dummy/config/initializers/cookies_serializer.rb @@ -0,0 +1,6 @@ +# frozen_string_literal: true +# Be sure to restart your server when you modify this file. + +# Specify a serializer for the signed and encrypted cookie jars. +# Valid options are :json, :marshal, and :hybrid. +Rails.application.config.action_dispatch.cookies_serializer = :json diff --git a/test/dummy/config/initializers/filter_parameter_logging.rb b/test/dummy/config/initializers/filter_parameter_logging.rb new file mode 100644 index 0000000..b7fe123 --- /dev/null +++ b/test/dummy/config/initializers/filter_parameter_logging.rb @@ -0,0 +1,5 @@ +# frozen_string_literal: true +# Be sure to restart your server when you modify this file. + +# Configure sensitive parameters which will be filtered from the log file. +Rails.application.config.filter_parameters += [:password] diff --git a/test/dummy/config/initializers/inflections.rb b/test/dummy/config/initializers/inflections.rb new file mode 100644 index 0000000..aa7435f --- /dev/null +++ b/test/dummy/config/initializers/inflections.rb @@ -0,0 +1,17 @@ +# frozen_string_literal: true +# Be sure to restart your server when you modify this file. + +# Add new inflection rules using the following format. Inflections +# are locale specific, and you may define rules for as many different +# locales as you wish. All of these examples are active by default: +# ActiveSupport::Inflector.inflections(:en) do |inflect| +# inflect.plural /^(ox)$/i, '\1en' +# inflect.singular /^(ox)en/i, '\1' +# inflect.irregular 'person', 'people' +# inflect.uncountable %w( fish sheep ) +# end + +# These inflection rules are supported but not enabled by default: +# ActiveSupport::Inflector.inflections(:en) do |inflect| +# inflect.acronym 'RESTful' +# end diff --git a/test/dummy/config/initializers/mime_types.rb b/test/dummy/config/initializers/mime_types.rb new file mode 100644 index 0000000..6e1d16f --- /dev/null +++ b/test/dummy/config/initializers/mime_types.rb @@ -0,0 +1,5 @@ +# frozen_string_literal: true +# Be sure to restart your server when you modify this file. + +# Add new mime types for use in respond_to blocks: +# Mime::Type.register "text/richtext", :rtf diff --git a/test/dummy/config/initializers/new_framework_defaults.rb b/test/dummy/config/initializers/new_framework_defaults.rb new file mode 100644 index 0000000..d3c12d7 --- /dev/null +++ b/test/dummy/config/initializers/new_framework_defaults.rb @@ -0,0 +1,25 @@ +# frozen_string_literal: true +# Be sure to restart your server when you modify this file. +# +# This file contains migration options to ease your Rails 5.0 upgrade. +# +# Read the Rails 5.0 release notes for more info on each option. + +# Enable per-form CSRF tokens. Previous versions had false. +Rails.application.config.action_controller.per_form_csrf_tokens = true + +# Enable origin-checking CSRF mitigation. Previous versions had false. +Rails.application.config.action_controller.forgery_protection_origin_check = true + +# Make Ruby 2.4 preserve the timezone of the receiver when calling `to_time`. +# Previous versions had false. +ActiveSupport.to_time_preserves_timezone = true + +# Require `belongs_to` associations by default. Previous versions had false. +Rails.application.config.active_record.belongs_to_required_by_default = true + +# Do not halt callback chains when a callback returns false. Previous versions had true. +ActiveSupport.halt_callback_chains_on_return_false = false + +# Configure SSL options to enable HSTS with subdomains. Previous versions had false. +Rails.application.config.ssl_options = { hsts: { subdomains: true } } diff --git a/test/dummy/config/initializers/session_store.rb b/test/dummy/config/initializers/session_store.rb new file mode 100644 index 0000000..fcc1c91 --- /dev/null +++ b/test/dummy/config/initializers/session_store.rb @@ -0,0 +1,4 @@ +# frozen_string_literal: true +# Be sure to restart your server when you modify this file. + +Rails.application.config.session_store :cookie_store, key: '_dummy_session' diff --git a/test/dummy/config/initializers/wrap_parameters.rb b/test/dummy/config/initializers/wrap_parameters.rb new file mode 100644 index 0000000..18c3825 --- /dev/null +++ b/test/dummy/config/initializers/wrap_parameters.rb @@ -0,0 +1,15 @@ +# frozen_string_literal: true +# Be sure to restart your server when you modify this file. + +# This file contains settings for ActionController::ParamsWrapper which +# is enabled by default. + +# Enable parameter wrapping for JSON. You can disable this by setting :format to an empty array. +ActiveSupport.on_load(:action_controller) do + wrap_parameters format: [:json] +end + +# To enable root element in JSON for ActiveRecord objects. +# ActiveSupport.on_load(:active_record) do +# self.include_root_in_json = true +# end diff --git a/test/dummy/config/locales/en.yml b/test/dummy/config/locales/en.yml new file mode 100644 index 0000000..0653957 --- /dev/null +++ b/test/dummy/config/locales/en.yml @@ -0,0 +1,23 @@ +# Files in the config/locales directory are used for internationalization +# and are automatically loaded by Rails. If you want to use locales other +# than English, add the necessary files in this directory. +# +# To use the locales, use `I18n.t`: +# +# I18n.t 'hello' +# +# In views, this is aliased to just `t`: +# +# <%= t('hello') %> +# +# To use a different locale, set it with `I18n.locale`: +# +# I18n.locale = :es +# +# This would use the information in config/locales/es.yml. +# +# To learn more, please read the Rails Internationalization guide +# available at http://guides.rubyonrails.org/i18n.html. + +en: + hello: "Hello world" diff --git a/test/dummy/config/puma.rb b/test/dummy/config/puma.rb new file mode 100644 index 0000000..da41eff --- /dev/null +++ b/test/dummy/config/puma.rb @@ -0,0 +1,48 @@ +# frozen_string_literal: true +# Puma can serve each request in a thread from an internal thread pool. +# The `threads` method setting takes two numbers a minimum and maximum. +# Any libraries that use thread pools should be configured to match +# the maximum value specified for Puma. Default is set to 5 threads for minimum +# and maximum, this matches the default thread size of Active Record. +# +threads_count = ENV.fetch('RAILS_MAX_THREADS') { 5 }.to_i +threads threads_count, threads_count + +# Specifies the `port` that Puma will listen on to receive requests, default is 3000. +# +port ENV.fetch('PORT') { 3000 } + +# Specifies the `environment` that Puma will run in. +# +environment ENV.fetch('RAILS_ENV') { 'development' } + +# Specifies the number of `workers` to boot in clustered mode. +# Workers are forked webserver processes. If using threads and workers together +# the concurrency of the application would be max `threads` * `workers`. +# Workers do not work on JRuby or Windows (both of which do not support +# processes). +# +# workers ENV.fetch("WEB_CONCURRENCY") { 2 } + +# Use the `preload_app!` method when specifying a `workers` number. +# This directive tells Puma to first boot the application and load code +# before forking the application. This takes advantage of Copy On Write +# process behavior so workers use less memory. If you use this option +# you need to make sure to reconnect any threads in the `on_worker_boot` +# block. +# +# preload_app! + +# The code in the `on_worker_boot` will be called if you are using +# clustered mode by specifying a number of `workers`. After each worker +# process is booted this block will be run, if you are using `preload_app!` +# option you will want to use this block to reconnect to any threads +# or connections that may have been created at application boot, Ruby +# cannot share connections between processes. +# +# on_worker_boot do +# ActiveRecord::Base.establish_connection if defined?(ActiveRecord) +# end + +# Allow puma to be restarted by `rails restart` command. +plugin :tmp_restart diff --git a/test/dummy/config/routes.rb b/test/dummy/config/routes.rb new file mode 100644 index 0000000..40e2c71 --- /dev/null +++ b/test/dummy/config/routes.rb @@ -0,0 +1,8 @@ +# frozen_string_literal: true +Rails.application.routes.draw do + get 'dashboard/home' + + get 'dashboard/other' + + # For details on the DSL available within this file, see http://guides.rubyonrails.org/routing.html +end diff --git a/test/dummy/config/secrets.yml b/test/dummy/config/secrets.yml new file mode 100644 index 0000000..99f711d --- /dev/null +++ b/test/dummy/config/secrets.yml @@ -0,0 +1,22 @@ +# Be sure to restart your server when you modify this file. + +# Your secret key is used for verifying the integrity of signed cookies. +# If you change this key, all old signed cookies will become invalid! + +# Make sure the secret is at least 30 characters and all random, +# no regular words or you'll be exposed to dictionary attacks. +# You can use `rails secret` to generate a secure secret key. + +# Make sure the secrets in this file are kept private +# if you're sharing your code publicly. + +development: + secret_key_base: a830d3039252eba2629e9e5aa1a598d1dabe6ed9f31072063abca5b7db2d99f073d86e773fa6a7eed256c33945a1451881d0e85b1efb56c1fdf957d1c8fb0a10 + +test: + secret_key_base: f40f5e4311e123e88dc1d6aa3b6c19531a7c6eb1b1087f45ab0cefbec2fa5373ba8a75091efdbe98fcd0cbf85637b5dcdb6cf94c75070a848c925392d59c8b20 + +# Do not keep production secrets in the repository, +# instead read values from the environment. +production: + secret_key_base: <%= ENV["SECRET_KEY_BASE"] %> diff --git a/test/dummy/config/spring.rb b/test/dummy/config/spring.rb new file mode 100644 index 0000000..312295f --- /dev/null +++ b/test/dummy/config/spring.rb @@ -0,0 +1,7 @@ +# frozen_string_literal: true +%w( + .ruby-version + .rbenv-vars + tmp/restart.txt + tmp/caching-dev.txt +).each { |path| Spring.watch(path) } diff --git a/test/dummy/config/tours/dashboard/home.en.yml b/test/dummy/config/tours/dashboard/home.en.yml new file mode 100644 index 0000000..34c8cfc --- /dev/null +++ b/test/dummy/config/tours/dashboard/home.en.yml @@ -0,0 +1,13 @@ +intro: + steps: + 1: + text: "ENGLISH This first HOME step is centered text-only" + 2: + title: "ENGLISH This step has a title" + text: "ENGLISH This intermediate step has some text" + 3: + title: "ENGLISH The final step" + text: "ENGLISH Some text here too, and it's attached to the right" + attachTo: + element: ".notice-me" + position: "right" diff --git a/test/dummy/config/tours/dashboard/home.es.yml b/test/dummy/config/tours/dashboard/home.es.yml new file mode 100644 index 0000000..ff645c0 --- /dev/null +++ b/test/dummy/config/tours/dashboard/home.es.yml @@ -0,0 +1,13 @@ +intro: + steps: + 1: + text: "SPANISH This first HOME step is centered text-only" + 2: + title: "SPANISH This step has a title" + text: "This intermediate step has some text" + 3: + title: "SPANISH The final step" + text: "Some text here too, and it's attached to the right" + attachTo: + element: ".notice-me" + position: "right" diff --git a/test/dummy/config/tours/dashboard/other.en.yml b/test/dummy/config/tours/dashboard/other.en.yml new file mode 100644 index 0000000..3f4e290 --- /dev/null +++ b/test/dummy/config/tours/dashboard/other.en.yml @@ -0,0 +1,11 @@ +tour_one: + steps: + 1: + title: "TOUR ONE step one ENGLISH" + text: "we show this on your first visit" + +tour_two: + steps: + 1: + title: "TOUR TWO step one ENGLISH" + text: "we show this on your second visit" diff --git a/test/dummy/db/development.sqlite3 b/test/dummy/db/development.sqlite3 new file mode 100644 index 0000000..ad2b360 Binary files /dev/null and b/test/dummy/db/development.sqlite3 differ diff --git a/test/dummy/db/migrate/20161118143752_create_abraham_histories.rb b/test/dummy/db/migrate/20161118143752_create_abraham_histories.rb new file mode 100644 index 0000000..295ebdd --- /dev/null +++ b/test/dummy/db/migrate/20161118143752_create_abraham_histories.rb @@ -0,0 +1,13 @@ +# frozen_string_literal: true +class CreateAbrahamHistories < ActiveRecord::Migration[5.0] + def change + create_table :abraham_histories do |t| + t.string :controller_name + t.string :action_name + t.string :tour_name + t.references :creator, null: false, index: true + + t.timestamps index: true + end + end +end diff --git a/test/dummy/db/schema.rb b/test/dummy/db/schema.rb new file mode 100644 index 0000000..17fe716 --- /dev/null +++ b/test/dummy/db/schema.rb @@ -0,0 +1,26 @@ +# frozen_string_literal: true +# This file is auto-generated from the current state of the database. Instead +# of editing this file, please use the migrations feature of Active Record to +# incrementally modify your database, and then regenerate this schema definition. +# +# Note that this schema.rb definition is the authoritative source for your +# database schema. If you need to create the application database on another +# system, you should be using db:schema:load, not running all the migrations +# from scratch. The latter is a flawed and unsustainable approach (the more migrations +# you'll amass, the slower it'll run and the greater likelihood for issues). +# +# It's strongly recommended that you check this file into your version control system. + +ActiveRecord::Schema.define(version: 20_161_118_143_752) do + create_table 'abraham_histories', force: :cascade do |t| + t.string 'controller_name' + t.string 'action_name' + t.string 'tour_name' + t.integer 'creator_id', null: false + t.datetime 'created_at', null: false + t.datetime 'updated_at', null: false + t.index ['created_at'], name: 'index_abraham_histories_on_created_at' + t.index ['creator_id'], name: 'index_abraham_histories_on_creator_id' + t.index ['updated_at'], name: 'index_abraham_histories_on_updated_at' + end +end diff --git a/test/dummy/db/test.sqlite3 b/test/dummy/db/test.sqlite3 new file mode 100644 index 0000000..2b032ab Binary files /dev/null and b/test/dummy/db/test.sqlite3 differ diff --git a/test/dummy/lib/assets/.keep b/test/dummy/lib/assets/.keep new file mode 100644 index 0000000..e69de29 diff --git a/test/dummy/log/.keep b/test/dummy/log/.keep new file mode 100644 index 0000000..e69de29 diff --git a/test/dummy/public/404.html b/test/dummy/public/404.html new file mode 100644 index 0000000..b612547 --- /dev/null +++ b/test/dummy/public/404.html @@ -0,0 +1,67 @@ + + + + The page you were looking for doesn't exist (404) + + + + + + +
+
+

The page you were looking for doesn't exist.

+

You may have mistyped the address or the page may have moved.

+
+

If you are the application owner check the logs for more information.

+
+ + diff --git a/test/dummy/public/422.html b/test/dummy/public/422.html new file mode 100644 index 0000000..a21f82b --- /dev/null +++ b/test/dummy/public/422.html @@ -0,0 +1,67 @@ + + + + The change you wanted was rejected (422) + + + + + + +
+
+

The change you wanted was rejected.

+

Maybe you tried to change something you didn't have access to.

+
+

If you are the application owner check the logs for more information.

+
+ + diff --git a/test/dummy/public/500.html b/test/dummy/public/500.html new file mode 100644 index 0000000..061abc5 --- /dev/null +++ b/test/dummy/public/500.html @@ -0,0 +1,66 @@ + + + + We're sorry, but something went wrong (500) + + + + + + +
+
+

We're sorry, but something went wrong.

+
+

If you are the application owner check the logs for more information.

+
+ + diff --git a/test/dummy/public/apple-touch-icon-precomposed.png b/test/dummy/public/apple-touch-icon-precomposed.png new file mode 100644 index 0000000..e69de29 diff --git a/test/dummy/public/apple-touch-icon.png b/test/dummy/public/apple-touch-icon.png new file mode 100644 index 0000000..e69de29 diff --git a/test/dummy/public/favicon.ico b/test/dummy/public/favicon.ico new file mode 100644 index 0000000..e69de29 diff --git a/test/dummy/test/controllers/abraham_histories_controller_test.rb b/test/dummy/test/controllers/abraham_histories_controller_test.rb new file mode 100644 index 0000000..26ace95 --- /dev/null +++ b/test/dummy/test/controllers/abraham_histories_controller_test.rb @@ -0,0 +1,10 @@ +# frozen_string_literal: true +require 'test_helper' + +class AbrahamHistoriesControllerTest < ActionDispatch::IntegrationTest + test 'should create AbrahamHistory' do + assert_difference ['AbrahamHistory.count'] do + post abraham_histories_url, as: :json, params: { abraham_history: { action_name: 'foo', controller_name: 'bar', tour_name: 'baz' } } + end + end +end diff --git a/test/dummy/test/controllers/dashboard_controller_test.rb b/test/dummy/test/controllers/dashboard_controller_test.rb new file mode 100644 index 0000000..183c6e5 --- /dev/null +++ b/test/dummy/test/controllers/dashboard_controller_test.rb @@ -0,0 +1,56 @@ +# frozen_string_literal: true +require 'test_helper' + +class DashboardControllerTest < ActionDispatch::IntegrationTest + test 'uses configured shepherd theme' do + # default + get dashboard_home_url + assert_response :success + assert_select 'body script' do |element| + # it's the home tour + assert element.text.include? "classes: 'shepherd-theme-default'" + end + + # custom + Rails.configuration.abraham.default_theme = 'my-custom-theme' + get dashboard_home_url + assert_select 'body script' do |element| + # it's the home tour + assert element.text.include? "classes: 'my-custom-theme'" + end + end + + test 'home should have home tour code' do + get dashboard_home_url + assert_response :success + + assert_select 'body script' do |element| + # it's the home tour + assert element.text.include? 'ENGLISH This first HOME step is centered text-only' + # it has three steps + assert element.text.include? 'step-1' + assert element.text.include? 'step-2' + assert element.text.include? 'step-3' + # it will post the right completion information + assert element.text.include? "controller_name: 'dashboard'" + assert element.text.include? "action_name: 'home'" + assert element.text.include? "tour_name: 'intro'" + end + end + + test 'other should have other tour code' do + get dashboard_other_url + assert_response :success + + assert_select 'body script' do |element| + # it's the home tour + assert element.text.include? 'TOUR ONE step one ENGLISH' + # it has only one steps + assert element.text.include? 'step-1' + # it will post the right completion information + assert element.text.include? "controller_name: 'dashboard'" + assert element.text.include? "action_name: 'other'" + assert element.text.include? "tour_name: 'tour_one'" + end + end +end diff --git a/test/dummy/tmp/.keep b/test/dummy/tmp/.keep new file mode 100644 index 0000000..e69de29 diff --git a/test/install_generator_test.rb b/test/install_generator_test.rb new file mode 100644 index 0000000..3cc0d96 --- /dev/null +++ b/test/install_generator_test.rb @@ -0,0 +1,48 @@ +# frozen_string_literal: true +require 'test_helper' +require 'rails/generators' +require 'generators/abraham/install_generator' + +class InstallGeneratorTest < Rails::Generators::TestCase + tests Abraham::Generators::InstallGenerator + destination File.expand_path('../../tmp', __FILE__) + + setup :prepare_destination + + test 'should generate a migration' do + begin + run_generator + assert_migration 'db/migrate/create_abraham_histories' + ensure + FileUtils.rm_rf destination_root + end + end + + test 'should skip the migration when told to do so' do + begin + run_generator ['--skip-migration'] + assert_no_migration 'db/migrate/create_abraham_histories' + ensure + FileUtils.rm_rf destination_root + end + end + + test 'should generate an initializer' do + begin + run_generator + assert_file 'config/initializers/abraham.rb' + assert_file 'config/abraham.yml' + ensure + FileUtils.rm_rf destination_root + end + end + + test 'should skip the initializer when told to do so' do + begin + run_generator ['--skip-initializer'] + assert_no_file 'config/initializers/abraham.rb' + ensure + FileUtils.rm_rf destination_root + end + end +end diff --git a/test/integration/navigation_test.rb b/test/integration/navigation_test.rb new file mode 100644 index 0000000..3c97384 --- /dev/null +++ b/test/integration/navigation_test.rb @@ -0,0 +1,8 @@ +# frozen_string_literal: true +require 'test_helper' + +class NavigationTest < ActionDispatch::IntegrationTest + # test "the truth" do + # assert true + # end +end diff --git a/test/models/abraham_history_test.rb b/test/models/abraham_history_test.rb new file mode 100644 index 0000000..de50c1b --- /dev/null +++ b/test/models/abraham_history_test.rb @@ -0,0 +1,8 @@ +# frozen_string_literal: true +require 'test_helper' + +class AbrahamHistoryTest < ActiveSupport::TestCase + # test "the truth" do + # assert true + # end +end diff --git a/test/test_helper.rb b/test/test_helper.rb new file mode 100644 index 0000000..af68d44 --- /dev/null +++ b/test/test_helper.rb @@ -0,0 +1,11 @@ +# frozen_string_literal: true +# Configure Rails Environment +ENV['RAILS_ENV'] = 'test' + +require File.expand_path('../../test/dummy/config/environment.rb', __FILE__) +ActiveRecord::Migrator.migrations_paths = [File.expand_path('../../test/dummy/db/migrate', __FILE__)] +require 'rails/test_help' + +# Filter out Minitest backtrace while allowing backtrace from other libraries +# to be shown. +Minitest.backtrace_filter = Minitest::BacktraceFilter.new