softwear-lib 3.1.5 → 3.3.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0525b8c27ab7c6762367aa3ea551f1754ca70796
-  data.tar.gz: fd7c8d8c48bc75f5061ae99cc8ceadfff1b3bf03
+  metadata.gz: 061c8fef433bb6d6ba33834ed5e769907dd54722
+  data.tar.gz: ff88cfad72f88e87eca1360c9cba5ae0df211e9a
 SHA512:
-  metadata.gz: f3210964ea6c7a6d91aca1cef1ef18d80746bd25e4ea853edc02595ad6eb6f402e70312efcad6e170765eaf33aed316cc3ed0e27bdc96898ca10e118bf2a4ce5
-  data.tar.gz: 6624741f606adad42442fb4ca5c1f6f750d7c7675c65be2868c1047ba99db5f94aee3ef7c48b01b5f283307a995f783fbe64043d5c4d89154ff379b85863f874
+  metadata.gz: 644e51672e6d4517e81f28bb1bfdf666b1fd6abcdf32b95378a1bf07dbda5030fafd1a5a3bb64553cd4d5da781d2039cc4d2aefb229c738d46f58d428a7ba4f5
+  data.tar.gz: 941059409053e3f121070319f85c7b5f8c14d6b8d04cde00cd17a94ad6172a69c0566b98c5446489890ac5295d7f0598b38ba80fcc11585c586e4fb9beb15e65

data/README.md

@@ -1,7 +1,5 @@
 # Softwear::Lib
 
-TODO: Write a gem description
-
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -12,17 +10,29 @@ gem 'softwear-lib'
 
 And then execute:
 
-    $ bundle
+```bash
+$ bundle install
+```
 
-Or install it yourself as:
+# Usage
 
-    $ gem install softwear-lib
+## Database capture
+This feature will capture a generous subset of the production (or development)
+database into a spec. This serves 2 main purposes:
 
-## Usage
+1. to quickly convert hand-tested data into a spec without writing complex factories, and
+2. to isolate and begin testing a faulty set of live data before fully understanding the problem
 
-To use apps locally without auth_server:
-<br />
-<br />
+To run:
+```bash
+bundle exec softwear capture
+```
+Then, follow the prompts. You will be asked for model name, record ID,
+which spec file to append, and a few optional identifiers for the
+generated spec.
+
+
+## Local authentication
 <code>$ AUTH_SERVER=false bundle exec rails s</code>
 <br />
 <br />
@@ -31,11 +41,11 @@ Uses data from local users.yml.
 
 Expected format for users.yml:
 
-<pre>
-user's email:
-  first_name: user's first name
-  last_name: user's last name
-  profile_picture: local file location
+```yaml
+"user's email":
+  first_name: "user's first name"
+  last_name: "user's last name"
+  profile_picture: local/file/location
   roles:
     - role1
     - role2
@@ -44,34 +54,25 @@ user's email:
     - right1
     - right2
     - rightn
-</pre>
+```
 
-To include error handling in your app, add:
-<br />
-<pre>
-Include Softwear::ErrorCatcher
+## Error handling
+```ruby
+# In ApplicationController
+include Softwear::ErrorCatcher
 helper Softwear::Auth::EmailsHelper
-</pre>
+```
 to your application controller.
-<br />
-<br />
+
+
 For error styling and animation add:
-<br />
-<pre>
+
+```css
 *= require animate/animate
 
 .box-info-error{
   background: "your desired color here";
 }
-</pre>
+```
 to your application.css file.
 
-
-
-## Contributing
-
-1. Fork it ( https://github.com/[my-github-username]/softwear-lib/fork )
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create a new Pull Request

data/app/controllers/softwear/error_reports_controller.rb

@@ -3,7 +3,12 @@ module Softwear
     skip_before_action :authenticate_user! rescue nil
     before_action :assign_current_user, only: :email_report
 
+    controller = self
     helper Softwear::Engine.helpers do
+      define_method :current_user do
+        controller.instance_variable_get(:@current_user)
+      end
+
       def method_missing(name, *args, &block)
         if main_app.respond_to?(name)   
           main_app.send(name, *args, &block)

data/app/controllers/softwear/spec_dump_controller.rb

@@ -0,0 +1,22 @@
+module Softwear
+  class SpecDumpController < ApplicationController
+    include Library::SpecDump
+
+    helper Softwear::Engine.helpers do
+      def method_missing(name, *args, &block)
+        if main_app.respond_to?(name)   
+          main_app.send(name, *args, &block)
+        else                   
+          super                
+        end                    
+      end
+    end
+
+    def dump
+      type = params[:type].classify
+      id   = params[:id].to_i
+
+      render json: spec_dump(type.constantize.find(id))
+    end
+  end
+end

data/app/mailers/error_report_mailer.rb

@@ -64,12 +64,16 @@ class ErrorReportMailer < ActionMailer::Base
   private 
 
   def app_name
+    name = Figaro.env.hub_app_name
+    return name if name.present?
+
     case Rails.application.class.parent.to_s
-    when "CrmSoftwearcrmCom"  then return "Softwear CRM"
-    when "RetailPublishing"   then return "Softwear Mockbot"
-    when "SoftwearProduction" then return "Softwear Production"
-    when "SoftwearHub"        then return "Softwear Hub"
-    when "AnnarborteesFba"    then return "Softwear Fba"
+    when "CrmSoftwearcrmCom"  then return "SoftWEAR CRM"
+    when "RetailPublishing"   then return "SoftWEAR Mockbot"
+    when "SoftwearProduction" then return "SoftWEAR Production"
+    when "SoftwearHub"        then return "SoftWEAR Hub"
+    when "AnnarborteesFba"    then return "SoftWEAR Fba"
+    when "SoftwearRetail"     then return "SoftWEAR Retail"
     when "AnnarborteesWww"    then return "Ann Arbor Tees WWW"
     else
       return "Unknown App"

data/bin/softwear

@@ -1,51 +1,11 @@
 #!/usr/bin/env ruby
-
 require 'softwear/lib'
 
-if ARGV.length > 0 && ARGV[0] == 'update'
-  old_gemfile = File.open('Gemfile').read.gsub(/\r\n?/, "\n")
-  gemfile = []
-
-  handler = nil
-  append_line = nil
-
-  injected_gems = false
-
-  ignore_line = lambda do |line|
-    if line.include? Softwear::Lib::GEMFILE_CLOSER
-      gemfile << line
-      handler = append_line
-    end
-  end
-
-  append_line = lambda do |line|
-    gemfile << line
-    if line.include? Softwear::Lib::GEMFILE_OPENER
-      puts "Updating common gems"
-      gemfile << Softwear::Lib::COMMON_GEMS
-      injected_gems = true
-      handler = ignore_line
-    end
-  end
-
-  handler = append_line
-  old_gemfile.each_line do |line|
-    handler.call(line)
-  end
-
-  unless injected_gems
-    puts "Adding common gems - check for duplicates!"
-    gemfile << "\n" + Softwear::Lib::GEMFILE_OPENER + "\n"
-    gemfile << Softwear::Lib::COMMON_GEMS
-    gemfile << Softwear::Lib::GEMFILE_CLOSER + "\n"
-  end
+if ARGV.length > 0
+  dir  = File.dirname(__FILE__)
+  file = "#{dir}/softwear-#{ARGV[0]}"
 
-  File.open('Gemfile', 'w') do |file|
-    gemfile.each do |line|
-      file.write(line)
-    end
-  end
-  puts "Done!"
+  exec "bundle exec #{file} #{ARGV[1..-1].map(&:inspect).join(' ')}"
 else
   puts "Run `softwear update` to update your gemfile's common dependencies"
 end

data/bin/softwear-capture

@@ -0,0 +1,225 @@
+#!/usr/bin/env ruby
+require 'softwear/library/spec_dump'
+require 'tty/prompt'
+require 'tty/spinner'
+require 'pastel'
+require 'liquid'
+include Softwear::Library::SpecDump
+
+LIB_DIR = File.expand_path File.join(File.dirname(__FILE__), '..')
+PROMPT = TTY::Prompt.new
+PASTEL = Pastel.new
+
+class Capture
+  attr_reader :model_name
+  attr_reader :model
+  attr_reader :ids
+  attr_reader :records
+  attr_reader :data
+  attr_reader :capture_name
+  attr_reader :capture_path
+  attr_reader :capture_fullpath
+  attr_reader :spec_file
+  attr_reader :spec_desc
+  attr_reader :spec_fullpath
+  attr_reader :whitelist
+  attr_accessor :step
+  attr_reader :complete
+  @@steps = []
+
+  def self.step(method_name)
+    @@steps << method_name
+  end
+
+  def self.steps
+    @@steps
+  end
+
+  def human_step
+    step.to_s.humanize
+  end
+
+  def step_index
+    self.class.steps.index(step)
+  end
+
+  def prompt
+    PROMPT
+  end
+
+  def initialize
+    @step = @@steps.first
+    @complete = false
+  end
+
+  def increment_step
+    @step = @@steps[@@steps.index(@step) + 1]
+    if @step == nil
+      @complete = true
+    end
+    @step
+  end
+
+  def decrement_step
+    @step = @@steps[@@steps.index(@step) - 1]
+    @step = @@steps.first if @step.nil?
+    @step
+  end
+
+  def done?
+    @step.nil?
+  end
+
+  def complete?
+    complete
+  end
+
+  def execute!
+    send(@step)
+  end
+
+  def ignored_regexps
+    return [] if @ignored.try(:strip).blank?
+    @ignored.split(',').map { |x| Regexp.new(x.strip) }
+  end
+
+
+  step def initialize_rails
+    ENV['RAILS_ENV'] ||= prompt.ask "RAILS_ENV?", default: "development"
+    puts "Okay one sec (loading rails environment)"
+    Kernel.require "#{Dir.pwd}/config/environment"
+  end
+
+
+  step def find_records
+    @model_name = (ENV['MODEL'] || prompt.ask("Model to pull?", default: @model_name)).classify
+    @model      = model_name.constantize
+    @ids        = prompt.ask("#{model_name} ID?", default: @ids.try(:join, ',')).split(',').map(&:strip)
+
+    @records = model.where(id: @ids)
+  end
+
+
+  step def ignore_models
+    @ignored = prompt.ask "Enter comma-separated regexps of associations to ignore"
+    whitelist_file = prompt.ask "Enter whitelist JSON file"
+    @whitelist = JSON.parse(IO.read(whitelist_file)) if whitelist_file.present?
+  end
+
+
+  step def capture_data
+    spinner = TTY::Spinner.new("[:spinner] :title", format: TTY::Formats::FORMATS.keys.sample)
+
+    @data = spec_dump(records, ignored_regexps, whitelist) do |x|
+      spinner.update title: "Loaded #{x.history.join(' -> ')}"
+      spinner.spin
+    end
+    puts "\nCapture complete!\n"
+  end
+
+
+  step def save_capture
+    FileUtils.mkdir_p "#{Dir.pwd}/spec/fixtures/captures"
+
+    @capture_name = prompt.ask "Enter a name for the capture",
+      default: @capture_name || "#{model_name.underscore}-#{ids.join('-')}_#{DateTime.now.strftime("%Y-%m-%d")}"
+
+    @capture_path     = "spec/fixtures/captures/#{capture_name.underscore.dasherize}.json"
+    @capture_fullpath = "#{Dir.pwd}/#{capture_path}"
+
+    IO.write capture_fullpath, JSON.pretty_generate(data)
+    puts "Wrote capture to #{capture_fullpath}"
+  end
+
+
+  step def generate_spec
+    unless prompt.yes?("Generate spec?")
+      puts <<-END
+let(:capture) { JSON.parse(IO.read(Rails.root.join(#{capture_path.inspect}))) }
+
+before :each do
+  Softwear::Library::SpecDump.expand_spec_dump(capture)
+end
+END
+      return
+    end
+
+    @spec_file = prompt.ask "Which spec file should this be added to?",
+      default: @spec_file || "spec/features/#{model_name.underscore.pluralize}_spec.rb"
+    @spec_desc = prompt.ask "Enter a name for the spec.",
+      default: @spec_desc || "#{model_name} problems #{DateTime.now.strftime("%Y-%m-%d")}"
+
+    @spec_fullpath = "#{Dir.pwd}/#{spec_file}"
+
+    template = Liquid::Template.parse(
+      IO.read("#{LIB_DIR}/lib/softwear/templates/captured_spec.rb.liquid"),
+      error_mode: :strict
+    )
+    new_spec = template.render!({
+      feature_or_describe: spec_file.include?("features") ? "feature" : "describe",
+      scenario_or_specify: spec_file.include?("features") ? "scenario" : "specify",
+      record_ids:          ids.inspect,
+      model_name:          model_name,
+      model_name_singular: model_name.underscore,
+      model_name_plural:   model_name.underscore.pluralize,
+      spec_desc_str:       spec_desc.inspect,
+      capture_path_str:    capture_path.inspect,
+      capture_name:        capture_name
+    }.stringify_keys, {
+      strict_variables: true
+    })
+
+
+    # Insert the new spec content into the existing spec file
+    spec_lines = IO.readlines(spec_fullpath)
+
+    index_of_last_end = spec_lines.size - 1
+    index_of_last_end -= 1 while spec_lines[index_of_last_end] !~ /end/
+
+    spec_lines.insert(index_of_last_end, new_spec)
+
+    IO.write(spec_fullpath, spec_lines.join)
+    puts "Wrote generated spec content to the end of #{spec_fullpath}"
+  end
+end
+
+
+##################
+#  Script logic  #
+##################
+
+cap = Capture.new
+
+until cap.done?
+  begin
+    cap.execute!
+    cap.increment_step
+
+  rescue Exception => error
+    retry if error.is_a?(ActiveRecord::StatementInvalid) && error.message.include?("closed MySQL connection")
+
+    puts PASTEL.red "\nERROR! #{error.class.name} \"#{error.message}\""
+    puts error.backtrace.join("\n")
+    puts PASTEL.red "#{error.class} encountered during #{cap.human_step.inspect} step\n"
+
+    choice = PROMPT.expand("Continue execution?") do |q|
+      q.choice key: 'q', name: 'Abort', value: :abort
+      q.choice key: 'r', name: 'Retry', value: :retry
+      q.choice key: 'R', name: 'Reload Rails and Retry', value: :reload
+      q.choice key: 'b', name: 'Go back one step', value: :back
+    end
+
+    case choice
+    when :abort then cap.step = nil
+    when :retry then nil
+    when :back  then cap.decrement_step
+    when :reload then cap.step = :initialize_rails
+    end
+  end
+end
+
+if cap.complete?
+  puts "DONE"
+else
+  puts "ABORTED"
+end

data/bin/softwear-update

@@ -0,0 +1,47 @@
+#!/usr/bin/env ruby
+
+require 'softwear/lib'
+
+old_gemfile = File.open('Gemfile').read.gsub(/\r\n?/, "\n")
+gemfile = []
+
+handler = nil
+append_line = nil
+
+injected_gems = false
+
+ignore_line = lambda do |line|
+  if line.include? Softwear::Lib::GEMFILE_CLOSER
+    gemfile << line
+    handler = append_line
+  end
+end
+
+append_line = lambda do |line|
+  gemfile << line
+  if line.include? Softwear::Lib::GEMFILE_OPENER
+    puts "Updating common gems"
+    gemfile << Softwear::Lib::COMMON_GEMS
+    injected_gems = true
+    handler = ignore_line
+  end
+end
+
+handler = append_line
+old_gemfile.each_line do |line|
+  handler.call(line)
+end
+
+unless injected_gems
+  puts "Adding common gems - check for duplicates!"
+  gemfile << "\n" + Softwear::Lib::GEMFILE_OPENER + "\n"
+  gemfile << Softwear::Lib::COMMON_GEMS
+  gemfile << Softwear::Lib::GEMFILE_CLOSER + "\n"
+end
+
+File.open('Gemfile', 'w') do |file|
+  gemfile.each do |line|
+    file.write(line)
+  end
+end
+puts "Done!"

data/bin/sw

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+require 'softwear/lib'
+
+if ARGV.length > 0
+  dir  = File.dirname(__FILE__)
+  file = "#{dir}/softwear-#{ARGV[0]}"
+
+  exec "bundle exec #{file} #{ARGV[1..-1].map(&:inspect).join(' ')}"
+else
+  puts "Run `softwear update` to update your gemfile's common dependencies"
+end

data/lib/softwear/auth/standard_model.rb

@@ -403,6 +403,16 @@ module Softwear
           objects.each { |u| u.instance_variable_set(:@persisted, true) }
         end
 
+        # ====================
+        # Returns array of all users in the given group
+        # ====================
+        def of_group(group_code)
+          json = validate_response query "ofgroup #{Figaro.env.hub_app_name} #{group_code}"
+
+          objects = JSON.parse(json).map(&method(:new))
+          objects.each { |u| u.instance_variable_set(:@persisted, true) }
+        end
+
         # ====================
         # Given a valid signin token:
         #   Returns the authenticated user for the given token
@@ -432,7 +442,7 @@ module Softwear
 
       REMOTE_ATTRIBUTES = [
         :id, :email, :first_name, :last_name,
-        :roles, :profile_picture_url,
+        :roles, :groups, :profile_picture_url,
         :default_view, :rights
       ]
       REMOTE_ATTRIBUTES.each(&method(:attr_accessor))
@@ -504,6 +514,14 @@ module Softwear
           wanted_roles.any? { |r| @roles.include?(r.to_s) }
         end
       end
+
+      def group?(group)
+        if @groups.nil?
+          query("group #{Figaro.env.hub_app_name} #{id} #{group}") == 'yes'
+        else
+          @groups.include?(group)
+        end
+      end
     end
   end
 end

data/lib/softwear/auth/stubbed_model.rb

@@ -103,6 +103,11 @@ users:
           all.select { |u| !u.roles.nil? && roles.any? { |r| u.roles.include?(r) } }
         end
 
+        def of_group(group_code)
+          roles = Array(roles).map(&:to_s)
+          all.select { |u| !u.groups.nil? && u.groups.include?(group_code) }
+        end
+
         def auth(_token, _appname = nil)
           signed_in = users_yml[:signed_in]
 

data/lib/softwear/auth/token_authentication.rb

@@ -9,8 +9,8 @@ module Softwear
       end
 
       def token_authenticate_user!
-        user_class = self.class.user_class || base_class.user_class || User
-        options    = (self.class.token_auth_options || base_class.token_auth_options || {}).with_indifferent_access
+        user_class = self.class.user_class || try(:base_class).try(:user_class) || User
+        options    = (self.class.token_auth_options || try(:base_class).try(:token_auth_options) || {}).with_indifferent_access
         params_options  = (options[:params]  || {}).with_indifferent_access
         headers_options = (options[:headers] || {}).with_indifferent_access
 

data/lib/softwear/engine.rb

@@ -1,7 +1,7 @@
 module Softwear
   class Engine < ::Rails::Engine
     isolate_namespace Softwear
-  
+
     initializer "softwear_lib.assets.precompile" do |app|
       app.config.assets.precompile += %w(softwear.css softwear.js style.css)
     end

data/lib/softwear/error_catcher.rb

@@ -41,10 +41,15 @@ module Softwear
       params.each do |key, value|
         new_value = value
 
-        case key.to_s
-        when /cc_number/ then new_value = "<FILTERED>"
-        when /cc_cvc/    then new_value = "<FILTERED>"
-        when /password/  then new_value = "<FILTERED>"
+        case value
+        when Hash
+          new_value = filter_params(value)
+        else
+          case key.to_s
+          when /cc_number/ then new_value = "<FILTERED>"
+          when /cc_cvc/    then new_value = "<FILTERED>"
+          when /password/  then new_value = "<FILTERED>"
+          end
         end
 
         new_hash[key] = new_value
@@ -56,12 +61,21 @@ module Softwear
       JSON.pretty_generate(filter_params(params)) + "|||" +
       instance_variables
         .reject { |v| /^@_/ =~ v.to_s || %i(@view_renderer @output_buffer @view_flow @error).include?(v) }
-        .map { |v| "#{v}: #{instance_variable_get(v).inspect}" }
+        .map { |v| "#{v}: #{instance_variable_get(v).inspect rescue '(ERROR)'}" }
         .join("|||")
     end
 
     def layout_for_error
-      current_user ? 'application' : 'no_overlay'
+      user = try(:current_user) || @current_user
+      partner = Figaro.env.partner_namespace
+
+      if user
+        "application"
+      elsif !partner.nil? && request.url.include?(partner)
+        "partners/application"
+      else
+        "no_overlay"
+      end
     end
   end
 end

data/lib/softwear/lib.rb

@@ -1,19 +1,22 @@
-require "softwear/engine"
-require "softwear/error_catcher"
-require "softwear/library/version"
-require "softwear/library/spec"
-require "softwear/library/api_controller"
-begin
-  require "softwear/library/enqueue"
-rescue LoadError
+if (::Rails rescue false)
+  require "softwear/engine"
+  require "softwear/library/api_controller"
+  require "softwear/error_catcher"
+  require "softwear/library/version"
+  require "softwear/library/spec"
+  require "softwear/auth/helper"
+  require "softwear/auth/model"
+  require "softwear/auth/belongs_to_user"
+  require "softwear/auth/spec"
+  require "softwear/auth/token_authentication"
+  require "softwear/library/controller_authentication"
+  begin
+    require "softwear/library/enqueue"
+  rescue LoadError
+  end
 end
 
-require "softwear/library/controller_authentication"
-require "softwear/auth/helper"
-require "softwear/auth/model"
-require "softwear/auth/belongs_to_user"
-require "softwear/auth/spec"
-require "softwear/auth/token_authentication"
+require "softwear/library/spec_dump"
 
 module Softwear
   module Library

data/lib/softwear/library/light_server.rb

@@ -1,121 +1,145 @@
 require 'rbczmq'
 
-def split(string, limit = nil)
-  string.split(/\s+/, limit)
-end
+module Softwear
+  module Library
+    class LightServer
+      def self.test!(file_path)
+        Object.class_eval do
+          def start_server!(*args)
+            Thread.new do
+              Softwear::Library::LightServer.new.start_server!(*args)
+            end
+          end
+        end
+        load file_path
+      end
 
-def report_error(rep, whole_command, error)
-  $stderr.puts "=== ERROR WHILE PROCESSING THE COMMAND \"#{whole_command}\" ===\n"\
-    "#{error.class.name}: #{error.message}\n#{error.backtrace.join("\n")}"
+      def split(string, limit = nil)
+        string.split(/\s+/, limit)
+      end
 
-  begin
-    rep.send "sorry" if rep
-  rescue StandardError => e
-    $stderr.puts "(could not send 'sorry' message: \"#{e.class} #{e.message}\")"
-  end
-end
+      def report_error(rep, whole_command, error)
+        $stderr.puts "=== ERROR WHILE PROCESSING THE COMMAND \"#{whole_command}\" ===\n"\
+          "#{error.class.name}: #{error.message}\n#{error.backtrace.join("\n")}"
 
-def dev_log(*a)
-  $stdout.puts(*a) #if Rails.env.development?
-end
+        begin
+          rep.send "sorry" if rep
+        rescue StandardError => e
+          $stderr.puts "(could not send 'sorry' message: \"#{e.class} #{e.message}\")"
+        end
+      end
 
-def log(*a)
-  $stdout.puts(*a) #unless Rails.env.test?
-end
+      def dev_log(*a)
+        $stdout.puts(*a) #if Rails.env.development?
+      end
 
-# ==== Send Format: =======
-# One line strings: "#{command} #{arg1} #{arg2} #{etc}"
-# The last argument, depending on the command, may contain spaces (but usually does not need to)
-# =========================
-# === Receive Format: =====
-# Usually one string, like "yes", or "no".
-# Returns "denied"  if an unauthorized command was attempted.
-# Returns "invalid" if an invalid command was attempted.
-# Returns "sorry"   if an error was raised while processing the command.
-# Can be a json argument, often following "yes ".
-# =========================
-def start_server!(*args)
-  log "Connecting...!"
-  
-  if args.size > 1
-    port = args.first
-  else
-    port = ENV['port'] || ENV['PORT'] || 2900
-  end
-  address = ENV['SOCKET_ADDR'] || "tcp://*"
+      def log(*a)
+        $stdout.puts(*a) #unless Rails.env.test?
+      end
 
-  if address =~ /:$/
-    socket_address = address
-  else
-    socket_address = "#{address}:#{port}"
-  end
+      # ==== Send Format: =======
+      # One line strings: "#{command} #{arg1} #{arg2} #{etc}"
+      # The last argument, depending on the command, may contain spaces (but usually does not need to)
+      # =========================
+      # === Receive Format: =====
+      # Usually one string, like "yes", or "no".
+      # Returns "denied"  if an unauthorized command was attempted.
+      # Returns "invalid" if an invalid command was attempted.
+      # Returns "sorry"   if an error was raised while processing the command.
+      # Can be a json argument, often following "yes ".
+      # =========================
+      def start_server!(*args)
+        log "Connecting...!"
+        
+        if args.size > 1
+          port = args.first
+        else
+          port = ENV['port'] || ENV['PORT'] || 2900
+        end
+        address = ENV['SOCKET_ADDR'] || "tcp://*"
 
-  ctx = ZMQ::Context.new
-  rep = ctx.bind(:REP, socket_address)
+        if address =~ /:$/
+          socket_address = address
+        else
+          socket_address = "#{address}:#{port}"
+        end
 
-  log "Ready! Using \"#{ActiveRecord::Base.connection.current_database}\" database"
+        rep = zmq.bind(:REP, socket_address)
 
-  commands = args.last
+        log "Ready! Using \"#{ActiveRecord::Base.connection.try(:current_database) || 'in-memory'}\" database"
 
-  loop do
-    begin
-      loop do
-        line_in = rep.recv
-        raise "Got nil response (ZMQ REP/REQ out of sync?)" if line_in.nil?
-        command, rest_of_command = split(line_in, 2)
+        commands = args.last
 
-        before = Time.now
-        begin
-          command = commands[command.downcase.to_sym]
-
-          if command.nil?
-            log "Received invalid command: \"#{line_in}\""
-          else
-            dev_log "<== #{line_in}"
-            ActiveRecord::Base.connection_pool.with_connection do
-
-              # The ZMQ socket requires that a reply be send after every
-              # message -- so we pass a lambda for the client code to
-              # call to send a message and make sure it only happens
-              # once.
-              replied = false
-              reply = lambda do |msg|
-                if replied
-                  raise "Reply sent twice"
+        loop do
+          begin
+            loop do
+              line_in = rep.recv
+              raise "Got nil response (ZMQ REP/REQ out of sync?)" if line_in.nil?
+              command, rest_of_command = split(line_in, 2)
+
+              before = Time.now
+              begin
+                command = commands[command.downcase.to_sym]
+
+                if command.nil?
+                  log "Received invalid command: \"#{line_in}\""
                 else
-                  rep.send(msg)
-                  replied = true
+                  dev_log "<== #{line_in}"
+                  ActiveRecord::Base.connection_pool.with_connection do
+
+                    # The ZMQ socket requires that a reply be send after every
+                    # message -- so we pass a lambda for the client code to
+                    # call to send a message and make sure it only happens
+                    # once.
+                    replied = false
+                    reply = lambda do |msg|
+                      if replied
+                        raise "Reply sent twice"
+                      else
+                        rep.send(msg)
+                        replied = true
+                      end
+                    end
+                    instance_exec(reply, rest_of_command, &command)
+
+                    if !replied
+                      rep.send "noreply"
+                    end
+
+                  end
                 end
-              end
-              command.call(reply, rest_of_command)
 
-              if !replied
-                rep.send "noreply"
+              rescue StandardError => e
+                report_error(rep, line_in, e)
+              rescue Exception => e
+                report_error(rep, line_in, e)
+                break
               end
+              after = Time.now
 
+              ms = (after - before) * 1000
+              dev_log %[(#{'%.2f' % ms}ms)]
+              dev_log ""
             end
-          end
 
-        rescue StandardError => e
-          report_error(rep, line_in, e)
-        rescue Exception => e
-          report_error(rep, line_in, e)
-          break
-        end
-        after = Time.now
+          rescue StandardError => error
+            $stderr.puts "=== ERROR -- RESTARTING SERVER ===\n"\
+              "#{error.class.name}: #{error.message}\n#{error.backtrace.join("\n")}"
 
-        ms = (after - before) * 1000
-        dev_log %[(#{'%.2f' % ms}ms)]
-        dev_log ""
+            rep.destroy
+            log "Reconnecting...!"
+            rep = zmq.bind(:REP, socket_address)
+          end
+        end
       end
 
-    rescue StandardError => error
-      $stderr.puts "=== ERROR -- RESTARTING SERVER ===\n"\
-        "#{error.class.name}: #{error.message}\n#{error.backtrace.join("\n")}"
-
-      rep.destroy
-      log "Reconnecting...!"
-      rep = ctx.bind(:REP, socket_address)
+      def zmq
+        $zmq_context ||= ZMQ::Context.new
+      end
     end
   end
 end
+
+def start_server!(*args)
+  Softwear::Library::LightServer.new.start_server!(*args)
+end

data/lib/softwear/library/spec.rb

@@ -100,7 +100,7 @@ module Softwear::Library
         old_scopes = page.instance_variable_get(:@scopes)
         page.instance_variable_set(:@scopes, [nil])
 
-        find('input.select2-search__field').set(text)
+        find('input.select2-search__field[tabindex="0"]').set(text)
         sleep options[:wait_before_click] if options[:wait_before_click]
         result = first('li.select2-results__option')
         if result.nil? || result.text == "No results found"

data/lib/softwear/library/spec_dump.rb

@@ -0,0 +1,143 @@
+module Softwear
+  module Library
+    module SpecDump
+      Record = Struct.new(:object, :history) do
+        def model; object.class; end
+      end
+
+      def spec_dump(root, ignored_models = [], whitelist_array = nil)
+        types_recorded = {}
+        records_by_type = {}
+        record_queue = Queue.new
+        whitelist = whitelist_array ? whitelist_array.reduce({}) { |h,n| h.merge(n => true) } : Hash.new(true)
+
+        is_ignored = lambda do |name|
+          next true if ignored_models.any? { |i| name =~ i }
+          next true if !whitelist[name]
+          false
+        end
+
+        # Begin dump routine. This will return true when we added a new entry.
+        dump = lambda do |record|
+          cache = (records_by_type[record.model.name] ||= {})
+          identifier = record.object.id
+
+          next false if cache[identifier].present?
+
+          attributes = {}
+          record.model.column_names.each do |col|
+            value = record.object[col]
+            if value.respond_to?(:iso8601)
+              # DateTimes don't serialize properly in attributes_before_type_cast
+              # for some reason, so we explicitly call to_s(:db) to make sure
+              # they can be loaded again correctly.
+              raw_value = value.to_s(:db)
+            else
+              raw_value = record.object.attributes_before_type_cast[col]
+            end
+
+            attributes[col] = raw_value
+          end
+
+          cache[identifier] = attributes
+          true
+        end
+        # end dump routine
+
+        # Begin actual dumping of records
+        Array(root).each do |record|
+          record_queue << Record.new(record, ["#{record.class.name}##{record.id}"])
+        end
+
+        while record_queue.present?
+          record = record_queue.pop
+          next if record.object.nil?
+          next unless record.model.respond_to?(:column_names)
+
+          # If dump returns false, that means we've already dumped this record
+          next unless dump.(record)
+          types_recorded[record.model.name] = true
+
+          yield record, types_recorded if block_given?
+
+          record.model.reflect_on_all_associations.each do |assoc|
+            next if assoc.is_a?(ActiveRecord::Reflection::ThroughReflection)
+
+            next if is_ignored["#{record.model.name}##{assoc.name}"]
+
+            case assoc
+            when ActiveRecord::Reflection::BelongsToReflection
+              # A belongs_to association will never cause an infinite loop
+              record_queue << Record.new(
+                record.object.send(assoc.name),
+                record.history + ["#{record.model.name}##{record.object.id}##{assoc.name}"]
+              )
+
+            when ActiveRecord::Reflection::HasManyReflection
+              # A has_many association can cause an infinite loop, so we only
+              # process these if we've never seen the record type before.
+              #
+              # If there's a whitelist, no need to care about that
+              next if whitelist_array.blank? && types_recorded[assoc.klass.name]
+
+              record.object.send(assoc.name).each_with_index do |child, i|
+                next if child.nil?
+                record_queue << Record.new(
+                  child,
+                  record.history + ["#{record.model.name}##{record.object.id}##{assoc.name}[#{i}]"]
+                )
+              end
+            end
+          end
+        end
+        # end actual dumping of records
+
+        records_by_type
+      end
+
+      def expand_spec_dump(dump, use_outside_of_test = false)
+        if !Rails.env.test? && !use_outside_of_test
+          raise "Tried to call expand_spec_dump outside of test environment. "\
+                "If you really want to do this, pass `true` as the second parameter."
+        end
+
+        if ActiveRecord::Base.configurations[Rails.env]['adapter'].include?('sqlite')
+          insert_cmd = lambda do |model|
+            "INSERT OR REPLACE INTO #{model.table_name} (#{model.column_names.map { |c| "`#{c}`" }.join(', ')}) VALUES\n"
+          end
+          cmd_suffix = ->_{ "" }
+        else
+          insert_cmd = lambda do |model|
+            "INSERT INTO #{model.table_name} (#{model.column_names.map { |c| "`#{c}`" }.join(', ')}) VALUES\n"
+          end
+          cmd_suffix = lambda do |model|
+            "\nON DUPLICATE KEY UPDATE\n" +
+              model.column_names
+                .map { |col| "`#{col}` = VALUES(`#{col}`)" }
+                .join(",\n")
+          end
+        end
+
+        dump.each do |class_name, entries|
+          model    = class_name.constantize
+          sql      = insert_cmd[model]
+          sanitize = model.connection.method(:quote)
+
+          sql += entries.map do |entry|
+            _id, attributes = entry
+
+            '(' +
+              model.column_names.map { |col| sanitize[attributes[col]] }.join(', ') +
+            ')'
+          end.join(",\n")
+
+          sql += cmd_suffix[model]
+
+          model.connection.execute sql
+        end
+      end
+
+      extend self
+    end
+  end
+end

data/lib/softwear/library/version.rb

@@ -1,5 +1,5 @@
 module Softwear
   module Library
-    VERSION = "3.1.5"
+    VERSION = "3.3.5"
   end
 end

data/lib/softwear/templates/captured_spec.rb.liquid

@@ -0,0 +1,17 @@
+
+  {{feature_or_describe}} "CAPTURE: {{capture_name}}", captured: true do
+    let(:capture) { JSON.parse(IO.read(Rails.root.join({{capture_path_str}}))) }
+    let(:{{model_name_plural}}) { {{model_name}}.where(id: {{record_ids}}) }
+
+    before :each do
+      Softwear::Library::SpecDump.expand_spec_dump(capture)
+    end
+
+    {{scenario_or_specify}} {{spec_desc_str}} do
+      visit edit_{{model_name_singular}}_path({{model_name_singular}})
+
+      # TODO fill in generated spec!
+      byebug
+      expect(false).to eq true
+    end
+  end

data/softwear-lib.gemspec

@@ -24,4 +24,7 @@ Gem::Specification.new do |spec|
 
   spec.add_dependency "activesupport", ">= 4.2.1"
   spec.add_dependency "rbczmq"
+  spec.add_dependency "tty-prompt"
+  spec.add_dependency "tty-spinner"
+  spec.add_dependency "liquid"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: softwear-lib
 version: !ruby/object:Gem::Version
-  version: 3.1.5
+  version: 3.3.5
 platform: ruby
 authors:
 - Nigel Baillie
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-05-18 00:00:00.000000000 Z
+date: 2017-10-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -80,12 +80,57 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: tty-prompt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: tty-spinner
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: liquid
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: 
 email:
 - nigel@annarbortees.com
 executables:
 - softwear
+- softwear-capture
 - softwear-deploy
+- softwear-update
+- sw
 extensions: []
 extra_rdoc_files: []
 files:
@@ -100,6 +145,7 @@ files:
 - app/assets/stylesheets/softwear.css
 - app/controllers/softwear/application_controller.rb
 - app/controllers/softwear/error_reports_controller.rb
+- app/controllers/softwear/spec_dump_controller.rb
 - app/helpers/softwear/application_helper.rb
 - app/mailers/error_report_mailer.rb
 - app/views/error_report_mailer/send_report.html.erb
@@ -108,7 +154,10 @@ files:
 - app/views/softwear/errors/internal_server_error.html.erb
 - app/views/softwear/errors/internal_server_error.js.erb
 - bin/softwear
+- bin/softwear-capture
 - bin/softwear-deploy
+- bin/softwear-update
+- bin/sw
 - config/routes.rb
 - lib/softwear/auth/belongs_to_user.rb
 - lib/softwear/auth/controller.rb
@@ -129,7 +178,9 @@ files:
 - lib/softwear/library/enqueue.rb
 - lib/softwear/library/light_server.rb
 - lib/softwear/library/spec.rb
+- lib/softwear/library/spec_dump.rb
 - lib/softwear/library/version.rb
+- lib/softwear/templates/captured_spec.rb.liquid
 - softwear-lib.gemspec
 - spec/spec_helper.rb
 - vendor/assets/stylesheets/animate/animate.css