answers-core 0.0.0

data/lib/answers/engine.rb

@@ -0,0 +1,62 @@
+module Answers
+  module Engine
+    # Specify a block of code to be run after the answers inclusion step. See
+    # Answers::Core::Engine#answers_inclusion for details regarding the Answers
+    # inclusion process.
+    #
+    # Example:
+    #   module Answers
+    #     module Images
+    #       class Engine < Rails::Engine
+    #         extend Answers::Engine
+    #         engine_name :images
+    #
+    #         after_inclusion do
+    #           # perform something here
+    #         end
+    #       end
+    #     end
+    #   end
+    def after_inclusion(&block)
+      if block && block.respond_to?(:call)
+        after_inclusion_procs << block
+      else
+        raise 'Anything added to be called after_inclusion must be callable (respond to #call).'
+      end
+    end
+
+    # Specify a block of code to be run before the answers inclusion step. See
+    # Answers::Core::Engine#answers_inclusion for details regarding the Answers
+    # inclusion process.
+    #
+    # Example:
+    #   module Answers
+    #     module Images
+    #       class Engine < Rails::Engine
+    #         extend Answers::Engine
+    #         engine_name :images
+    #
+    #         before_inclusion do
+    #           # perform something here
+    #         end
+    #       end
+    #     end
+    #   end
+    def before_inclusion(&block)
+      if block && block.respond_to?(:call)
+        before_inclusion_procs << block
+      else
+        raise 'Anything added to be called before_inclusion must be callable (respond to #call).'
+      end
+    end
+
+    private
+    def after_inclusion_procs
+      @@after_inclusion_procs ||= []
+    end
+
+    def before_inclusion_procs
+      @@before_inclusion_procs ||= []
+    end
+  end
+end

data/lib/answers/errors.rb

@@ -0,0 +1,13 @@
+module Answers
+
+  # = Answers Errors
+  #
+  # Generic Answers exception class
+  class AnswersError < StandardError
+  end
+
+  # Raised when an extension has not been properly defined. See the exception message for further
+  # details
+  class InvalidEngineError < AnswersError
+  end
+end

data/lib/answers/plugin.rb

@@ -0,0 +1,75 @@
+module Answers
+  class Plugin
+
+    attr_accessor :name, :class_name, :controller, :directory, :url,
+                  :dashboard, :always_allow_access, :menu_match,
+                  :hide_from_menu, :pathname, :plugin_activity
+
+    def self.register(&block)
+      yield(plugin = self.new)
+
+      raise "A plugin MUST have a name!: #{plugin.inspect}" if plugin.name.blank?
+
+      # Set defaults.
+      plugin.menu_match ||= %r{answers/#{plugin.name}(/.+?)?$}
+      plugin.always_allow_access ||= false
+      plugin.dashboard ||= false
+      plugin.class_name ||= plugin.name.camelize
+
+      # add the new plugin to the collection of registered plugins
+      ::Answers::Plugins.registered << plugin
+    end
+
+    # Returns the internationalized version of the title
+    def title
+      ::I18n.translate(['answers', 'plugins', name, 'title'].join('.'))
+    end
+
+    # Returns the internationalized version of the description
+    def description
+      ::I18n.translate(['answers', 'plugins', name, 'description'].join('.'))
+    end
+
+    # Stores information that can be used to retrieve the latest activities of this plugin
+    def activity=(activities)
+      Answers.deprecate('Answers::Plugin#activity=', when: '3.1')
+    end
+
+    # Used to highlight the current tab in the admin interface
+    def highlighted?(params)
+      !!(params[:controller].try(:gsub, "admin/", "") =~ menu_match) || (dashboard && params[:action] == 'error_404')
+    end
+
+    def pathname=(value)
+      value = Pathname.new(value) if value.is_a? String
+      @pathname = value
+    end
+
+    # Returns a hash that can be used to create a url that points to the administration part of the plugin.
+    def url
+      @url ||= if controller.present?
+        { :controller => "answers/admin/#{controller}" }
+      elsif directory.present?
+        { :controller => "answers/admin/#{directory.split('/').pop}" }
+      else
+        { :controller => "answers/admin/#{name}" }
+      end
+
+      if @url.is_a?(Hash)
+        {:only_path => true}.merge(@url)
+      elsif @url.respond_to?(:call)
+        @url.call
+      else
+        @url
+      end
+    end
+
+    # Make this protected, so that only Plugin.register can use it.
+    protected
+    def initialize
+      # provide a default pathname to where this plugin is using its lib directory.
+      depth = RUBY_VERSION >= "1.9.2" ? 4 : 3
+      self.pathname ||= Pathname.new(caller(depth).first.match("(.*)#{File::SEPARATOR}lib")[1])
+    end
+  end
+end

data/lib/answers/plugins.rb

@@ -0,0 +1,73 @@
+require 'forwardable'
+
+module Answers
+  class Plugins
+    include Enumerable
+    extend Forwardable
+
+    def initialize(*args)
+      @plugins = Array.new(*args)
+    end
+
+    def_delegators :@plugins, :<<, :each, :delete_if
+
+    def find_by_name(name)
+      detect { |plugin| plugin.name == name }
+    end
+    alias :[] :find_by_name
+
+    def find_by_title(title)
+      detect { |plugin| plugin.title == title }
+    end
+
+    def in_menu
+      self.class.new(reject(&:hide_from_menu))
+    end
+
+    def names
+      map(&:name)
+    end
+
+    def pathnames
+      map(&:pathname).compact.uniq
+    end
+
+    def titles
+      map(&:title)
+    end
+
+    class << self
+      def active
+        @active_plugins ||= new
+      end
+
+      def always_allowed
+        new registered.select(&:always_allow_access)
+      end
+
+      def registered
+        @registered_plugins ||= new
+      end
+
+      def activate(name)
+        active << registered[name] if registered[name] && !active[name]
+      end
+
+      def deactivate(name)
+        active.delete_if {|p| p.name == name}
+      end
+
+      def set_active(names)
+        @active_plugins = new
+
+        names.each do |name|
+          activate(name)
+        end
+      end
+    end
+
+    private
+
+    attr_reader :plugins
+  end
+end

data/lib/answers/version.rb

@@ -0,0 +1,16 @@
+module Answers
+  class Version
+    @major = 0
+    @minor = 0
+    @tiny  = 5
+    @build = nil
+
+    class << self
+      attr_reader :major, :minor, :tiny, :build
+
+      def to_s
+        [@major, @minor, @tiny, @build].compact.join('.')
+      end
+    end
+  end
+end

data/lib/api_client.rb

@@ -0,0 +1,20 @@
+require 'weary'
+require 'json'
+
+DEVELOPMENT_DOMAIN = "http://localhost:3000"
+
+module APIClient
+  class Answer < Weary::Client
+    domain DEVELOPMENT_DOMAIN if Rails.env.development?
+    domain PRODUCTION_DOMAIN  if Rails.env.production?
+    
+    get :all, "/answers.json"
+    get :find, "/answers/{id}.json"
+    
+    post :create, "/answers.json" do |resource|
+      resource.optional :need_to_know
+      resource.required :text, :in_language
+    end
+  end
+end
+

data/lib/assets/eng_stop.csv

@@ -0,0 +1 @@
+a,able,about,across,after,all,almost,also,am,among,an,and,any,are,as,at,be,because,been,but,by,can,cannot,could,dear,did,do,does,either,else,ever,every,for,from,get,got,had,has,have,he,her,hers,him,his,how,however,i,if,in,into,is,it,its,just,least,let,like,likely,may,me,might,most,must,my,neither,no,nor,not,of,off,often,on,only,or,other,our,own,rather,said,say,says,she,should,since,so,some,than,that,the,their,them,then,there,these,they,this,tis,to,too,twas,us,wants,was,we,were,what,when,where,which,while,who,whom,why,will,with,would,yet,you,your,much,lost

data/lib/generators/answers/clash_keywords.yml

@@ -0,0 +1,3 @@
+- case
+- class
+- switch

data/lib/generators/answers/cms/cms_generator.rb

@@ -0,0 +1,314 @@
+require 'pathname'
+module Answers
+  class CmsGenerator < Rails::Generators::Base
+    source_root Pathname.new(File.expand_path('../templates', __FILE__))
+
+    class_option :update,  :type => :boolean, :aliases => nil, :group => :runtime,
+                           :desc => "Update an existing Answers based application"
+    class_option :fresh_installation, :type => :boolean, :aliases => nil, :group => :runtime, :default => false,
+                           :desc => "Allow Answers to remove default Rails files in a fresh installation"
+    class_option :heroku,  :type => :string, :default => nil, :group => :runtime, :banner => 'APP_NAME',
+                           :desc => "Deploy to Heroku after the generator has run."
+    class_option :stack,   :type => :string, :default => 'cedar', :group => :runtime,
+                           :desc => "Specify which Heroku stack you want to use. Requires --heroku option to function."
+    class_option :skip_db, :type => :boolean, :default => false, :aliases => nil, :group => :runtime,
+                           :desc => "Skip over any database creation, migration or seeding."
+    class_option :skip_migrations, :type => :boolean, :default => false, :aliases => nil, :group => :runtime,
+                           :desc => "Skip over installing or running migrations."
+
+    def generate
+      start_pretending?
+
+      manage_roadblocks! unless self.options[:update]
+
+      ensure_environments_are_sane!
+
+      stop_pretending?
+
+      append_gemfile!
+
+      append_gitignore!
+
+      append_seeds!
+
+      append_asset_pipeline!
+
+      forced_overwriting?
+
+      copy_files!
+
+      create_decorators!
+
+      mount!
+
+      run_additional_generators! if self.options[:fresh_installation]
+
+      generate_active_admin_install
+
+      migrate_database!
+
+      seed_database!
+
+      deploy_to_hosting?
+    end
+
+    protected
+
+    def append_asset_pipeline!
+      application_css = 'app/assets/stylesheets/application.css'
+      if destination_path.join(application_css).file?
+        insert_into_file application_css, %q{*= require answers/formatting
+ *= require answers/theme
+ }, before: '*= require_self'
+      end
+
+      application_js = 'app/assets/javascripts/application.js'
+      if destination_path.join(application_js).file?
+        insert_into_file application_js, %q{//= require answers
+}, before: '//= require_tree .'
+      end
+    end
+
+    def append_gemfile!
+      if destination_path.join('Gemfile').file? &&
+         destination_path.join('Gemfile').read !~ %r{group :development, :test do\n.+?gem 'sqlite3'\nend}m
+        gsub_file 'Gemfile', %q{gem 'sqlite3'}, %q{group :development, :test do
+  gem 'sqlite3'
+end}  end
+    end
+
+    def append_gitignore!
+      # Ensure .gitignore exists and append our rules to it.
+      create_file ".gitignore" unless destination_path.join('.gitignore').file?
+      our_ignore_rules = self.class.source_root.join('.gitignore').read
+      our_ignore_rules = our_ignore_rules.split('# ANSWERS DEVELOPMENT').first if destination_path != Answers.root
+      append_file ".gitignore", our_ignore_rules
+    end
+
+    def append_seeds!
+      append_file 'db/seeds.rb', %q{
+puts 'SETTING UP DEFAULT USER LOGIN'
+print "Enter admin email: "
+admin_email = 'admin@answers.gsa.io'
+
+user = Answers::User.create! :email => admin_email, :password => 'Mahalo43', :password_confirmation => 'Mahalo43', :is_admin => true, :is_editor => true, :is_writer => true
+puts 'New user created: ' << user.email
+puts "Admin password has been set to: Mahalo43"
+}
+    end
+
+    def append_heroku_gems!
+      append_file 'Gemfile', %q{
+# The Heroku gem allows you to interface with Heroku's API
+gem 'heroku'
+
+# Fog allows you to use S3 assets (added for Heroku)
+gem 'fog'
+}
+      # If postgres is not the database in use, Heroku still needs it.
+      if destination_path.join('Gemfile').file? && destination_path.join('Gemfile').read !~ %r{gem ['"]pg['"]}
+        append_file 'Gemfile', %q{
+# Postgres support (added for Heroku)
+gem 'pg'
+}
+      end
+    end
+
+    def bundle!
+      run 'bundle install'
+    end
+
+    def generate_active_admin_install
+      run 'rails g active_admin:install --skip-users'
+      remove_file 'config/initializers/active_admin.rb', :verbose => true
+    end
+
+    def copy_files!
+      # The extension installer only installs database templates.
+      Pathname.glob(self.class.source_root.join('**', '*')).reject{|f|
+        f.directory? or f.to_s =~ /\/db\//
+      }.sort.each do |path|
+        copy_file path, path.to_s.gsub(self.class.source_root.to_s, destination_path.to_s)
+      end
+    end
+
+    def create_decorators!
+      # Create decorator directories
+      %w[controllers models].each do |decorator_namespace|
+        src_file_path = "app/decorators/#{decorator_namespace}/answers/.keep"
+        copy_file self.class.source_root.join(src_file_path), destination_path.join(src_file_path)
+      end
+    end
+
+    def deploy_to_hosting?
+      if heroku?
+        append_heroku_gems!
+
+        bundle!
+
+        # Sanity check the heroku application name and save whatever messages are produced.
+        message = sanity_check_heroku_application_name!
+
+        # Supply the deploy process with the previous messages to make them visible.
+        deploy_to_hosting_heroku!(message)
+      end
+    end
+
+    def deploy_to_hosting_heroku!(message = nil)
+      say_status "Initializing and committing to git..", nil
+      run "git init && git add . && git commit -am 'Created application using Answers #{Answers.version}'"
+
+      say_status message, nil, :yellow if message
+
+      say_status "Creating Heroku app..", nil
+      run ["heroku create",
+           (options[:heroku] if heroku?),
+           "#{"--stack #{options[:stack]}" if options[:stack]}"
+          ].compact.join(' ')
+
+      say_status "Pushing to Heroku (this takes time, be patient)..", nil
+      run "git push heroku master"
+
+      say_status "Setting up the Heroku database..", nil
+      run "heroku#{' run' if options[:stack] == 'cedar'} rake db:migrate"
+
+      say_status "Restarting servers...", nil
+      run "heroku restart"
+    end
+
+    # Helper method to quickly convert destination_root to a Pathname for easy file path manipulation
+    def destination_path
+      @destination_path ||= Pathname.new(self.destination_root)
+    end
+
+    def ensure_environments_are_sane!
+      # Massage environment files
+      %w(development test production).map{|e| "config/environments/#{e}.rb"}.each do |env|
+        next unless destination_path.join(env).file?
+
+        # Answers does not necessarily expect action_mailer to be available as
+        # we may not always require it (currently only the authentication extension).
+        # Rails, however, will optimistically place config entries for action_mailer.
+        current_mailer_config = File.read(destination_path.join(env)).to_s.
+                                     match(%r{^\s.+?config\.action_mailer\..+([\w\W]*\})?}).
+                                     to_a.flatten.first
+
+        if current_mailer_config.present?
+          new_mailer_config = [
+            "  if config.respond_to?(:action_mailer)",
+            current_mailer_config.gsub(%r{\A\n+?}, ''). # remove extraneous newlines at the start
+                                  gsub(%r{^\ \ }) { |line| "  #{line}" }, # add indentation on each line
+            "  end"
+          ].join("\n")
+
+          gsub_file env, current_mailer_config, new_mailer_config, :verbose => false
+        end
+
+        gsub_file env, "config.assets.compile = false", "config.assets.compile = true", :verbose => false
+      end
+    end
+
+    def forced_overwriting?
+      force_options = self.options.dup
+      force_options[:force] = self.options[:force] || self.options[:update]
+      self.options = force_options
+    end
+
+    def heroku?
+      options[:heroku].present?
+    end
+
+    def manage_roadblocks!
+      %w(public/index.html app/views/layouts/application.html.erb).each do |roadblock|
+        if (roadblock_path = destination_path.join(roadblock)).file?
+          if self.options[:fresh_installation]
+            remove_file roadblock_path, :verbose => true
+          else
+            say_status :"-- You may need to remove '#{roadblock}' for Answers to function properly --", nil, :yellow
+          end
+        end
+      end
+    end
+
+    def migrate_database!
+      unless self.options[:skip_migrations]
+        rake 'railties:install:migrations'
+        rake 'db:create db:migrate' unless self.options[:skip_db]
+      end
+    end
+
+    def mount!
+      if (routes_file = destination_path.join('config', 'routes.rb')).file? && (self.behavior == :revoke || (routes_file.read !~ %r{mount\ Answers::Core::Engine}))
+        # Append routes
+        mount = %Q{
+  # This line mounts Answers's routes at the root of your application.
+  # This means, any requests to the root URL of your application will go to Answers::PagesController#home.
+  # If you would like to change where this extension is mounted, simply change the :at option to something different.
+  #
+  # We ask that you don't use the :as option here, as Answers relies on it being the default of "answers"
+  mount Answers::Core::Engine, at: '/'
+  ActiveAdmin.routes(self)
+
+}
+
+        inject_into_file 'config/routes.rb', mount, after: ".routes.draw do"
+      end
+    end
+
+    def run_additional_generators!
+      generator_args = []
+      generator_args << '--quiet' if self.options[:quiet]
+      generator_args << '--skip-migrations' if self.options[:skip_migrations]
+      Answers::CoreGenerator.start generator_args
+      Answers::AuthenticationGenerator.start generator_args if defined?(Answers::AuthenticationGenerator)
+      Answers::I18nGenerator.start generator_args if defined?(Answers::I18nGenerator)
+    end
+
+    def sanity_check_heroku_application_name!
+      if heroku? && options[:heroku].to_s.include?('_') || options[:heroku].to_s.length > 30
+        message = ["\nThe application name '#{options[:heroku]}' that you specified is invalid for Heroku."]
+        suggested_name = options[:heroku].dup.to_s
+        if suggested_name.include?('_')
+          message << "This is because it contains underscores which Heroku does not allow."
+          suggested_name.gsub!(/_/, '-')
+        end
+        if suggested_name.length > 30
+          message << "This is#{" also" unless suggested_name.nil?} because it is longer than 30 characters."
+          suggested_name = suggested_name[0..29]
+        end
+
+        options[:heroku] = suggested_name
+
+        message << "We have changed the name to '#{suggested_name}' for you, hope it suits you.\n"
+        message.join("\n")
+      end
+
+      options[:heroku] = '' if options[:heroku] == 'heroku'
+    end
+
+    def seed_database!
+      rake 'db:seed' unless self.options[:skip_db] || self.options[:skip_migrations]
+    end
+
+    def start_pretending?
+      # Only pretend to do the next actions if this is Answers to stay DRY
+      if destination_path == Answers.root
+        say_status :'-- pretending to make changes that happen in an actual installation --', nil, :yellow
+        old_pretend = self.options[:pretend]
+        new_options = self.options.dup
+        new_options[:pretend] = true
+        self.options = new_options
+      end
+    end
+
+    def stop_pretending?
+      # Stop pretending
+      if destination_path == Answers.root
+        say_status :'-- finished pretending --', nil, :yellow
+        new_options = self.options.dup
+        new_options[:pretend] = old_pretend
+        self.options = new_options
+      end
+    end
+  end
+end