websolr-acts_as_solr 0.0.2 → 0.1.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -0,0 +1,69 @@
1
+ == About
2
+
3
+ This is the gem to install for the supported version of acts_as_solr on websolr.
4
+
5
+ == Installation
6
+
7
+ cd your_rails_app
8
+ sudo gem install websolr-acts_as_solr
9
+ config.gem "websolr-acts_as_solr" # into config.environment.rb
10
+ echo websolr-acts_as_solr >> .gems # if using Heroku
11
+ acts_as_solr install # Installs config/solr.yml
12
+ echo "require 'aas_tasks'" >> Rakefile # Installs local development tasks
13
+
14
+ == Usage
15
+
16
+ === Starting a local development server
17
+
18
+ To start up a Solr instance for development, issue the following:
19
+
20
+ rake solr:start
21
+
22
+ === Using in production
23
+
24
+ You need to make sure that the WEBSOLR_URL environment variable is set correctly.
25
+
26
+ If you're using Heroku, this should happen automatically. You can verify by running <code>heroku config</code>.
27
+
28
+ If you're running in your own environment, set the environment variable as you normally would on a *nix system.
29
+
30
+ If you have to set the variable in Ruby, you should be able to put the following in an Rails initializer:
31
+
32
+ if RAILS_ENV == "production"
33
+ ENV["WEBSOLR_URL"] = "http://index.websolr.com/solr/[your-api-key]"
34
+ load "websolr-acts_as_solr.rb"
35
+ end
36
+
37
+ == Requirements
38
+
39
+ * Java Runtime Environment(JRE) 1.5 aka 5.0 [http://www.java.com/en/download/index.jsp](http://www.java.com/en/download/index.jsp)
40
+ * If you have libxml-ruby installed, make sure it's at least version 0.7
41
+
42
+ == Basic Usage
43
+
44
+ # Just include the line below to any of your ActiveRecord models:
45
+ acts_as_solr
46
+
47
+ # Or if you want, you can specify only the fields that should be indexed:
48
+ acts_as_solr :fields => [:name, :author]
49
+
50
+ # Then to find instances of your model, just do:
51
+ Model.find_by_solr(query) #query is a string representing your query
52
+
53
+ # Please see ActsAsSolr::ActsMethods for a complete info
54
+
55
+ == acts_as_solr in your tests
56
+
57
+ To test code that uses acts_as_solr you must start a Solr server for the test environment. You can do that with
58
+
59
+ rake solr:start RAILS_ENV=test
60
+
61
+ However, if you would like to mock out Solr calls so that a Solr server is not needed (and your tests will run much faster), just add this to your `test_helper.rb` or similar:
62
+
63
+ class ActsAsSolr::Post
64
+ def self.execute(request)
65
+ true
66
+ end
67
+ end
68
+
69
+ (via[http://www.subelsky.com/2007/10/actsassolr-capistranhttpwwwbloggercomim.html#c1646308013209805416])
data/Rakefile CHANGED
@@ -10,7 +10,7 @@ begin
10
10
  gem.email = "kyle@kylemaxwell.com"
11
11
  gem.homepage = "http://github.com/fizx/websolr-acts_as_solr"
12
12
  gem.authors = ["Kyle Maxwell"]
13
- gem.add_dependency "acts_as_solr", "1.1.1"
13
+ gem.add_dependency "acts_as_solr", "1.2.0"
14
14
  gem.add_dependency "rest-client"
15
15
  gem.add_dependency "json"
16
16
  gem.add_development_dependency "rspec", ">= 0"
data/VERSION CHANGED
@@ -1 +1 @@
1
- 0.0.2
1
+ 0.1.0
@@ -1,7 +1,7 @@
1
1
  # Post-require hooks for acts_as_solr and sunspot if this
2
2
  # gem is loaded and WEBSOLR_URL is defined.
3
3
 
4
- gem "acts_as_solr", :version => "1.1.1"
4
+ gem "acts_as_solr", :version => "1.1.3"
5
5
  require "acts_as_solr"
6
6
 
7
7
  if ENV["WEBSOLR_URL"]
@@ -5,7 +5,7 @@
5
5
 
6
6
  Gem::Specification.new do |s|
7
7
  s.name = %q{websolr-acts_as_solr}
8
- s.version = "0.0.2"
8
+ s.version = "0.1.0"
9
9
 
10
10
  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
11
11
  s.authors = ["Kyle Maxwell"]
@@ -14,13 +14,13 @@ Gem::Specification.new do |s|
14
14
  s.email = %q{kyle@kylemaxwell.com}
15
15
  s.extra_rdoc_files = [
16
16
  "LICENSE",
17
- "README"
17
+ "README.rdoc"
18
18
  ]
19
19
  s.files = [
20
20
  ".document",
21
21
  ".gitignore",
22
22
  "LICENSE",
23
- "README",
23
+ "README.rdoc",
24
24
  "Rakefile",
25
25
  "VERSION",
26
26
  "lib/websolr-acts_as_solr.rb",
@@ -43,18 +43,18 @@ Gem::Specification.new do |s|
43
43
  s.specification_version = 3
44
44
 
45
45
  if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
46
- s.add_runtime_dependency(%q<acts_as_solr>, ["= 1.1.1"])
46
+ s.add_runtime_dependency(%q<acts_as_solr>, ["= 1.2.0"])
47
47
  s.add_runtime_dependency(%q<rest-client>, [">= 0"])
48
48
  s.add_runtime_dependency(%q<json>, [">= 0"])
49
49
  s.add_development_dependency(%q<rspec>, [">= 0"])
50
50
  else
51
- s.add_dependency(%q<acts_as_solr>, ["= 1.1.1"])
51
+ s.add_dependency(%q<acts_as_solr>, ["= 1.2.0"])
52
52
  s.add_dependency(%q<rest-client>, [">= 0"])
53
53
  s.add_dependency(%q<json>, [">= 0"])
54
54
  s.add_dependency(%q<rspec>, [">= 0"])
55
55
  end
56
56
  else
57
- s.add_dependency(%q<acts_as_solr>, ["= 1.1.1"])
57
+ s.add_dependency(%q<acts_as_solr>, ["= 1.2.0"])
58
58
  s.add_dependency(%q<rest-client>, [">= 0"])
59
59
  s.add_dependency(%q<json>, [">= 0"])
60
60
  s.add_dependency(%q<rspec>, [">= 0"])
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: websolr-acts_as_solr
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.0.2
4
+ version: 0.1.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Kyle Maxwell
@@ -20,7 +20,7 @@ dependencies:
20
20
  requirements:
21
21
  - - "="
22
22
  - !ruby/object:Gem::Version
23
- version: 1.1.1
23
+ version: 1.2.0
24
24
  version:
25
25
  - !ruby/object:Gem::Dependency
26
26
  name: rest-client
@@ -60,12 +60,12 @@ extensions: []
60
60
 
61
61
  extra_rdoc_files:
62
62
  - LICENSE
63
- - README
63
+ - README.rdoc
64
64
  files:
65
65
  - .document
66
66
  - .gitignore
67
67
  - LICENSE
68
- - README
68
+ - README.rdoc
69
69
  - Rakefile
70
70
  - VERSION
71
71
  - lib/websolr-acts_as_solr.rb
data/README DELETED
@@ -1,17 +0,0 @@
1
- Changes:
2
- - Split the acts_as_solr, and websolr_rails versions of the gem. This is acts_as_solr-only.
3
- - Lockdown the specific supported versions of acts_as_solr
4
- - Web service call on boot to enforce the correct schema.xml.
5
-
6
- Using the experimental websolr acts_as_solr client:
7
-
8
- sudo gem install websolr-acts_as_solr
9
- echo websolr-acts_as_solr >> .gems
10
- config.gem "websolr-acts_as_solr" # into config/environment.rb
11
-
12
- Edit config/solr.yml =>
13
-
14
- development:
15
- url: http://127.0.0.1:8982/solr
16
-
17
- Use acts_as_solr as usual.