dalli_memcached 1.8.0

data/Manifest

@@ -0,0 +1,209 @@
+BENCHMARKS
+CHANGELOG
+Gemfile
+Gemfile.lock
+LICENSE
+Manifest
+README.rdoc
+Rakefile
+TODO
+ext/extconf-make.rb
+ext/extconf.rb
+ext/libmemcached-0.32/AUTHORS
+ext/libmemcached-0.32/COPYING
+ext/libmemcached-0.32/ChangeLog
+ext/libmemcached-0.32/INSTALL
+ext/libmemcached-0.32/Makefile.am
+ext/libmemcached-0.32/Makefile.in
+ext/libmemcached-0.32/NEWS
+ext/libmemcached-0.32/README
+ext/libmemcached-0.32/THANKS
+ext/libmemcached-0.32/TODO
+ext/libmemcached-0.32/aclocal.m4
+ext/libmemcached-0.32/clients/Makefile.am
+ext/libmemcached-0.32/clients/Makefile.in
+ext/libmemcached-0.32/clients/client_options.h
+ext/libmemcached-0.32/clients/execute.c
+ext/libmemcached-0.32/clients/execute.h
+ext/libmemcached-0.32/clients/generator.c
+ext/libmemcached-0.32/clients/generator.h
+ext/libmemcached-0.32/clients/memcat.c
+ext/libmemcached-0.32/clients/memcp.c
+ext/libmemcached-0.32/clients/memdump.c
+ext/libmemcached-0.32/clients/memerror.c
+ext/libmemcached-0.32/clients/memflush.c
+ext/libmemcached-0.32/clients/memrm.c
+ext/libmemcached-0.32/clients/memslap.c
+ext/libmemcached-0.32/clients/memstat.c
+ext/libmemcached-0.32/clients/utilities.c
+ext/libmemcached-0.32/clients/utilities.h
+ext/libmemcached-0.32/config.h.in
+ext/libmemcached-0.32/config/compile
+ext/libmemcached-0.32/config/config.guess
+ext/libmemcached-0.32/config/config.rpath
+ext/libmemcached-0.32/config/config.sub
+ext/libmemcached-0.32/config/depcomp
+ext/libmemcached-0.32/config/install-sh
+ext/libmemcached-0.32/config/ltmain.sh
+ext/libmemcached-0.32/config/missing
+ext/libmemcached-0.32/configure
+ext/libmemcached-0.32/configure.ac
+ext/libmemcached-0.32/libmemcached/Makefile.am
+ext/libmemcached-0.32/libmemcached/Makefile.in
+ext/libmemcached-0.32/libmemcached/byteorder.c
+ext/libmemcached-0.32/libmemcached/common.h
+ext/libmemcached-0.32/libmemcached/crc.c
+ext/libmemcached-0.32/libmemcached/hsieh_hash.c
+ext/libmemcached-0.32/libmemcached/jenkins_hash.c
+ext/libmemcached-0.32/libmemcached/libmemcached.ver
+ext/libmemcached-0.32/libmemcached/libmemcached_probes.d
+ext/libmemcached-0.32/libmemcached/libmemcached_probes.h
+ext/libmemcached-0.32/libmemcached/md5.c
+ext/libmemcached-0.32/libmemcached/memcached.c
+ext/libmemcached-0.32/libmemcached/memcached.h
+ext/libmemcached-0.32/libmemcached/memcached.hpp
+ext/libmemcached-0.32/libmemcached/memcached/README.txt
+ext/libmemcached-0.32/libmemcached/memcached/protocol_binary.h
+ext/libmemcached-0.32/libmemcached/memcached_allocators.c
+ext/libmemcached-0.32/libmemcached/memcached_analyze.c
+ext/libmemcached-0.32/libmemcached/memcached_auto.c
+ext/libmemcached-0.32/libmemcached/memcached_behavior.c
+ext/libmemcached-0.32/libmemcached/memcached_callback.c
+ext/libmemcached-0.32/libmemcached/memcached_configure.h.in
+ext/libmemcached-0.32/libmemcached/memcached_connect.c
+ext/libmemcached-0.32/libmemcached/memcached_constants.h
+ext/libmemcached-0.32/libmemcached/memcached_delete.c
+ext/libmemcached-0.32/libmemcached/memcached_do.c
+ext/libmemcached-0.32/libmemcached/memcached_dump.c
+ext/libmemcached-0.32/libmemcached/memcached_exist.c
+ext/libmemcached-0.32/libmemcached/memcached_exist.h
+ext/libmemcached-0.32/libmemcached/memcached_fetch.c
+ext/libmemcached-0.32/libmemcached/memcached_flush.c
+ext/libmemcached-0.32/libmemcached/memcached_flush_buffers.c
+ext/libmemcached-0.32/libmemcached/memcached_get.c
+ext/libmemcached-0.32/libmemcached/memcached_get.h
+ext/libmemcached-0.32/libmemcached/memcached_hash.c
+ext/libmemcached-0.32/libmemcached/memcached_hosts.c
+ext/libmemcached-0.32/libmemcached/memcached_internal.h
+ext/libmemcached-0.32/libmemcached/memcached_io.c
+ext/libmemcached-0.32/libmemcached/memcached_io.h
+ext/libmemcached-0.32/libmemcached/memcached_key.c
+ext/libmemcached-0.32/libmemcached/memcached_parse.c
+ext/libmemcached-0.32/libmemcached/memcached_pool.h
+ext/libmemcached-0.32/libmemcached/memcached_purge.c
+ext/libmemcached-0.32/libmemcached/memcached_quit.c
+ext/libmemcached-0.32/libmemcached/memcached_response.c
+ext/libmemcached-0.32/libmemcached/memcached_result.c
+ext/libmemcached-0.32/libmemcached/memcached_result.h
+ext/libmemcached-0.32/libmemcached/memcached_sasl.c
+ext/libmemcached-0.32/libmemcached/memcached_sasl.h
+ext/libmemcached-0.32/libmemcached/memcached_server.c
+ext/libmemcached-0.32/libmemcached/memcached_server.h
+ext/libmemcached-0.32/libmemcached/memcached_stats.c
+ext/libmemcached-0.32/libmemcached/memcached_storage.c
+ext/libmemcached-0.32/libmemcached/memcached_storage.h
+ext/libmemcached-0.32/libmemcached/memcached_strerror.c
+ext/libmemcached-0.32/libmemcached/memcached_string.c
+ext/libmemcached-0.32/libmemcached/memcached_string.h
+ext/libmemcached-0.32/libmemcached/memcached_touch.c
+ext/libmemcached-0.32/libmemcached/memcached_touch.h
+ext/libmemcached-0.32/libmemcached/memcached_types.h
+ext/libmemcached-0.32/libmemcached/memcached_util.h
+ext/libmemcached-0.32/libmemcached/memcached_verbosity.c
+ext/libmemcached-0.32/libmemcached/memcached_version.c
+ext/libmemcached-0.32/libmemcached/memcached_watchpoint.h
+ext/libmemcached-0.32/libmemcached/murmur_hash.c
+ext/libmemcached-0.32/libmemcached/visibility.h
+ext/libmemcached-0.32/libmemcachedutil/Makefile.am
+ext/libmemcached-0.32/libmemcachedutil/Makefile.in
+ext/libmemcached-0.32/libmemcachedutil/libmemcachedutil.ver
+ext/libmemcached-0.32/libmemcachedutil/memcached_pool.c
+ext/libmemcached-0.32/m4/ac_cxx_compile_stdcxx_0x.m4
+ext/libmemcached-0.32/m4/ac_cxx_header_stdcxx_98.m4
+ext/libmemcached-0.32/m4/acx_pthread.m4
+ext/libmemcached-0.32/m4/byteorder.m4
+ext/libmemcached-0.32/m4/deprecated.m4
+ext/libmemcached-0.32/m4/enable_utillib.m4
+ext/libmemcached-0.32/m4/extensions.m4
+ext/libmemcached-0.32/m4/hsieh.m4
+ext/libmemcached-0.32/m4/lib-prefix.m4
+ext/libmemcached-0.32/m4/libtool.m4
+ext/libmemcached-0.32/m4/ltoptions.m4
+ext/libmemcached-0.32/m4/ltsugar.m4
+ext/libmemcached-0.32/m4/ltversion.m4
+ext/libmemcached-0.32/m4/lt~obsolete.m4
+ext/libmemcached-0.32/m4/memcached.m4
+ext/libmemcached-0.32/m4/pandora_64bit.m4
+ext/libmemcached-0.32/m4/pandora_canonical.m4
+ext/libmemcached-0.32/m4/pandora_check_compiler_version.m4
+ext/libmemcached-0.32/m4/pandora_check_cxx_standard.m4
+ext/libmemcached-0.32/m4/pandora_enable_dtrace.m4
+ext/libmemcached-0.32/m4/pandora_ensure_gcc_version.m4
+ext/libmemcached-0.32/m4/pandora_have_better_malloc.m4
+ext/libmemcached-0.32/m4/pandora_have_sasl.m4
+ext/libmemcached-0.32/m4/pandora_header_assert.m4
+ext/libmemcached-0.32/m4/pandora_libtool.m4
+ext/libmemcached-0.32/m4/pandora_optimize.m4
+ext/libmemcached-0.32/m4/pandora_shared_ptr.m4
+ext/libmemcached-0.32/m4/pandora_vc_build.m4
+ext/libmemcached-0.32/m4/pandora_warnings.m4
+ext/libmemcached-0.32/m4/pod2man.m4
+ext/libmemcached-0.32/m4/protocol_binary.m4
+ext/libmemcached-0.32/m4/setsockopt.m4
+ext/libmemcached-0.32/m4/visibility.m4
+ext/libmemcached-0.32/support/Makefile.am
+ext/libmemcached-0.32/support/Makefile.in
+ext/libmemcached-0.32/support/libmemcached-fc.spec.in
+ext/libmemcached-0.32/support/libmemcached.pc.in
+ext/libmemcached-0.32/support/libmemcached.spec
+ext/libmemcached-0.32/support/libmemcached.spec.in
+ext/libmemcached-0.32/support/set_benchmark.sh
+ext/libmemcached-0.32/tests/Makefile.am
+ext/libmemcached-0.32/tests/Makefile.in
+ext/libmemcached-0.32/tests/atomsmasher.c
+ext/libmemcached-0.32/tests/function.c
+ext/libmemcached-0.32/tests/ketama_test_cases.h
+ext/libmemcached-0.32/tests/output.cmp
+ext/libmemcached-0.32/tests/output.res
+ext/libmemcached-0.32/tests/output2.res
+ext/libmemcached-0.32/tests/plus.cpp
+ext/libmemcached-0.32/tests/r/memcat.res
+ext/libmemcached-0.32/tests/r/memcp.res
+ext/libmemcached-0.32/tests/r/memrm.res
+ext/libmemcached-0.32/tests/r/memslap.res
+ext/libmemcached-0.32/tests/r/memstat.res
+ext/libmemcached-0.32/tests/server.c
+ext/libmemcached-0.32/tests/server.h
+ext/libmemcached-0.32/tests/start.c
+ext/libmemcached-0.32/tests/t/memcat.test
+ext/libmemcached-0.32/tests/t/memcp.test
+ext/libmemcached-0.32/tests/t/memrm.test
+ext/libmemcached-0.32/tests/t/memslap.test
+ext/libmemcached-0.32/tests/t/memstat.test
+ext/libmemcached-0.32/tests/test.c
+ext/libmemcached-0.32/tests/test.h
+ext/libmemcached-0.32/tests/udp.c
+ext/rlibmemcached.i
+ext/rlibmemcached_wrap.c
+lib/memcached.rb
+lib/memcached/auth.rb
+lib/memcached/behaviors.rb
+lib/memcached/exceptions.rb
+lib/memcached/experimental.rb
+lib/memcached/marshal_codec.rb
+lib/memcached/memcached.rb
+lib/memcached/rails.rb
+memcached.gemspec
+memcached.pem
+test/profile/benchmark.rb
+test/profile/c_profiler.rb
+test/profile/exercise.rb
+test/profile/rb_profiler.rb
+test/profile/valgrind.rb
+test/setup.rb
+test/teardown.rb
+test/test_helper.rb
+test/unit/binding_test.rb
+test/unit/memcached_experimental_test.rb
+test/unit/memcached_test.rb
+test/unit/rails_test.rb

data/README.rdoc

@@ -0,0 +1,124 @@
+= memcached
+
+An interface to the libmemcached C client.
+
+{<img src="https://travis-ci.org/evan/memcached.svg?branch=master" alt="Build Status" />}[https://travis-ci.org/evan/memcached]
+
+== License
+
+Copyright 2009-2013 Cloudburst, LLC. Licensed under the AFL 3. See the included LICENSE file. Portions copyright 2007-2009 TangentOrg, Brian Aker, licensed under the BSD license, and used with permission.
+
+== Features
+
+* clean API
+* robust access to all memcached features
+* SASL support for the binary protocol
+* multiple hashing modes, including consistent hashing
+* ludicrous speed, including optional pipelined IO with no_reply
+
+The <b>memcached</b> library wraps the pure-C libmemcached client via SWIG.
+
+== Installation
+
+You need Ruby 1.8.7 or Ruby 1.9.2. Other versions may work, but are not guaranteed. You also need the `libsasl2-dev` and `gettext` libraries, which should be provided through your system's package manager.
+
+Install the gem:
+  sudo gem install memcached --no-rdoc --no-ri
+
+== Usage
+
+Start a local networked memcached server:
+  $ memcached -p 11211 &
+
+Now, in Ruby, require the library and instantiate a Memcached object at a global level:
+
+  require 'memcached'
+  $cache = Memcached.new("localhost:11211")
+
+Now you can set things and get things:
+
+  value = 'hello'
+  $cache.set 'test', value
+  $cache.get 'test' #=> "hello"
+
+You can set with an expiration timeout:
+
+  value = 'hello'
+  $cache.set 'test', value, 1
+  sleep(2)
+  $cache.get 'test' #=> raises Memcached::NotFound
+
+You can get multiple values at once:
+
+  value = 'hello'
+  $cache.set 'test', value
+  $cache.set 'test2', value
+  $cache.get ['test', 'test2', 'missing']
+    #=> {"test" => "hello", "test2" => "hello"}
+
+You can set a counter and increment it. Note that you must initialize it with an integer, encoded as an unmarshalled ASCII string:
+
+  start = 1
+  $cache.set 'counter', start.to_s, 0, false
+  $cache.increment 'counter' #=> 2
+  $cache.increment 'counter' #=> 3
+  $cache.get('counter', false).to_i #=> 3
+
+You can get some server stats:
+
+  $cache.stats #=> {..., :bytes_written=>[62], :version=>["1.2.4"] ...}
+
+Note that the API is not the same as that of <b>Ruby-MemCache</b> or <b>memcache-client</b>. In particular, <tt>nil</tt> is a valid record value. Memcached#get does not return <tt>nil</tt> on failure, rather it raises <b>Memcached::NotFound</b>. This is consistent with the behavior of memcached itself. For example:
+
+  $cache.set 'test', nil
+  $cache.get 'test' #=> nil
+  $cache.delete 'test'
+  $cache.get 'test' #=> raises Memcached::NotFound
+
+== Rails 3 and 4
+
+Use {memcached_store gem}[https://github.com/Shopify/memcached_store] to integrate ActiveSupport cache store and memcached gem
+
+== Pipelining
+
+Pipelining updates is extremely effective in <b>memcached</b>, leading to more than 25x write throughput than the default settings. Use the following options to enable it:
+
+  :no_block => true,
+  :buffer_requests => true,
+  :noreply => true,
+  :binary_protocol => false
+
+Currently #append, #prepend, #set, and #delete are pipelined. Note that when you perform a read, all pending writes are flushed to the servers.
+
+== Threading
+
+<b>memcached</b> is threadsafe, but each thread requires its own Memcached instance. Create a global Memcached, and then call Memcached#clone each time you spawn a thread.
+
+  thread = Thread.new do
+    cache = $cache.clone
+    # Perform operations on cache, not $cache
+    cache.set 'example', 1
+    cache.get 'example'
+  end
+
+  # Join the thread so that exceptions don't get lost
+  thread.join
+
+== Legacy applications
+
+There is a compatibility wrapper for legacy applications called Memcached::Rails.
+
+== Benchmarks
+
+<b>memcached</b>, correctly configured, is at least twice as fast as <b>memcache-client</b> and <b>dalli</b>. See link:BENCHMARKS for details.
+
+== Reporting problems
+
+The support forum is here[http://github.com/evan/memcached/issues].
+
+Patches and contributions are very welcome. Please note that contributors are required to assign copyright for their additions to Cloudburst, LLC.
+
+== Further resources
+
+* {Memcached wiki}[https://code.google.com/p/memcached/wiki/NewStart]
+* {Libmemcached homepage}[libmemcached.org]

data/Rakefile

@@ -0,0 +1,134 @@
+require 'echoe'
+
+ENV["GEM_CERTIFICATE_CHAIN"]="memcached.pem"
+
+Echoe.new("memcached") do |p|
+  p.author = "Evan Weaver"
+  p.project = "evan"
+  p.summary = "An interface to the libmemcached C client."
+  p.licenses = "Academic Free License 3.0 (AFL-3.0)"
+  p.rdoc_pattern = /README|TODO|LICENSE|CHANGELOG|BENCH|COMPAT|exceptions|experimental.rb|behaviors|rails.rb|memcached.rb/
+  p.rdoc_options = %w[--line-numbers --inline-source --title Memcached --main README.rdoc --exclude=ext/bin --exclude=ext/libmemcached-.*/(clients|tests)]
+  p.retain_gemspec = true
+  p.development_dependencies = ["rake", "mocha", "echoe", "activesupport"]
+  p.clean_pattern += ["ext/Makefile",
+                      "ext/bin",
+                      "ext/include",
+                      "ext/lib",
+                      "ext/share",
+                      "ext/**/Makefile",
+                      "ext/Makefile.in",
+                      "ext/libmemcached-*/autom4te.cache",
+                      "ext/libmemcached-*/clients/memcat",
+                      "ext/libmemcached-*/clients/memcp",
+                      "ext/libmemcached-*/clients/memdump",
+                      "ext/libmemcached-*/clients/memerror",
+                      "ext/libmemcached-*/clients/memflush",
+                      "ext/libmemcached-*/clients/memrm",
+                      "ext/libmemcached-*/clients/memslap",
+                      "ext/libmemcached-*/clients/memstat",
+                      "ext/libmemcached-*/tests/atomsmasher",
+                      "ext/libmemcached-*/tests/startservers",
+                      "ext/libmemcached-*/tests/testapp",
+                      "ext/libmemcached-*/tests/testplus",
+                      "ext/libmemcached-*/tests/udptest",
+                      "ext/libmemcached-*/config.h",
+                      "ext/libmemcached-*/config.log",
+                      "ext/libmemcached-*/config.status",
+                      "ext/libmemcached-*/docs/*.[1,3]",
+                      "ext/libmemcached-*/libmemcached/memcached_configure.h",
+                      "ext/libmemcached-*/libtool",
+                      "ext/libmemcached-*/stamp*",
+                      "ext/libmemcached-*/support/libmemcached.pc",
+                      "ext/libmemcached-*/support/libmemcached-fc.spec",
+                      "ext/libmemcached-*/**/*.s[oa]",
+                      "ext/libmemcached-*/**/*.l[oa]",
+                      "ext/conftest.dSYM",
+                      "lib/rlibmemcached*",
+                      "**/*.rbc"]
+end
+
+task :swig do
+  run("swig -DLIBMEMCACHED_WITH_SASL_SUPPORT -Iext/libmemcached-0.32 -ruby -autorename -o ext/rlibmemcached_wrap.c.in ext/rlibmemcached.i", "Running SWIG")
+  swig_patches = {
+    "#ifndef RUBY_INIT_STACK" => "#ifdef __NEVER__" # Patching SWIG output for JRuby.
+  }.map{|pair| "s/#{pair.join('/')}/"}.join(';')
+  # sed has different syntax for inplace switch in BSD and GNU version, so using intermediate file
+  run("sed '#{swig_patches}' ext/rlibmemcached_wrap.c.in > ext/rlibmemcached_wrap.c", "Apply patches to SWIG output")
+end
+
+task :exceptions do
+  $LOAD_PATH << "lib"
+  require 'memcached'
+  Memcached.constants.sort.each do |const_name|
+    const = Memcached.send(:const_get, const_name)
+    next if const == Memcached::Success or const == Memcached::Stored
+    if const.is_a? Class and const < Memcached::Error
+      puts "* Memcached::#{const_name}"
+    end
+  end
+end
+
+task :benchmark do
+ exec("ruby #{File.dirname(__FILE__)}/test/profile/benchmark.rb")
+end
+
+task :rb_profile do
+ exec("ruby #{File.dirname(__FILE__)}/test/profile/rb_profiler.rb")
+end
+
+task :c_profile do
+ exec("ruby #{File.dirname(__FILE__)}/test/profile/c_profiler.rb")
+end
+
+task :valgrind do
+ exec("ruby #{File.dirname(__FILE__)}/test/profile/valgrind.rb")
+end
+
+def with_vm(vm, cmd)
+  bindir = vm.split("/")[0..-2].join("/")
+  puts "#{vm} #{cmd} started"
+  if !File.exist?("#{bindir}/rake")
+    puts "#{vm} not found"
+    exit(1)
+  elsif system("bash --norc --noprofile -c 'export PATH=#{bindir}:/bin:/usr/bin && which rake && #{bindir}/rake clean && #{bindir}/rake compile'")
+    puts "#{vm} compiled"
+    if system("bash --norc --noprofile -c 'export PATH=#{bindir}:/bin:/usr/bin && #{bindir}/rake #{cmd}'")
+      puts "#{vm} #{cmd} success (1st try)"
+    elsif system("bash --norc --noprofile -c 'export PATH=#{bindir}:/bin:/usr/bin && #{bindir}/rake #{cmd}'")
+      puts "#{vm} #{cmd} success (2nd try)"
+    else
+      puts "#{vm} #{cmd} failed"
+      exit(1)
+    end
+  else
+    puts "#{vm} compilation failed"
+    exit(1)
+  end
+end
+
+task :test_20 do
+  with_vm("/usr/bin/ruby", "test")
+end
+
+task :test_19 do
+  with_vm("/opt/local/bin/ruby1.9", "test")
+end
+
+task :test_rbx do
+  with_vm("/usr/local/rubinius/1.2.4/bin/rbx", "test")
+end
+
+task :test_all => [:test_20, :test_19, :test_rbx]
+
+task :prerelease => [:manifest, :test_all, :install]
+
+task :benchmark_all do
+  with_vms("benchmark CLIENT=libm")
+end
+
+def run(cmd, reason)
+  puts reason
+  puts cmd
+  raise "'#{cmd}' failed" unless system(cmd)
+end