mebla 1.0.0.rc2

data/.document

@@ -0,0 +1,6 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt
+TODO.md

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in Rakefile
+gemspec

data/Gemfile.lock

@@ -0,0 +1,79 @@
+PATH
+  remote: .
+  specs:
+    mebla (1.0.0.rc1)
+      bson (= 1.2.0)
+      bson_ext (= 1.2.0)
+      mebla
+      mongoid (= 2.0.0.rc.7)
+      slingshot-rb (~> 0.0.6)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activemodel (3.0.5)
+      activesupport (= 3.0.5)
+      builder (~> 2.1.2)
+      i18n (~> 0.4)
+    activesupport (3.0.5)
+    bluecloth (2.1.0)
+    bson (1.2.0)
+    bson_ext (1.2.0)
+    builder (2.1.2)
+    database_cleaner (0.6.4)
+    diff-lcs (1.1.2)
+    git (1.2.5)
+    i18n (0.5.0)
+    jeweler (1.5.2)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    mime-types (1.16)
+    mongo (1.2.0)
+      bson (>= 1.2.0)
+    mongoid (2.0.0.rc.7)
+      activemodel (~> 3.0)
+      mongo (~> 1.2)
+      tzinfo (~> 0.3.22)
+      will_paginate (~> 3.0.pre)
+    mongoid-rspec (1.4.1)
+      mongoid (~> 2.0.0.rc.7)
+      mongoid-rspec
+      rspec (~> 2)
+    rake (0.8.7)
+    rcov (0.9.9)
+    rest-client (1.6.1)
+      mime-types (>= 1.16)
+    rspec (2.3.0)
+      rspec-core (~> 2.3.0)
+      rspec-expectations (~> 2.3.0)
+      rspec-mocks (~> 2.3.0)
+    rspec-core (2.3.1)
+    rspec-expectations (2.3.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.3.0)
+    slingshot-rb (0.0.6)
+      bundler (~> 1.0.0)
+      rest-client (~> 1.6.0)
+      yajl-ruby (> 0.7.9)
+    tzinfo (0.3.24)
+    will_paginate (3.0.pre2)
+    yajl-ruby (0.8.1)
+    yard (0.6.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bluecloth (~> 2.1.0)
+  bson (= 1.2.0)
+  bson_ext (= 1.2.0)
+  bundler (~> 1.0.0)
+  database_cleaner (= 0.6.4)
+  jeweler (~> 1.5.2)
+  mebla!
+  mongoid (= 2.0.0.rc.7)
+  mongoid-rspec (= 1.4.1)
+  rcov
+  rspec (~> 2.3.0)
+  yard (~> 0.6.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Omar Mekky
+
+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,250 @@
+Mebla
+====
+
+Mebla is an [elasticsearch](http://www.elasticsearch.org) wrapper for [Mongoid](http://mongoid.org) based on 
+[Slingshot](https://github.com/karmi/slingshot).
+
+Name
+---------
+
+Mebla is derived from the word "Nebla", which means slingshot in arabic.
+
+Also since its a wrapper for mongoid ODM, the letter "N" is replaced with "M".
+
+Installation
+---------------
+
+### Install elasticsearch
+
+Mebla requires a running [elasticsearch](http://www.elasticsearch.org) installation.
+
+To install elasticsearch follow the uptodate instructions [here](http://www.elasticsearch.org/guide/reference/setup/) or
+simply copy and paste in your terminal window:
+
+    $ curl -k -L -o elasticsearch-0.15.0.tar.gz http://github.com/downloads/elasticsearch/elasticsearch/elasticsearch-0.15.0.tar.gz
+    $ tar -zxvf elasticsearch-0.15.0.tar.gz
+    $ ./elasticsearch-0.15.0/bin/elasticsearch -f
+
+### Install Mebla
+
+Once elasticsearch is installed, add Mebla to your gem file:
+
+    gem "mebla"
+    
+then run bundle in your application root to update your gems' bundle:
+
+    $ bundle install
+    
+next generate the configuration file:
+
+    $ rails generate mebla:install
+    
+finally index your data:
+
+    $ rake mebla:index_data
+    
+Usage
+---------
+
+### Defining indexed fields
+
+To enable searching models, you first have to define which fields mebla should index:
+
+    class Post
+      include Mongoid::Document
+      include Mongoid::Mebla
+      field :title
+      field :author
+      field :body
+      field :publish_date, :type => Date
+      field :tags, :type => Array
+      
+      embeds_many :comments
+      search_in :author, :body, :publish_date, :tags, :title => { :boost => 2.0, :analyzer => 'snowball' }
+    end
+    
+In the example above, mebla will index the author field, body field, publish_date field and finally indexes
+the title field with some custom [mappings](http://www.elasticsearch.org/guide/reference/mapping).
+
+#### Embedded documents
+
+You can also index embedded documents as follows:
+
+    class Comment
+      include Mongoid::Document
+      include Mongoid::Mebla
+      field :comment
+      field :author
+      
+      embedded_in :blog_post
+      search_in :comment, :author, :embedded_in => :blog_post
+    end
+    
+This will index all comments and make it available for searching directly through the Comment model.
+
+### Searching the index
+
+Mebla supports two types of search, index search and model search; in index search Mebla searches
+the index and returns all matching documents regardless of their types, in model search however
+Mebla searches the index and returns matching documents of the model(s) type(s).
+documents
+
+Mebla performs search using [Slingshot's searching DSL](http://karmi.github.com/slingshot/), I encourage
+you to check the tutorial to have a broader view of slingshot's capabilities.
+
+#### Index searching
+
+Using the same models we defined above, we can search for all posts and comments with the author "cousine":
+
+    Mebla.search do
+      query do
+        string "author: cousine"
+      end
+    end
+
+This will return all documents with an author set to "cousine" regardless of their type, if we however want to
+search only Posts and Comments, we would explicitly tell Mebla:
+
+    Mebla.search [:post, :comment] do 
+      query { string "author: cousine" }
+    end
+    
+As shown above, you can also use the shorthand notation of ruby blocks.
+
+#### Model searching
+
+Instead of searching all models like index searching, we can search one model only:
+
+    Post.search do
+      query { string "title: Testing Search" }
+      
+      filter :term, :author => "cousine"
+      filter :terms, :tags => ["ruby", "rails"]
+      
+      sort { publish_date "desc" }
+      
+      facet 'tags' do
+        terms :tags, :global => true
+      end
+      
+      facet 'authors' do
+        terms :author
+      end
+    end
+    
+In the above example we are taking full advantage of slingshot's searching capabilities, 
+we are getting all posts with the title "Testing Search", filtering the results with author 
+"cousine", tagged "ruby" or "rails", and sorting the results with their publish_date fields.
+
+One more feature we are using is "Faceted Search", from Slingshot's homepage:
+
+> _Faceted Search_
+>
+> _ElasticSearch makes it trivial to retrieve complex aggregated data from the index/database, so called 
+[facets](http://www.lucidimagination.com/Community/Hear-from-the-Experts/Articles/Faceted-Search-Solr)._
+
+In the example above we are retrieving two facets, "tags" and "authors"; "tags" are global
+which means that we want to get the counts of posts for each tag over the whole index, "authors"
+however will only get the count of posts matching the search query for each author.
+
+You can find more about searching [here](http://karmi.github.com/slingshot/)
+
+#### Retrieving results
+
+To retrieve the results of the model search we performed above we would simply:
+
+    hits = Post.search do
+      query { string "title: Testing Search" }
+      
+      filter :term, :author => "cousine"
+      filter :terms, :tags => ["ruby", "rails"]
+      
+      sort { publish_date "desc" }
+      
+      facet 'tags' do
+        terms :tags, :global => true
+      end
+      
+      facet 'authors' do
+        terms :author
+      end
+    end
+    
+    hits.each do |hit|
+      puts hit.title
+    end
+    
+To retrieve the facets:
+
+    # Get the count of posts for each tag accross the index
+    hits.facets['tags']['terms'].each do |facet|
+      puts "#{facet['term']} : #{facet['count']}"
+    end
+    
+    # Get the count of posts matching the query for each author
+    hits.facets['authors']['terms'].each do |facet|
+      puts "#{facet['term']} : #{facet['count']}"
+    end
+    
+### Indexing data
+
+#### Synchronizing data
+
+By default Mebla synchronizes all changes done to your models with your index, if however
+you would like to bypass this behavior:
+
+    Post.without_indexing do
+      Post.create :title => "This won't be indexed"
+    end
+    
+#### Indexing existing data
+
+You can index existing data by using the "index" rake task:
+
+    $ rake mebla:index
+    
+This will create the index and index all the data in the database
+
+#### Reindexing
+
+Just like indexing, you can reindex your data using the "reindex" rake task:
+
+    $ rake mebla:reindex
+    
+This will rebuild the index and index all your data again, note that unlike other full-text
+search engines, you don't need to reindex your data frequently (if ever) however you 
+might want to refresh the index so changes are reflected on the index.
+
+#### Refreshing the index
+
+Refreshing the index makes changes done to the index available for searching or modification.
+
+Mebla automatically refreshes the index whenever a change is done, but just incase you
+need to refresh the index:
+
+    $ rake mebla:refresh
+    
+### Rake tasks
+
+Mebla provides a number of rake tasks to perform various tasks on the index, you can
+list all tasks using this command:
+
+    $ rake -T mebla
+
+Contributing to Mebla
+----------------------------
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+Copyright
+-------------
+
+Copyright (c) 2011 Omar Mekky. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,57 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "mebla"
+  gem.homepage = "http://github.com/cousine/mebla"
+  gem.license = "MIT"
+  gem.summary = %Q{An elasticsearch wrapper for mongoid odm based on slingshot.}
+  gem.description = %Q{
+    An elasticsearch wrapper for mongoid odm based on slingshot. Makes integration between ElasticSearch full-text 
+    search engine and Mongoid documents seemless and simple.
+  }
+  gem.email = "omar.mekky@mashsolvents.com"
+  gem.authors = ["Omar Mekky"]
+  # Include your dependencies below. Runtime dependencies are required when using your gem,
+  # and development dependencies are only needed for development (ie running rake tasks, tests, etc)
+  gem.add_runtime_dependency 'slingshot-rb', '~> 0.0.6'
+  gem.add_runtime_dependency 'mongoid', '2.0.0.rc.7'
+  gem.add_runtime_dependency 'bson', '1.2.0'
+  gem.add_runtime_dependency 'bson_ext', '1.2.0'
+  
+  gem.add_development_dependency 'rspec', '~> 2.3.0'
+  gem.add_development_dependency 'yard', '~> 0.6.0'
+  gem.add_development_dependency 'bundler', '~> 1.0.0'
+  gem.add_development_dependency 'jeweler', '~> 1.5.2'
+  gem.add_development_dependency 'rcov', '>= 0'
+  gem.add_development_dependency 'mongoid-rspec', '1.4.1'
+  gem.add_development_dependency 'database_cleaner', '0.6.4'
+  gem.add_development_dependency 'bluecloth', '~> 2.1.0'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/TODO.md

@@ -0,0 +1,12 @@
+TODO for version 1.0.0
+==============
+
+* <strike>add documentation for mebla in README.md</strike>
+* <strike>add logging capabilities</strike>
+
+Future plan
+=======
+
+* add ability to index embedded documents (as part of the parent document)
+* optimize : should find a solution for not refreshing the index while indexing embedded documents in lib/mebla/context
+* optimize : refractor result_set

data/VERSION

@@ -0,0 +1 @@
+1.0.0.rc2

data/lib/generators/mebla/install/USAGE

@@ -0,0 +1,7 @@
+Description:
+    Generates mebla's configuration file.
+
+Example:
+    rails generate mebla:install
+
+    This will generate mebla's configuration file in config folder

data/lib/generators/mebla/install/install_generator.rb

@@ -0,0 +1,46 @@
+# @private
+module Mebla  
+  # @private
+  class InstallGenerator < Rails::Generators::Base
+    source_root File.expand_path('../templates', __FILE__)
+    
+    # Generates mebla's configuration file
+    def generate_configuration
+      template "mebla.yml", "config/mebla.yml"
+    end
+    
+    private
+    def app_name
+      @app_name ||= defined_app_const_base? ? defined_app_name : File.basename(destination_root)
+    end
+
+    def defined_app_name
+      defined_app_const_base.underscore
+    end
+
+    def defined_app_const_base
+      Rails.respond_to?(:application) && defined?(Rails::Application) &&
+        Rails.application.is_a?(Rails::Application) && Rails.application.class.name.sub(/::Application$/, "")
+      end
+
+    alias :defined_app_const_base? :defined_app_const_base
+
+    def app_const_base
+      @app_const_base ||= defined_app_const_base || app_name.gsub(/\W/, '_').squeeze('_').camelize
+    end
+
+    def app_const
+      @app_const ||= "#{app_const_base}::Application"
+    end
+
+    def valid_app_const?
+      if app_const =~ /^\d/
+        raise Error, "Invalid application name #{app_name}. Please give a name which does not start with numbers."
+      elsif RESERVED_NAMES.include?(app_name)
+        raise Error, "Invalid application name #{app_name}. Please give a name which does not match one of the reserved rails words."
+      elsif Object.const_defined?(app_const_base)
+        raise Error, "Invalid application name #{app_name}, constant #{app_const_base} is already in use. Please choose another application name."
+      end
+    end
+  end
+end

data/lib/generators/mebla/install/templates/mebla.yml

@@ -0,0 +1,15 @@
+defaults: &defaults
+  host: localhost
+  port: 9200
+  
+development:
+  <<: *defaults
+  index: <%= app_name %>_development
+  
+test:
+  <<: *defaults
+  index: <%= app_name %>_test
+  
+production:
+  <<: *defaults
+  index: <%= app_name %>_production

data/lib/mebla/configuration.rb

@@ -0,0 +1,73 @@
+require 'erb'
+require 'singleton'
+
+# @private
+module Mebla
+  # Parses the configuration file and holds important configuration attributes  
+  class Configuration
+    include Singleton
+    
+    attr_reader :log_dir
+    attr_accessor :index, :host, :port, :logger
+    
+    # @private
+    def initialize
+      @log_dir = "#{Dir.pwd}/tmp/log"
+      parse_config      
+      
+      # Setup defaults
+      @index ||= "mebla"
+      @host ||= "localhost"
+      @port ||= 9200
+      
+      make_tmp_dir
+      @logger = Logger.new(
+        open("#{@log_dir}/mebla.log", "a")
+      )
+      @logger.level = Logger::DEBUG
+      
+      setup_logger        
+      
+      # Setup slingshot
+      Slingshot::Configuration.url(self.url)
+    end
+    
+    # Sets up the default settings of the logger
+    # @return [nil]
+    def setup_logger
+      @logger.datetime_format = "%Y-%m-%d %H:%M:%S"
+      @logger.formatter = proc { |severity, datetime, progname, msg|
+        "#{datetime}: #{msg}\n"
+      }
+    end
+    
+    # Returns the proper url for elasticsearch
+    # @return [String] url representation of the configuration options host and port
+    def url
+      "http://#{@host}:#{@port}"
+    end
+    
+    private    
+    # Creates tmp directory if it doesn't exist
+    # @return [nil]
+    def make_tmp_dir
+      FileUtils.mkdir_p @log_dir
+      Dir["#{@log_dir}/*"].each do |file|
+        FileUtils.rm_rf file
+      end
+    end
+    
+    # Loads the configuration file
+    # @return [nil]
+    def parse_config      
+      path = "#{Rails.root}/config/mebla.yml"
+      return unless File.exists?(path)
+      
+      conf = YAML::load(ERB.new(IO.read(path)).result)[Rails.env]
+      
+      conf.each do |key,value|
+        self.send("#{key}=", value) if self.respond_to?("#{key}=")
+      end unless conf.nil?
+    end
+  end
+end