flex-rails 1.0.1

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2012-2013 by Domizio Demichelis
+
+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,24 @@
+# Flex-rails
+
+Rails integration for Flex: provides the engine, generators and helpers to integrate Flex with Rails
+
+## Links
+
+* [Flex Repository](https://github.com/ddnexus/flex)
+* [Flex Project (Global Documentation)](http://ddnexus.github.io/flex/doc/)
+* [flex-rails Gem (Specific Documentation)](http://ddnexus.github.io/flex/doc/5-flex-rails)
+* [Issues](https://github.com/ddnexus/flex-rails/issues)
+* [Pull Requests](https://github.com/ddnexus/flex-rails/pulls)
+
+## Branches
+
+The master branch reflects the last published gem. Then you may find a next-version branch (named after the version string), with the commits that will be merged in master just before publishing the next gem version. The next-version branch may get rebased or force pushed.
+
+## Credits
+
+Special thanks for their sponsorship to [Escalate Media](http://www.escalatemedia.com) and [Barquin International](http://www.barquin.com).
+
+## Copyright
+
+Copyright (c) 2012-2013 by [Domizio Demichelis](mailto://dd.nexus@gmail.com)<br>
+See [LICENSE](https://github.com/ddnexus/flex-rails/blob/master/LICENSE) for details.

data/VERSION

@@ -0,0 +1 @@
+1.0.1

data/flex-rails.gemspec

@@ -0,0 +1,24 @@
+require 'date'
+version = File.read(File.expand_path('../VERSION', __FILE__)).strip
+
+Gem::Specification.new do |s|
+  s.name                      = 'flex-rails'
+  s.summary                   = 'Rails integration for Flex'
+  s.description               = 'Provides the engine, generators and helpers to integrate Flex with Rails'
+  s.homepage                  = 'http://github.com/ddnexus/flex-rails'
+  s.authors                   = ["Domizio Demichelis"]
+  s.email                     = 'dd.nexus@gmail.com'
+  s.extra_rdoc_files          = %w[README.md]
+  s.files                     = `git ls-files -z`.split("\0")
+  s.version                   = version
+  s.date                      = Date.today.to_s
+  s.required_rubygems_version = ">= 1.3.6"
+  s.rdoc_options              = %w[--charset=UTF-8]
+
+  s.add_runtime_dependency 'rails', '>=2.0'
+
+  s.add_runtime_dependency 'flex',        version
+  s.add_runtime_dependency 'flex-models', version
+
+  s.add_runtime_dependency 'prompter', '~> 0.1.5'
+end

data/lib/flex/rails/engine.rb

@@ -0,0 +1,39 @@
+module Flex
+  module Rails
+    class Engine < ::Rails::Engine
+
+      ActiveSupport.on_load(:before_configuration) do
+        config.flex = Conf
+        config.flex.variables[:index] = [self.class.name.split('::').first.underscore, ::Rails.env].join('_')
+        config.flex.config_file       = ::Rails.root.join('config', 'flex.yml').to_s
+        config.flex.flex_dir          = ::Rails.root.join('app', 'flex').to_s
+        config.flex.logger            = Logger.new(STDOUT)
+        config.flex.logger.level      = ::Logger::DEBUG if ::Rails.env.development?
+        config.flex.result_extenders |= [ Flex::Result::RailsHelper ]
+      end
+
+      ActiveSupport.on_load(:after_initialize) do
+        Helper.after_initialize
+      end
+
+      rake_tasks do
+        Flex::LIB_PATHS.each do |path|
+          task_path = "#{path}/tasks.rake"
+          load task_path if File.file?(task_path)
+        end
+      end
+
+      console do
+        config.flex.logger.log_to_rails_logger = false
+        config.flex.logger.log_to_stderr       = true
+        config.flex.logger.debug_variables     = false
+        config.flex.logger.debug_result        = false
+      end
+
+      config.to_prepare do
+        Flex.reload!
+      end
+
+    end
+  end
+end

data/lib/flex/rails/helper.rb

@@ -0,0 +1,14 @@
+module Flex
+  module Rails
+    module Helper
+      extend self
+
+      def after_initialize
+        # we need to reload the flex API methods with the new variables
+        Flex.reload!
+        Conf.flex_models && Conf.flex_models.each {|m| eval"::#{m}" if m.is_a?(String) }
+      end
+
+    end
+  end
+end

data/lib/flex/rails/logger.rb

@@ -0,0 +1,29 @@
+module Flex
+  module Rails
+    class Logger < Flex::Logger
+
+      attr_accessor :log_to_rails_logger, :log_to_stderr
+
+      def initialize(*)
+        super
+        self.formatter = proc do |severity, datetime, progname, msg|
+          flex_formatted = flex_format(severity, msg)
+          ::Rails.logger.send(severity.downcase.to_sym, flex_formatted) if log_to_rails_logger && ::Rails.logger.respond_to?(severity.downcase.to_sym)
+          flex_formatted if log_to_stderr
+        end
+        @log_to_rails_logger = true
+        @log_to_stderr       = false
+      end
+
+      def log_to_stdout
+        Deprecation.warn 'Flex::Configuration.logger.log_to_stdout', 'Flex::Configuration.logger.log_to_stderr'
+        log_to_stderr
+      end
+      def log_to_stdout=(val)
+        Deprecation.warn 'Flex::Configuration.logger.log_to_stdout=', 'Flex::Configuration.logger.log_to_stderr='
+        self.log_to_stderr = val
+      end
+
+    end
+  end
+end

data/lib/flex/result/rails_helper.rb

@@ -0,0 +1,48 @@
+module Flex
+  class Result
+    module RailsHelper
+
+      module Highlighter
+
+        RE = /highlighted_(\w+)/
+
+        def respond_to?(meth, private=false)
+          meth.to_s =~ RE
+          !!$1 || super
+        end
+
+        def method_missing(meth, *args, &block)
+          meth.to_s =~ RE
+          attribute = $1
+          if attribute
+            opts = {:fragment_separator => ' ... '}.merge(args.first||{})
+            if self['highlight']
+              key, high = self['highlight'].find { |k,v| k.gsub('.','_') == attribute }
+              high = Array.wrap(high) if high
+            end
+            if high.blank?
+              respond_to?(attribute.to_sym) ? send(attribute.to_sym) : ''
+            else
+              high.join(opts[:fragment_separator]).html_safe
+            end
+          else
+            super
+          end
+        end
+
+      end
+
+
+      # extend if result is a Search or MultiGet
+      def self.should_extend?(result)
+        result.is_a?(Search) || result.is_a?(MultiGet)
+      end
+
+      # extend the collection on extend
+      def self.extended(result)
+        result.collection.each { |h| h.extend(Highlighter) }
+      end
+
+    end
+  end
+end

data/lib/flex-rails.rb

@@ -0,0 +1,20 @@
+require 'flex'
+require 'flex-models'
+require 'rails'
+require 'flex/result/rails_helper'
+require 'flex/rails/helper'
+require 'flex/rails/logger'
+
+Flex::LIB_PATHS << File.dirname(__FILE__)
+
+if ::Rails.respond_to?(:version) && ::Rails.version.to_i >= 3
+  require 'flex/rails/engine'
+else
+  Flex::Conf.configure do |c|
+    c.config_file       = "#{RAILS_ROOT}/config/flex.yml"
+    c.flex_dir          = "#{RAILS_ROOT}app/flex"
+    c.logger            = Logger.new(STDOUT)
+    c.logger.level      = ::Logger::DEBUG if RAILS_ENV == 'development'
+    c.result_extenders |= [ Flex::Result::RailsHelper ]
+  end
+end

data/lib/generators/flex/setup/setup_generator.rb

@@ -0,0 +1,53 @@
+require 'prompter'
+
+class Flex::SetupGenerator < Rails::Generators::Base
+
+  source_root File.expand_path('../templates', __FILE__)
+
+  def self.banner
+    "rails generate flex:setup"
+  end
+
+  def ask_base_name
+    @module_name   = Prompter.ask('Please, enter a class name for your Search class. Choose a name not defined in your app.',
+                                  :default => 'FlexSearch', :hint => '[<enter>=FlexSearch]')
+    @extender_name = "#{@module_name}Extender"
+  end
+
+  def add_config_flex_file
+    template 'flex_config.yml', Rails.root.join('config', 'flex.yml')
+  end
+
+  def create_initializer_file
+    template 'flex_initializer.rb.erb', Rails.root.join('config', 'initializers', 'flex.rb')
+  end
+
+  def create_flex_dir
+    template 'flex_dir/es.rb.erb',          Rails.root.join('app', 'flex', "#{@module_name.underscore}.rb")
+    template 'flex_dir/es.yml.erb',         Rails.root.join('app', 'flex', "#{@module_name.underscore}.yml")
+    template 'flex_dir/es_extender.rb.erb', Rails.root.join('app', 'flex', "#{@extender_name.underscore}.rb")
+  end
+
+
+  def show_setup_message
+    Prompter.say <<-text, :style => :green
+
+    Setup done!
+
+    During prototyping, remember also:
+
+      1. each time you include a new Flex::ModelIndexer
+         you should add its name to the config.flex_model in "config/initializers/flex.rb"
+
+      2. each time you include a new Flex::ActiveModel
+         you should add its name to the config.flex_active_model in "config/initializers/flex.rb"
+
+      3. each time you add/change a flex.parent relation you should reindex
+
+    The complete documentation is available at https://github.com/ddnexus/flex-doc/doc
+    If you have any problem with Flex, please report the issue at https://github.com/ddnexus/flex/issues.
+    text
+  end
+
+end
+

data/lib/generators/flex/setup/templates/flex_config.yml

@@ -0,0 +1,18 @@
+# ANCHORS literal key: it will not be used as template
+# you can store here fragments of structures to reuse below
+ANCHORS:
+  -
+
+# This is a dynamic index name.
+# The default index name generated by Flex is usually <application_name>_<environment>,
+# but you may have changed it in the initializers/flex.rb or you can hardcode it if you prefer.
+# The settings and mapping below will work with any index (providing that it is a single index).
+# If you set it as an array of indices, you must edit this file accordingly, providing one entry per index.
+<%%= Flex::Configuration.variables[:index] %>:
+
+  settings:
+    number_of_shards: 5
+    number_of_replicas: 1
+
+  # add your custom mappings here
+  mappings: {}

data/lib/generators/flex/setup/templates/flex_dir/es.rb.erb

@@ -0,0 +1,23 @@
+# inspect the methods loaded in this module and their usage
+# in the rails console by just typing:
+# >> puts <%= @module_name %>.flex.doc
+# you can eventually restrict the doc to a single method by pasing its name:
+# >> puts <%= @module_name %>.flex.doc :search
+# see the detailed doc for this feature at http://ddnexus.github.io/flex/doc/2-flex/4-Self-Documentation.html
+
+module <%= @module_name %>
+
+  extend self
+
+  # if you don't use flex scopes and you stick with flex templates, you can comment the next line
+  include Flex::Scopes
+
+  # enables the templating
+  include Flex::Templates
+  # loads the <%= "#{@module_name.underscore}.yml" %> file
+  flex.load_search_source
+
+  # you may need to add more method here, usually custom scopes
+  # or wrapper methods that use one of the autogenerated methods from the loaded templates
+
+end

data/lib/generators/flex/setup/templates/flex_dir/es.yml.erb

@@ -0,0 +1,22 @@
+# Add here your search queries
+# see the detailed Source documentation at http://ddnexus.github.io/flex/doc/2-flex/2-Templating/2-Sources.html
+
+
+# ANCHORS litheral key: it will not be used as template
+# you can store here fragments of queries to reuse in the templates below
+ANCHORS:
+  -
+
+# this is a a basic template loaded in your class <%= @module_name %>
+# it defines the 'q' tag. You can check its usage from the rails console by just typing:
+# >> puts <%= @module_name %>.flex.doc
+# You can eventually restrict the doc to a single method by pasing its name:
+# >> puts <%= @module_name %>.flex.doc :search
+# see the detailed doc for this feature at http://ddnexus.github.io/flex/doc/2-flex/4-Self-Documentation.html
+
+# the :cleanable_query is a special variable that get cleaned up if contains illegal characters for the Lucene syntax
+search:
+- query:
+    query_string:
+      query: <<cleanable_query= "*">>
+

data/lib/generators/flex/setup/templates/flex_dir/es_extender.rb.erb

@@ -0,0 +1,17 @@
+# see the detailed Extenders documentation at http://ddnexus.github.io/flex/doc/2-flex/3-Result-Extenders.html
+
+module <%= @extender_name  %>
+
+  # set this method to restrict this extender to certain types of results
+  # see the other Flex extenders for reference
+  def self.should_extend?(response)
+    false
+  end
+
+  # adds your methods
+
+  def an_extending_method
+    # self is the structure returned by ES
+  end
+
+end

data/lib/generators/flex/setup/templates/flex_initializer.rb.erb

@@ -0,0 +1,54 @@
+# see the detailed Configuration documentation at http://ddnexus.github.io/flex/doc/1-Global-Doc/3-Configuration.html
+
+Flex::Configuration.configure do |config|
+
+  # you must add your indexed model names here
+  config.flex_models = %w[  ]
+
+  # you must add your active model names here
+  config.flex_active_models = %w[  ]
+
+  # Add the your result extenders here
+  config.result_extenders |= [ <%= "#{@extender_name}" %> ]
+
+  # Add the default variables here:
+  # see also the details Variables documentation at http://ddnexus.github.io/flex/doc/2-flex/2-Templating/4-Variables.html
+  # config.variables.deep_merge! :index    => 'my_index',
+  #                              :type     => 'project',
+  #                              :anything => 'anything
+
+  # used by the live-reindex feature
+  # if you change it you must deploy the change first, then you can live-reindex in any next deploy
+  # read the documentation at http://ddnexus.github.io/flex/doc/2-flex/7-Live-Reindex.html#flexconfigurationapp_id
+  config.app_id = '<%= Time.now.strftime('%Y%m%d%H%M%S_') + Rails.application.class.name.split('::').first.underscore %>_' + Rails.env
+
+  # used by the live-reindex feature
+  # Uncomment and set the redis client only if you don't want to use the redis default client
+  # config.redis = Redis.new(:host => somehost, :port: 6379, :db = 1)
+
+
+  # Logger variables: see http://ddnexus.github.io/flex/doc/1-Global-Doc/3-Configuration.html
+  # config.logger.debug_variables = false
+  # config.logger.debug_request   = false
+  # config.logger.debug_result    = false
+  # config.logger.curl_format     = false
+
+  # Custom config file path
+  # config.config_file = '/custom/path/to/flex.yml',
+
+  # Custom flex dir path
+  # config.flex_dir = '/custom/path/to/flex',
+
+  # The custom http_client you may want to implement
+  # config.http_client = Your::Client.new
+
+  # The custom url of your ElasticSearch server
+  # config.http_client.base_uri = 'http://localhost:9200'
+
+  # The options passed to the http_client. They are client specific.
+  # config.http_client.options = {:timeout => 5}
+
+  # Experimental: checks the response and returns a boolean (should raise?)
+  # config.http_client.raise_proc = proc{|response| response.status >= 400}
+
+end

metadata

@@ -0,0 +1,125 @@
+--- !ruby/object:Gem::Specification
+name: flex-rails
+version: !ruby/object:Gem::Version
+  version: 1.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Domizio Demichelis
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-08-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: flex
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.0.1
+- !ruby/object:Gem::Dependency
+  name: flex-models
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.0.1
+- !ruby/object:Gem::Dependency
+  name: prompter
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.1.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.1.5
+description: Provides the engine, generators and helpers to integrate Flex with Rails
+email: dd.nexus@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+files:
+- LICENSE
+- README.md
+- VERSION
+- flex-rails.gemspec
+- lib/flex-rails.rb
+- lib/flex/rails/engine.rb
+- lib/flex/rails/helper.rb
+- lib/flex/rails/logger.rb
+- lib/flex/result/rails_helper.rb
+- lib/generators/flex/setup/setup_generator.rb
+- lib/generators/flex/setup/templates/flex_config.yml
+- lib/generators/flex/setup/templates/flex_dir/es.rb.erb
+- lib/generators/flex/setup/templates/flex_dir/es.yml.erb
+- lib/generators/flex/setup/templates/flex_dir/es_extender.rb.erb
+- lib/generators/flex/setup/templates/flex_initializer.rb.erb
+homepage: http://github.com/ddnexus/flex-rails
+licenses: []
+post_install_message: 
+rdoc_options:
+- --charset=UTF-8
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Rails integration for Flex
+test_files: []