jsierles-memcache-client 1.5.0.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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
|