sherpa99-thinking-sphinx 1.1.4

data/LICENCE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Pat Allan
+
+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

@@ -0,0 +1,107 @@
+= Thinking Sphinx
+
+== Usage
+
+First, if you haven't done so already, check out the main usage[http://ts.freelancing-gods.com/usage.html] page. Once you've done that, the next place to look for information is the specific method docs - ThinkingSphinx::Search and ThinkingSphinx::Index::Builder in particular.
+
+Keep in mind that while Thinking Sphinx works for ActiveRecord with Merb, it doesn't yet support DataMapper (although that is planned).
+
+== Contributing
+
+Fork on GitHub and after you've committed tested patches, send a pull request.
+
+To get the spec suite running, you will need to install the not-a-mock gem if you don't already have it:
+
+  git clone git://github.com/freelancing-god/not-a-mock.git
+  cd not-a-mock
+  rake gem
+  gem install pkg/not_a_mock-1.1.0.gem
+  
+Then install the ginger gem. The steps are the same, except that you might need to sudo the gem install:
+
+  git clone git://github.com/freelancing-god/ginger.git
+  cd ginger
+  rake gem
+  sudo gem install pkg/ginger-1.1.0.gem
+
+Then set up your database:
+
+  cp spec/fixtures/database.yml.default spec/fixtures/database.yml
+  mysqladmin -u root create thinking_sphinx
+  
+Make sure you don't have another Sphinx daemon (searchd) running. If you do, quit it with "rake ts:stop"
+in the app root.
+
+You should now have a passing test suite from which to build your patch on.
+
+  rake spec
+  
+If you get the message "Failed to start searchd daemon", run the spec with sudo:
+
+  sudo rake spec
+  
+If you quit the spec suite before it's completed, you may be left with data in the test
+database, causing the next run to have failures. Let that run complete and then try again.
+
+== Contributors
+
+Since I first released this library, there's been quite a few people who have submitted patches, to my immense gratitude. Others have suggested syntax changes and general improvements. So my thanks to the following people:
+
+- Joost Hietbrink
+- Jonathan Conway
+- Gregory Mirzayantz
+- Tung Nguyen
+- Sean Cribbs
+- Benoit Caccinolo
+- John Barton
+- Oliver Beddows
+- Arthur Zapparoli
+- Dusty Doris
+- Marcus Crafter
+- Patrick Lenz
+- Björn Andreasson
+- James Healy
+- Jae-Jun Hwang
+- Xavier Shay
+- Jason Rust
+- Gopal Patel
+- Chris Heald
+- Peter Vandenberk
+- Josh French
+- Andrew Bennett
+- Jordan Fowler
+- Seth Walker
+- Joe Noon
+- Wolfgang Postler
+- Rick Olson
+- Killian Murphy
+- Morten Primdahl
+- Ryan Bates
+- David Eisinger
+- Shay Arnett
+- Minh Tran
+- Jeremy Durham
+- Piotr Sarnacki
+- Matt Johnson
+- Nicolas Blanco
+- Max Lapshin
+- Josh Natanson
+- Philip Hallstrom
+- Christian Rishøj
+- Mike Flester
+- Jim Remsik
+- Kennon Ballou
+- Henrik Nyh
+- Emil Tin
+- Doug Cole
+- Ed Hickey
+- Evan Weaver
+- Thibaut Barrere
+- Kristopher Chambers
+- Dmitrij Smalko
+- Aleksey Yeschenko
+- Lachie Cox
+- Lourens Naude
+- Tom Davies
+- Dan Pickett
+- Alex Caudill

data/README.textile

@@ -0,0 +1,107 @@
+h1. Thinking Sphinx
+
+h2. Usage
+
+First, if you haven't done so already, check out the main "usage":http://ts.freelancing-gods.com/usage.html page. Once you've done that, the next place to look for information is the specific method docs - ThinkingSphinx::Search and ThinkingSphinx::Index::Builder in particular.
+
+Keep in mind that while Thinking Sphinx works for ActiveRecord with Merb, it doesn't yet support DataMapper (although that is planned).
+
+h2. Contributing
+
+Fork on GitHub and after you've committed tested patches, send a pull request.
+
+To get the spec suite running, you will need to install the not-a-mock gem if you don't already have it:
+
+  git clone git://github.com/freelancing-god/not-a-mock.git
+  cd not-a-mock
+  rake gem
+  gem install pkg/not_a_mock-1.1.0.gem
+  
+Then install the ginger gem. The steps are the same, except that you might need to sudo the gem install:
+
+  git clone git://github.com/freelancing-god/ginger.git
+  cd ginger
+  rake gem
+  sudo gem install pkg/ginger-1.1.0.gem
+
+Then set up your database:
+
+  cp spec/fixtures/database.yml.default spec/fixtures/database.yml
+  mysqladmin -u root create thinking_sphinx
+
+Make sure you don't have another Sphinx daemon (searchd) running. If you do, quit it with "rake ts:stop"
+in the app root.
+
+You should now have a passing test suite from which to build your patch on.
+
+  rake spec
+
+If you get the message "Failed to start searchd daemon", run the spec with sudo:
+
+  sudo rake spec
+
+If you quit the spec suite before it's completed, you may be left with data in the test
+database, causing the next run to have failures. Let that run complete and then try again.
+
+h2. Contributors
+
+Since I first released this library, there's been quite a few people who have submitted patches, to my immense gratitude. Others have suggested syntax changes and general improvements. So my thanks to the following people:
+
+* Joost Hietbrink
+* Jonathan Conway
+* Gregory Mirzayantz
+* Tung Nguyen
+* Sean Cribbs
+* Benoit Caccinolo
+* John Barton
+* Oliver Beddows
+* Arthur Zapparoli
+* Dusty Doris
+* Marcus Crafter
+* Patrick Lenz
+* Björn Andreasson
+* James Healy
+* Jae-Jun Hwang
+* Xavier Shay
+* Jason Rust
+* Gopal Patel
+* Chris Heald
+* Peter Vandenberk
+* Josh French
+* Andrew Bennett
+* Jordan Fowler
+* Seth Walker
+* Joe Noon
+* Wolfgang Postler
+* Rick Olson
+* Killian Murphy
+* Morten Primdahl
+* Ryan Bates
+* David Eisinger
+* Shay Arnett
+* Minh Tran
+* Jeremy Durham
+* Piotr Sarnacki
+* Matt Johnson
+* Nicolas Blanco
+* Max Lapshin
+* Josh Natanson
+* Philip Hallstrom
+* Christian Rishøj
+* Mike Flester
+* Jim Remsik
+* Kennon Ballou
+* Henrik Nyh
+* Emil Tin
+* Doug Cole
+* Ed Hickey
+* Evan Weaver
+* Thibaut Barrere
+* Kristopher Chambers
+* Dmitrij Smalko
+* Aleksey Yeschenko
+* Lachie Cox
+* Lourens Naude
+* Tom Davies
+* Dan Pickett
+* Alex Caudill

data/Rakefile

@@ -0,0 +1,4 @@
+require 'rubygems'
+
+require 'tasks/distribution'
+require 'tasks/testing'

data/contribute.rb

@@ -0,0 +1,328 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'yaml'
+require 'pp'
+
+module ContributeHelper; end
+
+class Contribute
+  include ContributeHelper
+  
+  def dependencies
+    [
+      Dependencies::Sphinx,
+      Dependencies::Mysql,
+      Dependencies::AR,
+      Dependencies::Ginger
+    ]
+  end
+
+  def show
+    show_welcome_screen
+    
+    (
+      check_for_dependencies   &&
+      create_database_yaml     &&
+      check_mysql_is_working   &&
+      create_test_database
+    ) || exit(1)
+    
+    show_done_screen
+  end
+
+private
+WELCOME_SCREEN = <<-EO_WELCOME
+<banner>Thinking Sphinx Contribution</banner>
+
+Thanks for contributing to Thinking Sphinx.
+
+In this script we'll help you get setup to hack:
+
+ <b>1.</b> We'll check that you have the right software installed and running.
+ <b>2.</b> We'll set up the test database for specs to run against.
+
+EO_WELCOME
+
+DONE_SCREEN = <<-EO_DONE
+<banner>Setup done!</banner>
+
+All done! Now you can start hacking by running
+
+  <b>rake spec</b>
+
+EO_DONE
+
+REVIEW_YAML = <<-EO_REVIEW_YAML
+
+Please review the database details in the yaml file details before continuing.
+
+This file is used by the specs to connect to the database.
+
+Current details:
+EO_REVIEW_YAML
+
+
+
+MYSQL_FAILED = <<-EO_MYSQL_FAILED
+
+Looks like we couldn't successfully talk to the mysql database.
+
+Don't worry though...
+
+EO_MYSQL_FAILED
+
+CREATE_DATABASE_FAILED = <<-EO_CREATE_DATABASE_FAILED
+
+Looks like we couldn't create a test database to work against.
+
+Don't worry though...
+
+EO_CREATE_DATABASE_FAILED
+
+  def show_welcome_screen
+    colour_puts WELCOME_SCREEN
+    wait!
+  end
+
+  def show_done_screen
+    colour_puts DONE_SCREEN
+  end
+
+  # create database.yml
+  def create_database_yaml
+    colour_puts "<banner>creating database yaml</banner>"
+    puts
+    
+    
+    config = {
+          'username' => 'root',
+          'password' => nil,
+          'host'     => 'localhost'
+        }
+    
+    
+    colour_print " * <b>#{db_yml}</b>... "
+    unless File.exist?(db_yml)
+      open(db_yml,'w') {|f| f << config.to_yaml}
+      colour_puts "<green>created</green>"
+    else
+      config = YAML.load_file(db_yml)
+      colour_puts "<green>already exists</green>"
+    end
+    
+    colour_puts REVIEW_YAML
+    
+    config.each do |(k,v)|
+      colour_puts " * <b>#{k}</b>: #{v}"
+    end
+    
+    puts
+    
+    wait!
+    true
+  end
+  
+  def check_mysql_is_working
+    require 'activerecord'
+    colour_puts "<banner>check mysql is working</banner>"
+    puts
+    
+    connect_to_db
+    
+    print " * connecting to mysql... "
+    
+    begin
+      ActiveRecord::Base.connection.select_value('select sysdate() from dual')
+      
+      colour_puts "<green>successful</green>"
+      puts
+      
+      return true
+    rescue Mysql::Error
+      colour_puts "<red>failed</red>"
+      
+      puts MYSQL_FAILED
+    end
+    
+    false
+  end
+
+  # create test db
+  def create_test_database
+    colour_puts "<banner>create test database</banner>"
+    puts
+    
+    connect_to_db
+    
+    colour_print " * <b>creating thinking_sphinx database</b>... "
+    begin
+      ActiveRecord::Base.connection.create_database('thinking_sphinx')
+      colour_puts "<green>successful</green>"
+    rescue ActiveRecord::StatementInvalid
+      if $!.message[/database exists/]
+        colour_puts "<green>successful</green> (database already existed)"
+        puts
+        return true
+      else
+        colour_puts "<red>failed</red>"
+      end
+    end
+    
+    colour_puts CREATE_DATABASE_FAILED
+    
+    false
+  end
+  
+  # project
+  def ts_root
+    File.expand_path(File.dirname(__FILE__))
+  end
+  
+  def specs
+    ts_root / 'spec'
+  end
+  
+  def db_yml
+    specs / 'fixtures' / 'database.yml'
+  end
+  
+  def connect_to_db
+    config = YAML.load_file(db_yml)
+    config.update(:adapter => 'mysql', :database => 'test')
+    config.symbolize_keys!
+
+    ActiveRecord::Base.establish_connection(config)
+  end
+end
+
+
+
+
+
+
+
+class String
+  def /(other)
+    "#{self}/#{other}"
+  end
+end
+
+module ContributeHelper
+  class Dependency
+    def self.name(name=nil)
+      if name then @name = name else @name end
+    end
+    
+    attr_reader :location
+    
+    def initialize
+      @found = false
+      @location = nil
+    end
+    
+    def name; self.class.name end
+    
+    def check; false end
+    def check!
+      @found = check 
+    end
+    
+    def found?
+      @found
+    end
+  end
+  
+  class Gem < Dependency
+    def gem_name; self.class.name end
+    def name; "#{super} gem" end
+    
+    def check
+      ::Gem.available? self.gem_name
+    end
+  end
+  
+  
+  def check_for_dependencies
+    colour_puts "<banner>Checking for required software</banner>"
+    puts
+    
+    all_found = true
+    
+    dependencies.each do |klass|
+      dep = klass.new
+      print " * #{dep.name}... "
+      dep.check!
+      
+      if dep.found?
+        if dep.location
+          colour_puts "<green>found at #{dep.location}</green>"
+        else
+          colour_puts "<green>found</green>"
+        end
+      else
+        all_found &= false
+        colour_puts "<red>not found</red>"
+      end
+    end
+    
+    puts
+    
+    all_found
+  end
+  
+  
+  
+  DEFAULT_TERMINAL_COLORS = "\e[0m\e[37m\e[40m"
+  def subs_colour(data)
+  	data = data.gsub(%r{<b>(.*?)</b>}m, "\e[1m\\1#{DEFAULT_TERMINAL_COLORS}")
+  	data.gsub!(%r{<red>(.*?)</red>}m, "\e[1m\e[31m\\1#{DEFAULT_TERMINAL_COLORS}")
+  	data.gsub!(%r{<green>(.*?)</green>}m, "\e[1m\e[32m\\1#{DEFAULT_TERMINAL_COLORS}")
+  	data.gsub!(%r{<yellow>(.*?)</yellow>}m, "\e[1m\e[33m\\1#{DEFAULT_TERMINAL_COLORS}")
+  	data.gsub!(%r{<banner>(.*?)</banner>}m, "\e[33m\e[44m\e[1m\\1#{DEFAULT_TERMINAL_COLORS}")
+  	
+  	return data
+  end
+  
+  def colour_puts(text)
+    puts subs_colour(text)
+  end
+
+  def colour_print(text)
+    print subs_colour(text)
+  end
+
+  
+  def wait!
+    colour_puts "<b>Hit Enter to continue, or Ctrl-C to quit.</b>"
+    STDIN.readline
+  rescue Interrupt
+    exit!
+  end
+end
+
+module Dependencies
+  class Mysql < ContributeHelper::Gem
+    name 'mysql'
+  end
+  
+  class AR < ContributeHelper::Gem
+    name 'activerecord'
+  end
+  
+  class Ginger < ContributeHelper::Gem
+    name 'ginger'
+  end
+  
+  class Sphinx < ContributeHelper::Dependency
+    name 'sphinx'
+    
+    def check
+      output = `which searchd`
+      @location = output.chomp if $? == 0
+      $? == 0
+    end
+  end
+end
+
+Contribute.new.show