picky 3.6.1 → 3.6.2

data/lib/picky/analytics.rb

@@ -0,0 +1,80 @@
+module Picky
+
+  # This class is wrapped around indexes
+  # and extracts useful information to be
+  # displayed in beoootiful, live-updating
+  # graphs.
+  #
+  class Analytics
+
+    attr_reader :indexes
+
+    def initialize *indexes
+      @indexes = Indexes.new *indexes
+    end
+
+    # Returns the number of tokens in all the inverted indexes.
+    #
+    def tokens
+      total = 0
+      indexes.each_bundle do |bundle|
+        total += bundle.inverted.size
+      end
+      total
+    end
+
+    def ids
+      total = 0
+      indexes.each_bundle do |bundle|
+        total += bundle.inverted.inject(0) { |total, (_, values)| total + values.size }
+      end
+      total
+    end
+
+    # def lengths index
+    #   min_ids_length = 1.0/0 # Infinity
+    #   max_ids_length =     0
+    #   min_key_length = 1.0/0 # Infinity
+    #   max_key_length =     0
+    #
+    #   key_size, ids_size = 0, 0
+    #   bundle.each_pair do |key, ids|
+    #     key_size = key.size
+    #     if key_size < min_key_length
+    #       min_key_length = key_size
+    #     else
+    #       max_key_length = key_size if key_size > max_key_length
+    #     end
+    #     key_length_average += key_size
+    #
+    #     ids_size = ids.size
+    #     if ids_size < min_ids_length
+    #       min_ids_length = ids_size
+    #     else
+    #       max_ids_length = ids_size if ids_size > max_ids_length
+    #     end
+    #     ids_length_average += ids_size
+    #   end
+    #   index_size = index.size
+    #   key_length_average = key_length_average.to_f / index_size
+    #   ids_length_average = ids_length_average.to_f / index_size
+    #
+    #   [
+    #     Lengths.new(index_size, key_length_average, (min_key_length..max_key_length)),
+    #     Lengths.new(index_size, ids_length_average, (min_ids_length..max_ids_length))
+    #   ]
+    # end
+    #
+    # # Contains an average and a range.
+    # #
+    # class Lengths
+    #
+    #   def initialize size, average, range
+    #     @size, @average, @range = size, average, range
+    #   end
+    #
+    # end
+
+  end
+
+end

data/lib/picky/backends/sqlite/db.rb

@@ -2,7 +2,7 @@ module Picky
 
   module Backends
 
-    class Sqlite
+    class SQLite
 
       class DB
 

data/lib/picky/backends/sqlite.rb

@@ -2,7 +2,7 @@ module Picky
 
   module Backends
 
-    class Sqlite < Backend
+    class SQLite < Backend
 
       def initialize options = {}
         super options

data/lib/picky/bundle.rb

@@ -23,8 +23,7 @@ module Picky
   class Bundle
 
     attr_reader :name,
-                :category,
-                :backend
+                :category
 
     attr_accessor :inverted,
                   :weights,
@@ -43,31 +42,35 @@ module Picky
     delegate :[], :[]=,        :to => :configuration
     delegate :index_directory, :to => :category
 
-    def initialize name, category, backend, weights_strategy, partial_strategy, similarity_strategy, options = {}
+    def initialize name, category, weights_strategy, partial_strategy, similarity_strategy, options = {}
       @name     = name
       @category = category
 
       # TODO Tidy up a bit.
       #
-      @key_format = options[:key_format]
+      @key_format = options.delete :key_format
+      @backend    = options.delete :backend
 
       @weights_strategy    = weights_strategy
       @partial_strategy    = partial_strategy
       @similarity_strategy = similarity_strategy
 
-      reset_backend backend
+      reset_backend
     end
     def identifier
       "#{category.identifier}:#{name}"
     end
 
-    # Resets the backend with the given one instantly.
+    # If no specific backend has been set,
+    # uses the category's backend.
     #
-    # TODO Redesign such that the backend is only
-    #      generated lazily.
-    #      And reset using backend = nil.
+    def backend
+      @backend || category.backend
+    end
+
+    # Initializes all necessary indexes from the backend.
     #
-    def reset_backend backend
+    def reset_backend
       # Extract specific indexes from backend.
       #
       # TODO Clean up all related.

data/lib/picky/bundle_indexing.rb

@@ -28,8 +28,6 @@ module Picky
   #
   class Bundle
 
-    attr_reader :backend
-
     # When indexing, clear only clears the inverted index.
     #
     delegate :clear,

data/lib/picky/categories.rb

@@ -11,9 +11,9 @@ module Picky
 
     each_delegate :cache,
                   :dump,
-                  :each_category,
                   :empty,
                   :index,
+                  :inject,
                   :reindex,
                   :reset_backend,
                   :to => :categories

data/lib/picky/categories_convenience.rb

@@ -0,0 +1,15 @@
+module Picky
+
+  #
+  #
+  class Categories
+
+    each_delegate :each_bundle,
+                  :to => :categories
+
+    def each_category &block
+      categories.each &block
+    end
+  end
+
+end

data/lib/picky/category.rb

@@ -5,7 +5,8 @@ module Picky
     attr_reader :name,
                 :exact,
                 :partial,
-                :prepared
+                :prepared,
+                :backend
 
     # Mandatory params:
     #  * name: Category name to use as identifier and file names.
@@ -32,10 +33,13 @@ module Picky
       @source     = options[:source]
       @from       = options[:from]
       @tokenizer  = options[:tokenizer]
-      @key_format = options[:key_format]
-      # @symbols    = options[:use_symbols] || index.use_symbols? # TODO Symbols.
+
+      @key_format = options.delete :key_format
+      @backend    = options.delete :backend
+
       @qualifiers = extract_qualifiers_from options
-      # TODO backend option!
+
+      # @symbols    = options[:use_symbols] || index.use_symbols? # TODO Symbols.
 
       weights    = options[:weights]    || Generators::Weights::Default
       partial    = options[:partial]    || Generators::Partial::Default
@@ -44,11 +48,11 @@ module Picky
       no_partial    = Generators::Partial::None.new
       no_similarity = Generators::Similarity::None.new
 
-      @exact = Bundle.new :exact, self, index.backend, weights, no_partial, similarity, options
+      @exact = Bundle.new :exact, self, weights, no_partial, similarity, options
       if partial.use_exact_for_partial?
         @partial = Wrappers::Bundle::ExactPartial.new @exact
       else
-        @partial = Bundle.new :partial, self, index.backend, weights, partial, no_similarity, options
+        @partial = Bundle.new :partial, self, weights, partial, no_similarity, options
       end
 
       @prepared = Backends::Memory::Text.new prepared_index_path
@@ -69,15 +73,18 @@ module Picky
       timed_exclaim %Q{"#{identifier}": Generated -> #{index_directory.gsub("#{PICKY_ROOT}/", '')}.}
     end
 
-    # Resets backends in both bundles.
+    # Returns the backend.
     #
-    # This will only set the backend
+    # If no specific backend has been defined for this
     #
-    def reset_backend backend
-      unless @backend
-        exact.reset_backend backend
-        partial.reset_backend backend
-      end
+    def backend
+      @backend || @index.backend
+    end
+    # Resets backends in both bundles.
+    #
+    def reset_backend
+      exact.reset_backend
+      partial.reset_backend
     end
 
     # Index name.

data/lib/picky/category_convenience.rb

@@ -0,0 +1,16 @@
+module Picky
+
+  class Category
+
+    def each_bundle &block
+      if block
+        yield exact
+        yield partial
+      else
+        [exact, partial]
+      end
+    end
+
+  end
+
+end

data/lib/picky/generators/weights/logarithmic.rb

@@ -20,7 +20,7 @@ module Picky
         #
         def weight_for amount
           return 0 if amount < 1
-          Math.log amount
+          Math.log(amount).round 3
         end
 
       end

data/lib/picky/index.rb

@@ -91,7 +91,9 @@ module Picky
 
     delegate :[],
              :dump,
-             :each_category,
+             :each,
+             :inject,
+             :reset_backend,
              :to => :categories
 
     # Create a new index with a given source.
@@ -132,18 +134,12 @@ module Picky
     #
     def backend backend = nil
       if backend
-        @backend = reset_backend backend
+        @backend = backend
+        reset_backend
       else
         @backend ||= Backends::Memory.new
       end
     end
-    # TODO Rewrite such that reset_backend just sets the
-    #      lazily evaluated backend to nil.
-    #
-    def reset_backend backend
-      categories.reset_backend backend
-      backend
-    end
 
     # TODO Symbols.
     #

data/lib/picky/index_convenience.rb

@@ -0,0 +1,13 @@
+module Picky
+
+  #
+  #
+  class Index
+
+    delegate :each_bundle,
+             :each_category,
+             :to => :categories
+
+  end
+
+end

data/lib/picky/indexes.rb

@@ -16,11 +16,11 @@ module Picky
              :to => :indexes
 
     each_delegate :reindex,
-                  :each_category,
                   :to => :indexes
 
-    def initialize
+    def initialize *indexes
       clear_indexes
+      indexes.each { |index| register index }
     end
 
     # Return the Indexes instance.

data/lib/picky/indexes_convenience.rb

@@ -0,0 +1,11 @@
+module Picky
+
+  class Indexes
+
+    each_delegate :each_bundle,
+                  :each_category,
+                  :to => :indexes
+
+  end
+
+end

data/lib/picky/loader.rb

@@ -209,20 +209,24 @@ module Picky
       load_relative 'category_indexed'
       load_relative 'category_indexing'
       load_relative 'category_realtime'
+      load_relative 'category_convenience'
 
       load_relative 'categories'
       load_relative 'categories_indexed'
       load_relative 'categories_indexing'
       load_relative 'categories_realtime'
+      load_relative 'categories_convenience'
 
       load_relative 'indexes'
       load_relative 'indexes_indexed'
       load_relative 'indexes_indexing'
+      load_relative 'indexes_convenience'
 
       load_relative 'index'
       load_relative 'index_indexed'
       load_relative 'index_indexing'
       load_relative 'index_realtime'
+      load_relative 'index_convenience'
 
       # Results.
       #

data/spec/lib/analytics_spec.rb

@@ -0,0 +1,65 @@
+# encoding: utf-8
+#
+require 'spec_helper'
+
+# Not loaded by default.
+#
+require File.expand_path '../../../lib/picky/analytics', __FILE__
+
+describe Picky::Analytics do
+
+  attr_reader :index1, :index2
+
+  Item = Struct.new :id, :text
+
+  before(:all) do
+    @index1 = Picky::Index.new :index1 do
+      source [
+        Item.new(1, 'test one'),
+        Item.new(2, 'test two'),
+      ]
+      category :text
+    end
+    @index1.index
+    @index1
+
+    @index2 = Picky::Index.new :index2 do
+      source [
+        Item.new(3, 'test three'),
+        Item.new(4, 'test four'),
+      ]
+      category :text
+    end
+    @index2.index
+    @index2
+  end
+
+  let(:analytics) { described_class.new index1, index2 }
+
+  it 'can be initialized' do
+    analytics # La-zee
+  end
+
+  it 'saves the indexes' do
+    analytics.indexes.should be_kind_of(Picky::Indexes)
+  end
+
+  describe 'tokens' do
+    it 'offers the method' do
+      analytics.tokens
+    end
+    it 'calculates the number of tokens correctly' do
+      analytics.tokens.should == 24
+    end
+  end
+
+  describe 'ids' do
+    it 'offers the method' do
+      analytics.ids
+    end
+    it 'calculates the number of ids correctly' do
+      analytics.ids.should == 32
+    end
+  end
+
+end

data/spec/lib/backends/sqlite/db_spec.rb

@@ -2,7 +2,7 @@ require 'spec_helper'
 
 require 'sqlite3'
 
-describe Picky::Backends::Sqlite::DB do
+describe Picky::Backends::SQLite::DB do
 
   context 'hash-based indexes' do
     let(:db) { described_class.new 'some/cache/path/to/file' }
@@ -72,7 +72,7 @@ describe Picky::Backends::Sqlite::DB do
 
     describe 'to_s' do
       it 'returns the cache path with the default file extension' do
-        db.to_s.should == 'Picky::Backends::Sqlite::DB(some/cache/path/to/file.sqlite3)'
+        db.to_s.should == 'Picky::Backends::SQLite::DB(some/cache/path/to/file.sqlite3)'
       end
     end
   end

data/spec/lib/backends/sqlite_spec.rb

@@ -1,23 +1,23 @@
 require 'spec_helper'
 
-describe Picky::Backends::Sqlite do
+describe Picky::Backends::SQLite do
 
   context 'with options' do
     before(:each) do
-      @backend = described_class.new inverted:      Picky::Backends::Sqlite::DB.new(:unimportant),
-                                     weights:       Picky::Backends::Sqlite::DB.new(:unimportant),
-                                     similarity:    Picky::Backends::Sqlite::DB.new(:unimportant),
-                                     configuration: Picky::Backends::Sqlite::DB.new(:unimportant)
+      @backend = described_class.new inverted:      Picky::Backends::SQLite::DB.new(:unimportant),
+                                     weights:       Picky::Backends::SQLite::DB.new(:unimportant),
+                                     similarity:    Picky::Backends::SQLite::DB.new(:unimportant),
+                                     configuration: Picky::Backends::SQLite::DB.new(:unimportant)
 
       @backend.stub! :timed_exclaim
     end
-  
+
     describe 'create_...' do
       [
-        [:inverted,      Picky::Backends::Sqlite::DB],
-        [:weights,       Picky::Backends::Sqlite::DB],
-        [:similarity,    Picky::Backends::Sqlite::DB],
-        [:configuration, Picky::Backends::Sqlite::DB]
+        [:inverted,      Picky::Backends::SQLite::DB],
+        [:weights,       Picky::Backends::SQLite::DB],
+        [:similarity,    Picky::Backends::SQLite::DB],
+        [:configuration, Picky::Backends::SQLite::DB]
       ].each do |type, kind|
         it "creates and returns a(n) #{type} index" do
           @backend.send(:"create_#{type}",
@@ -27,23 +27,23 @@ describe Picky::Backends::Sqlite do
       end
     end
   end
-  
+
   context 'with lambda options' do
     before(:each) do
-      @backend = described_class.new inverted:      ->(bundle){ Picky::Backends::Sqlite::DB.new(bundle.index_path(:inverted)) },
-                                     weights:       ->(bundle){ Picky::Backends::Sqlite::DB.new(bundle.index_path(:weights)) },
-                                     similarity:    ->(bundle){ Picky::Backends::Sqlite::DB.new(bundle.index_path(:similarity)) },
-                                     configuration: ->(bundle){ Picky::Backends::Sqlite::DB.new(bundle.index_path(:configuration)) }
+      @backend = described_class.new inverted:      ->(bundle){ Picky::Backends::SQLite::DB.new(bundle.index_path(:inverted)) },
+                                     weights:       ->(bundle){ Picky::Backends::SQLite::DB.new(bundle.index_path(:weights)) },
+                                     similarity:    ->(bundle){ Picky::Backends::SQLite::DB.new(bundle.index_path(:similarity)) },
+                                     configuration: ->(bundle){ Picky::Backends::SQLite::DB.new(bundle.index_path(:configuration)) }
 
       @backend.stub! :timed_exclaim
     end
-  
+
     describe 'create_...' do
       [
-        [:inverted,      Picky::Backends::Sqlite::DB],
-        [:weights,       Picky::Backends::Sqlite::DB],
-        [:similarity,    Picky::Backends::Sqlite::DB],
-        [:configuration, Picky::Backends::Sqlite::DB]
+        [:inverted,      Picky::Backends::SQLite::DB],
+        [:weights,       Picky::Backends::SQLite::DB],
+        [:similarity,    Picky::Backends::SQLite::DB],
+        [:configuration, Picky::Backends::SQLite::DB]
       ].each do |type, kind|
         it "creates and returns a(n) #{type} index" do
           to_a_able_stub = Object.new
@@ -60,13 +60,13 @@ describe Picky::Backends::Sqlite do
 
       @backend.stub! :timed_exclaim
     end
-  
+
     describe 'create_...' do
       [
-        [:inverted,      Picky::Backends::Sqlite::DB],
-        [:weights,       Picky::Backends::Sqlite::DB],
-        [:similarity,    Picky::Backends::Sqlite::DB],
-        [:configuration, Picky::Backends::Sqlite::DB]
+        [:inverted,      Picky::Backends::SQLite::DB],
+        [:weights,       Picky::Backends::SQLite::DB],
+        [:similarity,    Picky::Backends::SQLite::DB],
+        [:configuration, Picky::Backends::SQLite::DB]
       ].each do |type, kind|
         it "creates and returns a(n) #{type} index" do
           @backend.send(:"create_#{type}",
@@ -75,7 +75,7 @@ describe Picky::Backends::Sqlite do
         end
       end
     end
-  
+
     describe "ids" do
       before(:each) do
         @combination1 = stub :combination1

data/spec/lib/bundle_spec.rb

@@ -9,7 +9,6 @@ describe Picky::Bundle do
   let(:bundle) do
     described_class.new :some_name,
                         @category,
-                        Picky::Backends::Memory.new,
                         Picky::Generators::Weights::Default,
                         Picky::Generators::Partial::Default,
                         Picky::Generators::Similarity::DoubleMetaphone.new(3)

data/spec/lib/generators/weights/logarithmic_spec.rb

@@ -18,7 +18,7 @@ describe Picky::Generators::Weights::Logarithmic do
       logarithmic.weight_for(1).should == 0
     end
     it 'is log(x) for x' do
-      logarithmic.weight_for(1234).should == Math.log(1234)
+      logarithmic.weight_for(1234).should == Math.log(1234).round(3)
     end
   end
 

data/spec/lib/indexed/bundle_realtime_spec.rb

@@ -9,7 +9,7 @@ describe Picky::Bundle do
     @weights      = Picky::Generators::Weights::Default
     @partial      = Picky::Generators::Partial::Default
     @similarity   = Picky::Generators::Similarity::DoubleMetaphone.new 3
-    @bundle       = described_class.new :some_name, @category, Picky::Backends::Memory.new, @weights, @partial, @similarity
+    @bundle       = described_class.new :some_name, @category, @weights, @partial, @similarity
   end
 
   it 'is by default empty' do
@@ -32,7 +32,7 @@ describe Picky::Bundle do
 
       @bundle.realtime_mapping.should == { 1 => [:title], 2 => [:title] }
       @bundle.inverted.should == { :title => [2,1] }
-      @bundle.weights.should == { :title => 0.6931471805599453 }
+      @bundle.weights.should == { :title => 0.693 }
       @bundle.similarity.should == { :TTL => [:title] }
     end
     it 'works correctly' do

data/spec/lib/indexed/bundle_spec.rb

@@ -9,7 +9,7 @@ describe Picky::Bundle do
     @weights      = stub :weights, :saved? => true
     @partial      = stub :partial, :saved? => true
     @similarity   = stub :similarity, :saved? => true
-    @bundle       = described_class.new :some_name, @category, Picky::Backends::Memory.new, @weights, @partial, @similarity
+    @bundle       = described_class.new :some_name, @category, @weights, @partial, @similarity
   end
 
   describe 'to_s' do
@@ -160,7 +160,7 @@ describe Picky::Bundle do
 
       @weights = stub :weights, :saved? => true
       @partial = stub :partial, :saved? => true
-      @bundle = described_class.new :some_name, @category, Picky::Backends::Memory.new, @weights, @partial, :similarity
+      @bundle = described_class.new :some_name, @category, @weights, @partial, :similarity
     end
     it 'should initialize the index correctly' do
       @bundle.backend_inverted.should be_kind_of(Picky::Backends::Memory::JSON)

data/spec/lib/indexing/bundle_spec.rb

@@ -8,7 +8,7 @@ describe Picky::Bundle do
     @weights    = Picky::Weights::Logarithmic.new
     @similarity = Picky::Similarity::DoubleMetaphone.new 3
   end
-  let(:bundle) { described_class.new :some_name, @category, Picky::Backends::Memory.new, @weights, :some_partial, @similarity }
+  let(:bundle) { described_class.new :some_name, @category, @weights, :some_partial, @similarity }
 
   describe 'identifier' do
     it 'is correct' do

data/spec/specific/dynamic_weights_spec.rb

@@ -28,7 +28,7 @@ describe "Weights" do
     try.search("text1:ohai").allocations.first.score.should    == 0.0
     try.search("text2:hello").allocations.first.score.should   == 3.14
     try.search("text3:world").allocations.first.score.should   == 5
-    try.search("text4:kthxbye").allocations.first.score.should == 0.6931471805599453
+    try.search("text4:kthxbye").allocations.first.score.should == 0.693
 
     try_with_boosts = Picky::Search.new index do
       boost [:text1] => +7.65,

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: picky
 version: !ruby/object:Gem::Version
-  version: 3.6.1
+  version: 3.6.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-11-19 00:00:00.000000000 Z
+date: 2011-11-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70158190692520 !ruby/object:Gem::Requirement
+  requirement: &70240308070780 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,21 +21,21 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70158190692520
+  version_requirements: *70240308070780
 - !ruby/object:Gem::Dependency
   name: picky-client
-  requirement: &70158190692020 !ruby/object:Gem::Requirement
+  requirement: &70240308070180 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 3.6.1
+        version: 3.6.2
   type: :development
   prerelease: false
-  version_requirements: *70158190692020
+  version_requirements: *70240308070180
 - !ruby/object:Gem::Dependency
   name: rack
-  requirement: &70158190691600 !ruby/object:Gem::Requirement
+  requirement: &70240308069700 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70158190691600
+  version_requirements: *70240308069700
 - !ruby/object:Gem::Dependency
   name: rack_fast_escape
-  requirement: &70158190691140 !ruby/object:Gem::Requirement
+  requirement: &70240308069140 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,10 +54,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70158190691140
+  version_requirements: *70240308069140
 - !ruby/object:Gem::Dependency
   name: text
-  requirement: &70158190690720 !ruby/object:Gem::Requirement
+  requirement: &70240308067860 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -65,10 +65,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70158190690720
+  version_requirements: *70240308067860
 - !ruby/object:Gem::Dependency
   name: yajl-ruby
-  requirement: &70158190706680 !ruby/object:Gem::Requirement
+  requirement: &70240308066300 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -76,10 +76,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70158190706680
+  version_requirements: *70240308066300
 - !ruby/object:Gem::Dependency
   name: activesupport
-  requirement: &70158190706180 !ruby/object:Gem::Requirement
+  requirement: &70240308080860 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -87,10 +87,10 @@ dependencies:
         version: '3.0'
   type: :runtime
   prerelease: false
-  version_requirements: *70158190706180
+  version_requirements: *70240308080860
 - !ruby/object:Gem::Dependency
   name: activerecord
-  requirement: &70158190705680 !ruby/object:Gem::Requirement
+  requirement: &70240308078980 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -98,10 +98,10 @@ dependencies:
         version: '3.0'
   type: :runtime
   prerelease: false
-  version_requirements: *70158190705680
+  version_requirements: *70240308078980
 - !ruby/object:Gem::Dependency
   name: unicorn
-  requirement: &70158190705300 !ruby/object:Gem::Requirement
+  requirement: &70240308077500 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -109,10 +109,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70158190705300
+  version_requirements: *70240308077500
 - !ruby/object:Gem::Dependency
   name: sinatra
-  requirement: &70158190704840 !ruby/object:Gem::Requirement
+  requirement: &70240308075680 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -120,10 +120,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70158190704840
+  version_requirements: *70240308075680
 - !ruby/object:Gem::Dependency
   name: redis
-  requirement: &70158190704420 !ruby/object:Gem::Requirement
+  requirement: &70240308074260 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -131,10 +131,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70158190704420
+  version_requirements: *70240308074260
 - !ruby/object:Gem::Dependency
   name: mysql
-  requirement: &70158190704000 !ruby/object:Gem::Requirement
+  requirement: &70240308089700 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -142,7 +142,7 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70158190704000
+  version_requirements: *70240308089700
 description: Fast Ruby semantic text search engine with comfortable single field interface.
 email: florian.hanke+picky@gmail.com
 executables:
@@ -156,6 +156,7 @@ files:
 - lib/picky/adapters/rack/live_parameters.rb
 - lib/picky/adapters/rack/search.rb
 - lib/picky/adapters/rack.rb
+- lib/picky/analytics.rb
 - lib/picky/analyzer.rb
 - lib/picky/application.rb
 - lib/picky/backends/backend.rb
@@ -182,10 +183,12 @@ files:
 - lib/picky/bundle_realtime.rb
 - lib/picky/calculations/location.rb
 - lib/picky/categories.rb
+- lib/picky/categories_convenience.rb
 - lib/picky/categories_indexed.rb
 - lib/picky/categories_indexing.rb
 - lib/picky/categories_realtime.rb
 - lib/picky/category.rb
+- lib/picky/category_convenience.rb
 - lib/picky/category_indexed.rb
 - lib/picky/category_indexing.rb
 - lib/picky/category_realtime.rb
@@ -226,6 +229,7 @@ files:
 - lib/picky/generators/weights/strategy.rb
 - lib/picky/helpers/measuring.rb
 - lib/picky/index.rb
+- lib/picky/index_convenience.rb
 - lib/picky/index_indexed.rb
 - lib/picky/index_indexing.rb
 - lib/picky/index_realtime.rb
@@ -233,6 +237,7 @@ files:
 - lib/picky/indexers/parallel.rb
 - lib/picky/indexers/serial.rb
 - lib/picky/indexes.rb
+- lib/picky/indexes_convenience.rb
 - lib/picky/indexes_indexed.rb
 - lib/picky/indexes_indexing.rb
 - lib/picky/interfaces/live_parameters.rb
@@ -286,6 +291,7 @@ files:
 - spec/lib/adapters/rack/base_spec.rb
 - spec/lib/adapters/rack/live_parameters_spec.rb
 - spec/lib/adapters/rack/query_spec.rb
+- spec/lib/analytics_spec.rb
 - spec/lib/analyzer_spec.rb
 - spec/lib/application_spec.rb
 - spec/lib/backends/backend_spec.rb
@@ -414,6 +420,7 @@ test_files:
 - spec/lib/adapters/rack/base_spec.rb
 - spec/lib/adapters/rack/live_parameters_spec.rb
 - spec/lib/adapters/rack/query_spec.rb
+- spec/lib/analytics_spec.rb
 - spec/lib/analyzer_spec.rb
 - spec/lib/application_spec.rb
 - spec/lib/backends/backend_spec.rb