jsierles-memcache-client 1.5.0.5
Sign up to get free protection for your applications and to get access to all the features.
- data/History.txt +98 -0
- data/LICENSE.txt +28 -0
- data/README.txt +54 -0
- data/Rakefile +22 -0
- data/lib/memcache.rb +833 -0
- data/lib/memcache_util.rb +90 -0
- data/test/test_mem_cache.rb +771 -0
- metadata +60 -0
data/History.txt
ADDED
@@ -0,0 +1,98 @@
|
|
1
|
+
= 1.5.0.5
|
2
|
+
|
3
|
+
* Remove native C CRC32_ITU_T extension in favor of Zlib's crc32 method.
|
4
|
+
memcache-client is now pure Ruby again and will work with JRuby and Rubinius.
|
5
|
+
|
6
|
+
= 1.5.0.4
|
7
|
+
|
8
|
+
* Get test suite working again (packagethief)
|
9
|
+
* Ruby 1.9 compatiblity fixes (packagethief, mperham)
|
10
|
+
* Consistently return server responses and check for errors (packagethief)
|
11
|
+
* Properly calculate CRC in Ruby 1.9 strings (mperham)
|
12
|
+
* Drop rspec in favor of test/unit, for 1.9 compat (mperham)
|
13
|
+
|
14
|
+
= 1.5.0.3 (FiveRuns fork)
|
15
|
+
|
16
|
+
* Integrated ITU-T CRC32 operation in native C extension for speed. Thanks to Justin Balthrop!
|
17
|
+
|
18
|
+
= 1.5.0.2 (FiveRuns fork)
|
19
|
+
|
20
|
+
* Add support for seamless failover between servers. If one server connection dies,
|
21
|
+
the client will retry the operation on another server before giving up.
|
22
|
+
|
23
|
+
* Merge Will Bryant's socket retry patch.
|
24
|
+
http://willbryant.net/software/2007/12/21/ruby-memcache-client-reconnect-and-retry
|
25
|
+
|
26
|
+
= 1.5.0.1 (FiveRuns fork)
|
27
|
+
|
28
|
+
* Fix set not handling client disconnects.
|
29
|
+
http://dev.twitter.com/2008/02/solving-case-of-missing-updates.html
|
30
|
+
|
31
|
+
= 1.5.0
|
32
|
+
|
33
|
+
* Add MemCache#flush_all command. Patch #13019 and bug #10503. Patches
|
34
|
+
submitted by Sebastian Delmont and Rick Olson.
|
35
|
+
* Type-cast data returned by MemCache#stats. Patch #10505 submitted by
|
36
|
+
Sebastian Delmont.
|
37
|
+
|
38
|
+
= 1.4.0
|
39
|
+
|
40
|
+
* Fix bug #10371, #set does not check response for server errors.
|
41
|
+
Submitted by Ben VandenBos.
|
42
|
+
* Fix bug #12450, set TCP_NODELAY socket option. Patch by Chris
|
43
|
+
McGrath.
|
44
|
+
* Fix bug #10704, missing #add method. Patch by Jamie Macey.
|
45
|
+
* Fix bug #10371, handle socket EOF in cache_get. Submitted by Ben
|
46
|
+
VandenBos.
|
47
|
+
|
48
|
+
= 1.3.0
|
49
|
+
|
50
|
+
* Apply patch #6507, add stats command. Submitted by Tyler Kovacs.
|
51
|
+
* Apply patch #6509, parallel implementation of #get_multi. Submitted
|
52
|
+
by Tyler Kovacs.
|
53
|
+
* Validate keys. Disallow spaces in keys or keys that are too long.
|
54
|
+
* Perform more validation of server responses. MemCache now reports
|
55
|
+
errors if the socket was not in an expected state. (Please file
|
56
|
+
bugs if you find some.)
|
57
|
+
* Add #incr and #decr.
|
58
|
+
* Add raw argument to #set and #get to retrieve #incr and #decr
|
59
|
+
values.
|
60
|
+
* Also put on MemCacheError when using Cache::get with block.
|
61
|
+
* memcache.rb no longer sets $TESTING to a true value if it was
|
62
|
+
previously defined. Bug #8213 by Matijs van Zuijlen.
|
63
|
+
|
64
|
+
= 1.2.1
|
65
|
+
|
66
|
+
* Fix bug #7048, MemCache#servers= referenced changed local variable.
|
67
|
+
Submitted by Justin Dossey.
|
68
|
+
* Fix bug #7049, MemCache#initialize resets @buckets. Submitted by
|
69
|
+
Justin Dossey.
|
70
|
+
* Fix bug #6232, Make Cache::Get work with a block only when nil is
|
71
|
+
returned. Submitted by Jon Evans.
|
72
|
+
* Moved to the seattlerb project.
|
73
|
+
|
74
|
+
= 1.2.0
|
75
|
+
|
76
|
+
NOTE: This version will store keys in different places than previous
|
77
|
+
versions! Be prepared for some thrashing while memcached sorts itself
|
78
|
+
out!
|
79
|
+
|
80
|
+
* Fixed multithreaded operations, bug 5994 and 5989.
|
81
|
+
Thanks to Blaine Cook, Erik Hetzner, Elliot Smith, Dave Myron (and
|
82
|
+
possibly others I have forgotten).
|
83
|
+
* Made memcached interoperable with other memcached libraries, bug
|
84
|
+
4509. Thanks to anonymous.
|
85
|
+
* Added get_multi to match Perl/etc APIs
|
86
|
+
|
87
|
+
= 1.1.0
|
88
|
+
|
89
|
+
* Added some tests
|
90
|
+
* Sped up non-multithreaded and multithreaded operation
|
91
|
+
* More Ruby-memcache compatibility
|
92
|
+
* More RDoc
|
93
|
+
* Switched to Hoe
|
94
|
+
|
95
|
+
= 1.0.0
|
96
|
+
|
97
|
+
Birthday!
|
98
|
+
|
data/LICENSE.txt
ADDED
@@ -0,0 +1,28 @@
|
|
1
|
+
All original code copyright 2005, 2006, 2007 Bob Cottrell, Eric Hodel,
|
2
|
+
The Robot Co-op. All rights reserved.
|
3
|
+
|
4
|
+
Redistribution and use in source and binary forms, with or without
|
5
|
+
modification, are permitted provided that the following conditions
|
6
|
+
are met:
|
7
|
+
|
8
|
+
1. Redistributions of source code must retain the above copyright
|
9
|
+
notice, this list of conditions and the following disclaimer.
|
10
|
+
2. Redistributions in binary form must reproduce the above copyright
|
11
|
+
notice, this list of conditions and the following disclaimer in the
|
12
|
+
documentation and/or other materials provided with the distribution.
|
13
|
+
3. Neither the names of the authors nor the names of their contributors
|
14
|
+
may be used to endorse or promote products derived from this software
|
15
|
+
without specific prior written permission.
|
16
|
+
|
17
|
+
THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
|
18
|
+
OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
19
|
+
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
20
|
+
ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE
|
21
|
+
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
|
22
|
+
OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
|
23
|
+
OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
|
24
|
+
BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
25
|
+
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
|
26
|
+
OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
|
27
|
+
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
28
|
+
|
data/README.txt
ADDED
@@ -0,0 +1,54 @@
|
|
1
|
+
= memcache-client
|
2
|
+
|
3
|
+
This is the FiveRuns fork of seattle.rb's memcache-client 1.5.0. We've fixed several bugs
|
4
|
+
which are in that version.
|
5
|
+
|
6
|
+
Rubyforge Project:
|
7
|
+
|
8
|
+
http://rubyforge.org/projects/seattlerb
|
9
|
+
|
10
|
+
Documentation:
|
11
|
+
|
12
|
+
http://seattlerb.org/memcache-client
|
13
|
+
|
14
|
+
== Installing memcache-client
|
15
|
+
|
16
|
+
Just install the gem:
|
17
|
+
|
18
|
+
$ sudo gem install fiveruns-memcache-client --source http://gems.github.com
|
19
|
+
|
20
|
+
== Using memcache-client
|
21
|
+
|
22
|
+
With one server:
|
23
|
+
|
24
|
+
CACHE = MemCache.new 'localhost:11211', :namespace => 'my_namespace'
|
25
|
+
|
26
|
+
Or with multiple servers:
|
27
|
+
|
28
|
+
CACHE = MemCache.new %w[one.example.com:11211 two.example.com:11211],
|
29
|
+
:namespace => 'my_namespace'
|
30
|
+
|
31
|
+
See MemCache.new for details.
|
32
|
+
|
33
|
+
=== Using memcache-client with Rails
|
34
|
+
|
35
|
+
Rails will automatically load the memcache-client gem, but you may
|
36
|
+
need to uninstall Ruby-memcache, I don't know which one will get
|
37
|
+
picked by default.
|
38
|
+
|
39
|
+
Add your environment-specific caches to config/environment/*. If you run both
|
40
|
+
development and production on the same memcached server sets, be sure
|
41
|
+
to use different namespaces. Be careful when running tests using
|
42
|
+
memcache, you may get strange results. It will be less of a headache
|
43
|
+
to simply use a readonly memcache when testing.
|
44
|
+
|
45
|
+
memcache-client also comes with a wrapper called Cache in memcache_util.rb for
|
46
|
+
use with Rails. To use it be sure to assign your memcache connection to
|
47
|
+
CACHE. Cache returns nil on all memcache errors so you don't have to rescue
|
48
|
+
the errors yourself. It has #get, #put and #delete module functions.
|
49
|
+
|
50
|
+
=== Improving Performance ===
|
51
|
+
|
52
|
+
Performing the CRC-32 ITU-T step to determine which server to use for a given key
|
53
|
+
is VERY slow in Ruby. RubyGems should compile a native library for performing this
|
54
|
+
operation when the gem is installed.
|
data/Rakefile
ADDED
@@ -0,0 +1,22 @@
|
|
1
|
+
# vim: syntax=Ruby
|
2
|
+
require 'rubygems'
|
3
|
+
require 'rake/rdoctask'
|
4
|
+
require 'rake/testtask'
|
5
|
+
|
6
|
+
task :gem do
|
7
|
+
sh "gem build memcache-client.gemspec"
|
8
|
+
end
|
9
|
+
|
10
|
+
task :install => [:gem] do
|
11
|
+
sh "sudo gem install memcache-client-*.gem"
|
12
|
+
end
|
13
|
+
|
14
|
+
Rake::RDocTask.new do |rd|
|
15
|
+
rd.main = "README.rdoc"
|
16
|
+
rd.rdoc_files.include("README.rdoc", "lib/**/*.rb")
|
17
|
+
rd.rdoc_dir = 'doc'
|
18
|
+
end
|
19
|
+
|
20
|
+
Rake::TestTask.new
|
21
|
+
|
22
|
+
task :default => :test
|