upgrade_surveyor_gui 0.1.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9ebcb45c5d3837056bfd1a774f0773f0ef6e5a2c4d8e73c89925ea9666684bb3
+  data.tar.gz: ae6fc2bd04e6dc3598079c468d2b514e304ec2131a9dad972b204d82dc6d6ad0
+SHA512:
+  metadata.gz: e497d87dcfcb4870a0a6e829866710590e7d32e818d1e6d4f1fb248d94960839a938dc5a79de40290bb404e70f6a68cc89bb688270d5f984af9c8abddf5bcb4a
+  data.tar.gz: bbd9098c4e78fa7af9d14e629630e811eaa85b0f1583595224648a58de3995da91d2f913f0f90857c830408e3b95afee70928202c21b53c0eb525d643fe0314b

data/.gitignore

@@ -0,0 +1,44 @@
+*~
+*.rbc
+*.sassc
+.sass-cache
+capybara-*.html
+.rspec
+.rvmrc
+/vendor/bundle
+/log/*
+log/*
+/tmp/*
+/public/system/*
+/coverage/
+/spec/tmp/*
+**.orig
+**.swp
+rerun.txt
+pickle-email-*.html
+.project
+config/initializers/secret_token.rb
+# See http://help.github.com/ignore-files/ for more about ignoring files.
+#
+# If you find yourself ignoring temporary files generated by your text editor
+# or operating system, you probably want to add a global ignore instead:
+#   git config --global core.excludesfile ~/.gitignore_global
+
+# Ignore bundler config
+/.bundle
+
+# Ignore the default SQLite database.
+/db/*.sqlite3
+
+# Ignore all logfiles and tempfiles.
+/log/*.log
+/tmp
+
+# Ignore testbed
+testbed
+
+# Ignore RVM directives
+.ruby-version
+.ruby-gemset
+
+Gemfile.lock

data/.travis.yml

@@ -0,0 +1,17 @@
+language: ruby
+rvm:
+- 2.0.0
+- 2.1.1
+env:
+- "RAILS_VERSION=4.0.8"
+- "RAILS_VERSION=4.1.4"
+script:
+- bundle exec rake gui_testbed
+- bundle exec rspec 
+notifications:
+email:
+recipients:
+- kjayma@gmail.com 
+on_success: change # [always|never|change] # default: change
+on_failure: always # [always|never|change] # default: always
+

data/CHANGELOG.md

@@ -0,0 +1,46 @@
+History for Surveyor
+====================
+0.1.2
+------
+### Fixes
+
+- Adds statistics back to repeating group questions
+
+0.1.1
+------
+
+### Fixes
+
+- Restores ability to add new questions to groups
+
+- Suppresses redundant data from being show on repeating group questions
+
+0.1.0
+------
+
+### Features
+
+- This gem is now a mountable engine and uses isolate_namespace.
+
+### Fixes
+
+- Fixes error on preview report in which no users are shown and report data is empty.  Will now show fake user names.
+- Fixes error on preview response and show response when dependencies are set. Also shows correct user name on reponse
+  index.
+
+0.0.3
+------
+
+### Features
+
+- Official support for Rails 4.0.  Will work generally work with 4.1 but, Surveyor, a critical dependency, is not officially supported on 4.1.
+
+- Supports survey creation and reporting.
+
+- Provides preview of how surveys and reports will look as you are building a survey.
+
+### Fixes
+
+
+### Infrastructure
+

data/Gemfile

@@ -0,0 +1,8 @@
+source "https://rubygems.org"
+
+# gem 'surveyor', git: 'https://github.com/prateeksinghbundela/surveyor'
+gem 'upgrade_surveyor'
+gem 'dynamic_form', git: 'https://github.com/prateeksinghbundela/dynamic_form'
+# Bundler will treat runtime dependencies like base dependencies, and
+# development dependencies will be added by default to the :development group.
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 
+
+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/MIT-LICENSE

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

data/README.md

@@ -0,0 +1,244 @@
+surveyor_gui 
+============
+[![Gem Version](https://badge.fury.io/rb/surveyor_gui.svg)](http://badge.fury.io/rb/surveyor_gui)
+## Add Surveys to your Rails application
+
+Need a way to quickly add surveys to your Rails application?  Need a way for users to create customizable surveys with little or no training?  Need reports and graphs out of the box?  Don't want to use a third-party service or closed solution?
+
+Surveyor_gui can help!
+
+You can add surveyor_gui to a new or existing rails application to provide a way to create and administer surveys.
+
+You can find some screenshots at the bottom of this README.
+
+Builds on the popular Surveyor gem
+============
+
+Surveyor_gui is built over Surveyor gem.
+
+Surveyor does some things really well.  Surveyor can be used to build rich surveys with a wide variety of questions types, and it provides a web page for users to take those surveys.  However, it lacks two key abilities - the ability to build and edit surveys using a browser and to report on survey results without additional coding.  In order to build a survey using Surveyor, you need to create a text file using Surveyor's DSL, and then call a Rake task to parse it.  
+
+The lack of a gui front-end and reports limits the utility of surveyor for certain applications.
+
+Surveyor_gui meets this need by providing a gui to create surveys from scratch.  Surveyor_gui bypasses the need to create a Surveyor DSL file, and directly updates the Surveyor tables to build a survey.
+
+Surveyor is feature-rich and can create very complex surveys.  Surveyor-gui supports most of the features in Surveyor.
+
+This gem also provides a reporting capability for Surveyor.
+
+Surveyor_gui is a mountable engine.
+
+## Requirements
+
+SurveyorGui works with:
+
+* Ruby 2.6.5
+* Rails 6.0
+
+
+Some key dependencies are:
+
+* Surveyor
+* HAML
+* Sass
+* Formtastic
+
+A more exhaustive list can be found in the gemspecs for Surveyor [surveyor] and Surveyor_gui [surveyor-gui][].
+
+[surveyor]: https://github.com/NUBIC/surveyor/blob/master/surveyor.gemspec
+[surveyor-gui]: https://github.com/Sandeepcoder98/surveyor_gui/blob/master/surveyor_gui.gemspec
+[policy]: http://weblog.rubyonrails.org/2013/2/24/maintenance-policy-for-ruby-on-rails/
+## Install
+
+Add surveyor and surveyor-gui to your Gemfile:
+
+    gem 'surveyor', github: 'NUBIC/surveyor'
+    gem 'surveyor_gui', github: 'Sandeepcoder98/surveyor_gui'
+
+You will also need a javascript runtime, like node.js or therubyracer.  If you
+have not yet installed one, add
+
+    gem "therubyracer"
+
+to your Gemfile.
+
+Bundle, install, and migrate:
+
+    bundle install
+    rails g surveyor_gui:install
+
+Note that the installer will run db:migrate (so any un-applied migrations you have in your project will be pulled in).
+
+You will need to add mountpoints to your routes.rb file.  E.g., a starting routes.rb might look like this:
+
+
+    Rails.application.routes.draw do
+      mount SurveyorGui::Engine => "/surveyor_gui", :as => "surveyor_gui"
+      mount Surveyor::Engine => "/surveys", :as => "surveyor"
+    end
+
+SurveyorGui::Engine points to the survey editor.  Surveyor::Engine points to the url where users will take the surveys.
+The routes.rb file in the testbed application (see Test Environment section) uses the default mountpoints noted above, however
+they are arbitrary and can be change to anything you would prefer (e.g., mount SurveyorGui::Engine => "my/survey/engine", :as => "surveyor_gui").
+
+## Limitations
+
+This gem provides support for a subset of the Surveyor functionality.  It supports all of the basic question types, and
+most of the complicated question types, but does not currently support the following:
+
+  - Questions with multiple entries (e.g., the "Get me started on an improv sketch" question in the kitchen_sink_survey.rb that comes
+    with the Surveyor gem.
+  - Input masks
+  - Quizzes
+
+It adds some new question types:
+
+  - Star rating (1-5 stars)
+  - File upload
+  - Grid dropdown (a grid of dropdowns with up to ten columns.)
+
+Dependencies are partially supported.  The following are not currently supported:
+
+- counts (count the number of answers checked or entered)
+- Regexp validations
+
+You can open the kitchen_sink survey that comes with Surveyor, but a few of the questions will not behave as expected
+because of the discrepancies noted above.
+
+## Locking
+
+This gem enforces locking on surveys.  A survey may be modified up until a user submits a response.  At that point, the survey
+can no longer be edited for structural changes (i.e., /surveyform/edit will not permit any changes).  This protects the
+data integrity of the survey response data.
+
+If you want to unlock a survey, you will need to manually delete all of the child ResponseSet records (e.g.,
+Survey.find(1).response_set.all.each{|r| r.destroy} ). Use appropriate caution!
+
+## Templates
+
+Surveys may be saved as templates.  This allows them to be cloned when creating a new survey (cloning is a pending feature).  It is
+possible to mark certain parts of a survey as unmodifiable so that they will always be present when a survey is cloned.
+  
+A template library feature is pending.
+
+## Test environment
+
+If you want to try out surveyor-gui before incorporating it into an application, or contribute, clone the repository.
+Then run
+
+    bundle install
+    bundle exec rake gui_testbed
+    cd testbed
+
+Start the rails server.
+
+The survey editor can be found at '/surveyor_gui/surveyforms'.  Take surveys by going to the '/surveys' url or clicking the
+link at the bottom of the surveyforms home page.
+
+Before contributing, please run the tests:
+    bundle exec rspec spec
+
+## Reports
+
+Surveyor_gui now provides reports!  
+
+You can see a report of all survey responses, or view an individual response.
+
+Highcharts.js is used for graphics, and must be licensed for commercial use.  Future development will replace Highcharts with Rickshawgraphs.
+
+To see reports, try using the "Preview Reports" button on the survey editor, or take the survey and try
+"localhost:3000/surveyor_gui/reports/:id/show" where :id is the survey id.  Preview reports will create some dummy
+responses using randomized answers.  
+
+You can also view an individual response at "localhost:3000/surveyor_gui/results/:id/show".
+
+## Use of Devise and additional customization
+
+### Devise
+Surveyor_Gui will work with Devise or like gems.
+
+Surveyor_gui adds a user_id attribute to the Survey model.  It will try to set user_id to current_user when a new survey
+is defined.  The gem does not provide any access control over survey creation and update, but you can add that to your
+application using the user_id attribute.
+
+In addition, the underlying Surveyor gem provides a user_id attribute in the ResponseSet model.  When responses are created, it will
+try to set the user_id to current_user.
+
+Surveyor_gui reports assume there will be a unique user for eash Survey response, and reports on results by user.
+If the response set has a user id, (which will be the case if you've setup Devise in the typical way) it will identify the response by user_id.  If no user_id is available, it will
+default to the response_set.id.
+
+You may want to identify users by something other than id on reports.  This can be done easily.  
+
+Surveyor_gui creates a response_set_user.rb file in your app/models directory.  Edit it to define the identifier you would like to use for users in reports.  For instance, if your user model is User, and you would like to see the user's email address on reports, edit the file as follows...
+
+In the initialize method, add the following line:
+
+    @user = User.find(user_id)
+
+In the report_user_name method, add the following line:
+
+    @user ? @user.email : nil
+
+If you wanted the users full name, you could add something like this:
+
+    @user ? @user.last_name + ', ' + @user.first_name : nil
+
+Note that SurveyorGui controllers expect to use surveyor_gui's own layout view, surveyor_gui_default.rb.  A copy will be placed in your application's app/views/layouts directory.  You may need edit it for various reasons, such as adding a Devise login/logout link.  Keep in mind that surveyor_gui works in an isolated namespace, so devise helpers need to be namespaced to the main app. That means that any view local to surveyor_gui would need to refer to Devise's new_user_registration_path as main_app.new_user_registration_path.  If you wanted to add a login/logout link to the surveyor_gui_default layout, you might add something like this:
+
+    <% if user_signed_in? %>
+      Logged in as <strong><%= current_user.email %></strong>.
+      <%= link_to 'Edit profile', main_app.edit_user_registration_path %> |
+      <%= link_to "Logout", main_app.destroy_user_session_path, method: :delete %>
+    <% else %>
+      <%= link_to "Sign up", main_app.new_user_registration_path %> |
+      <%= link_to "Login", main_app.new_user_session_path %>
+    <% end %>
+
+### Additional Customization
+
+If you need to perform more extensive customization of Surveyor_gui, take a look at NUBIC/surveyor for customization documentation.  The process of customizing Surveyor_gui is largely the same.  There are a couple of points to keep in mind.  As mentioned above, Surveyor_gui expects its own layout view.  If you need to change it or override the default layout in your own custom SurveyorController, make sure to add the following html (or HAML equivalent):
+
+     <div id="surveyor-gui-mount-point" data-surveyor-gui-mount-point="<%= surveyor_gui.surveyforms_path %>"></div>
+
+This snippet of code allows the javascript files to find the correct mountpoint for the Surveyor_gui gem, which, as mentioned above, may be modified to suit your needs.  You will also need to add javascript and stylesheet include tags for surveyor_gui_all.
+
+If you wish to customize the SurveyorController, add the following snippet to the top of your conroller:
+
+     include Surveyor::SurveyorControllerMethods
+     include SurveyorControllerCustomMethods
+ 
+These statements are necessary if calling super from within your customized methods.  Be sure to insert the statements in the order shown above.
+
+If customizing models, you'll need to include both the Surveyor and Surveyor_gui libraries.  For instance, to customize question.rb, start with the following shell:
+
+    class Question < ActiveRecord::Base
+      include Surveyor::Models::QuestionMethods
+      include SurveyorGui::Models::QuestionMethods
+    end
+
+Take a look at the surveyor_gui/app/models directory for examples.    
+
+## Surveyor
+
+Please take a look at the NUBIC/surveyor on github.  The README.doc file will help you to understand how the surveyor engine works.  Also, the wiki has a very useful data diagram that will help you to grasp the data
+structure of the surveys and responses.
+
+
+## Screenshots
+
+### Manage surveys
+
+![](https://raw.github.com/kjayma/surveyor_gui/screenshots/Screenshot%20from%202014-09-16%2016:54:18.png)
+
+### Build surveys
+
+![](https://raw.github.com/kjayma/surveyor_gui/screenshots/Screenshot%20from%202014-09-16%2016:59:36.png)
+
+### Add questions
+
+![](https://raw.github.com/kjayma/surveyor_gui/screenshots/Screenshot%20from%202014-09-16%2017:03:57.png)
+
+### Get reports
+
+![](https://raw.githubusercontent.com/kjayma/surveyor_gui/screenshots/Screenshot%20from%202014-09-16%2017:04:41.png)

data/Rakefile

@@ -0,0 +1,66 @@
+$LOAD_PATH << File.expand_path('../lib', __FILE__)
+
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+###### RSPEC
+
+RSpec::Core::RakeTask.new(:spec)
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.rcov = true
+end
+
+task :default => :spec
+
+
+###### TESTBED
+
+desc 'Set up the rails app that the specs and features use'
+task :gui_testbed => 'gui_testbed:rebuild'
+
+namespace :gui_testbed do
+  desc 'Generate a minimal surveyor_gui/surveyor rails app'
+  task :generate do
+    sh "bundle exec rails new testbed --skip-bundle" # don't run bundle install until the Gemfile modifications
+
+    chdir('testbed') do
+      gem_file_contents = File.read('Gemfile')
+      gem_file_contents.sub!(/^(gem 'rails'.*)$/, %Q{ \\1\nplugin_root = File.expand_path('../..', __FILE__)\ngem 'surveyor_gui', :path => plugin_root\ngem 'therubyracer'\ngem 'surveyor', github: 'NUBIC/surveyor'})
+
+      File.open('Gemfile', 'w'){|f| f.write(gem_file_contents) }
+
+      # not sure why turbolinks gives test problems, anyway better to avoid it?
+      js_file_contents = File.read('app/assets/javascripts/application.js')
+      js_file_contents.sub!('//= require turbolinks', '')
+      File.open('app/assets/javascripts/application.js', 'w'){|f| f.write(js_file_contents) }
+
+      Bundler.with_clean_env do
+        sh 'bundle install' # run bundle install after Gemfile modifications
+      end
+    end
+  end
+
+  desc 'Remove the testbed entirely'
+  task :remove do
+    rm_rf 'testbed'
+  end
+
+  desc 'Prepare the databases for the testbed'
+  task :migrate do
+    chdir('testbed') do
+      Bundler.with_clean_env do
+        sh 'bundle exec rails generate simple_form:install'
+        sh 'bundle exec rake highcharts:update'
+        sh 'bundle exec rails generate surveyor:install'
+        sh 'bundle exec rake db:migrate db:test:prepare'
+        sh 'bundle exec rails generate surveyor_gui:install'
+        sh 'bundle exec rake db:migrate db:test:prepare'
+        sh 'bundle exec rake surveyor FILE=surveys/kitchen_sink_survey.rb'
+      end
+    end
+  end
+
+  task :rebuild => [:remove, :generate, :migrate]
+end