redis-rpc 1.0.0

data/lib/redis-rpc/version.rb

@@ -0,0 +1,3 @@
+module RedisRpc
+  VERSION = "1.0.0"
+end

data/redis-rpc.gemspec

@@ -0,0 +1,45 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/redis-rpc/version', __FILE__)
+
+Gem::Specification.new do |s|
+  s.name = 'redis-rpc'
+  s.version = RedisRpc::VERSION
+  s.license = 'GPLv3'
+  s.authors = ['Phuong Nguyen', 'Nathan Farrington']
+  s.email = ['nathan@nathanfarrington.com']
+
+  s.homepage = 'http://github.com/phuongnd08/redis-rpc-ruby'
+  s.summary = 'Lightweight RPC for Redis'
+  s.description = <<-DESCRIPTION
+    RedisRpc is the easiest to use RPC library in the world. (No small claim!) It
+    has implementations in Ruby, PHP, and Python.
+
+    Redis is a powerful in-memory data structure server that is useful for building
+    fast distributed systems. Redis implements message queue functionality with its
+    use of list data structures and the `LPOP`, `BLPOP`, and `RPUSH` commands.
+    RedisRpc implements a lightweight RPC mechanism using Redis message queues to
+    temporarily hold RPC request and response messages. These messages are encoded
+    as JSON strings for portability.
+
+    Many other RPC mechanisms are either programming language specific (e.g.
+    Java RMI) or require boiler-plate code for explicit typing (e.g. Thrift).
+    RedisRpc was designed to be extremely easy to use by eliminating boiler-plate
+    code while also being programming language neutral.  High performance was not
+    an initial goal of RedisRpc and other RPC libraries are likely to have better
+    performance. Instead, RedisRpc has better programmer performance; it lets you
+    get something working immediately.
+  DESCRIPTION
+  s.has_rdoc = false
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_runtime_dependency 'redis'
+  s.add_runtime_dependency 'multi_json', '~>1.3'
+
+  s.add_development_dependency 'bundler'
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'rspec'
+end

data/spec/calculator_spec.rb

@@ -0,0 +1,41 @@
+require File.expand_path( '../spec_helper.rb', __FILE__ )
+require File.expand_path( '../../examples/calc.rb', __FILE__ )
+
+describe Calculator do
+  [true,false].each do |over_redisrpc|
+    context "when run #{( over_redisrpc ? 'over redisrpc' : 'locally')}" do
+
+      if( over_redisrpc )
+        let(:rpc_server_builder){ lambda{ RedisRpc::Server.new( Redis.new($REDIS_CONFIG), 'calc', Calculator.new ) } }
+        before(:each) do
+          @server_pid = fork{ rpc_server_builder.call.run }
+        end
+        after(:each){ Process.kill(9, @server_pid); rpc_server_builder.call.flush_queue! }
+        let(:calculator){ RedisRpc::Client.new( $REDIS,'calc', 1) }
+      else
+        let(:calculator){ Calculator.new }
+      end
+
+      it 'should calculate' do
+        calculator.val.should == 0.0
+        calculator.add(3).should == 3.0
+        calculator.sub(2).should == 1.0
+        calculator.mul(14).should == 14.0
+        calculator.div(7).should == 2.0
+        calculator.val.should == 2.0
+        calculator.clr.should == 0.0
+        calculator.val.should == 0.0
+      end
+
+      it 'should raise when missing method is called' do
+        expect{ calculator.a_missing_method }.to raise_error(
+          over_redisrpc ? RedisRpc::RemoteException : NoMethodError
+        )
+      end
+
+      it 'should raise timeout when execution expires' do
+        expect{ calculator.send(:sleep,2) }.to raise_error RedisRpc::TimeoutException
+      end if over_redisrpc
+    end
+  end
+end

data/spec/redis-test.conf

@@ -0,0 +1,3 @@
+port 9736
+daemonize yes
+pidfile redis-test.pid

data/spec/spec_helper.rb

@@ -0,0 +1,56 @@
+require 'bundler'
+begin
+  Bundler.require(:default,:development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+
+def MultiJson.default_adapter
+  :ok_json
+end
+
+
+RSpec.configure do |config|
+  config.before :suite do
+    raise 'redis-server must be on your path to run this test' if `which redis-server`.empty?
+    $REDIS_CONF_PATH = File.expand_path('../redis-test.conf',__FILE__)
+
+    redis_conf_contents = File.read($REDIS_CONF_PATH)
+    raise "pidfile must be specified in #{$REDIS_CONF_PATH}" unless redis_conf_contents['pidfile'] 
+
+    $REDIS_CONFIG = {
+      :host => 'localhost', 
+      :port => (redis_conf_contents.match(/port ([0-9]+)/)[1].to_i rescue 6379), 
+      :db   => 15 # we'll be flushing regularly; db 15 is traditionally reserved for test
+      }
+
+    $stdout.write "Starting Redis on port #{$REDIS_CONFIG[:port]}... "; $stdout.flush
+    `redis-server #{$REDIS_CONF_PATH}`
+    puts 'Done.'
+    
+    $REDIS = Redis.new($REDIS_CONFIG)
+    begin
+      $REDIS.ping
+    rescue Timeout::Error, Errno::ECONNREFUSED
+      retries ||= 3
+      sleep 1 and retry unless (retries-=1).zero?
+      $stderr.puts 'Could not connect to Redis after 3 tries.'
+      exit
+    end
+  end
+
+  config.around :each do |example|
+    $REDIS.flushdb
+    example.call
+  end
+
+  config.after :suite do
+    pidfile = (File.read($REDIS_CONF_PATH).match(/pidfile (.+)$/)[1].chomp rescue nil)
+    $stdout.write "\nKilling test redis server... "; $stdout.flush
+    Process.kill("KILL", File.read(pidfile).chomp.to_i )
+    File.unlink(pidfile)
+    puts 'Done.'
+  end
+end

metadata

@@ -0,0 +1,156 @@
+--- !ruby/object:Gem::Specification
+name: redis-rpc
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Phuong Nguyen
+- Nathan Farrington
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-09-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: redis
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: |2
+      RedisRpc is the easiest to use RPC library in the world. (No small claim!) It
+      has implementations in Ruby, PHP, and Python.
+
+      Redis is a powerful in-memory data structure server that is useful for building
+      fast distributed systems. Redis implements message queue functionality with its
+      use of list data structures and the `LPOP`, `BLPOP`, and `RPUSH` commands.
+      RedisRpc implements a lightweight RPC mechanism using Redis message queues to
+      temporarily hold RPC request and response messages. These messages are encoded
+      as JSON strings for portability.
+
+      Many other RPC mechanisms are either programming language specific (e.g.
+      Java RMI) or require boiler-plate code for explicit typing (e.g. Thrift).
+      RedisRpc was designed to be extremely easy to use by eliminating boiler-plate
+      code while also being programming language neutral.  High performance was not
+      an initial goal of RedisRpc and other RPC libraries are likely to have better
+      performance. Instead, RedisRpc has better programmer performance; it lets you
+      get something working immediately.
+email:
+- nathan@nathanfarrington.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- CHANGELOG.markdown
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.markdown
+- Rakefile
+- VERSION
+- docs/github-flavored-markdown.rb
+- docs/redisrpc_example.ai
+- docs/redisrpc_example.png
+- docs/redisrpc_example.svg
+- examples/calc.rb
+- examples/client.rb
+- examples/server.rb
+- lib/redis-rpc.rb
+- lib/redis-rpc/version.rb
+- redis-rpc.gemspec
+- spec/calculator_spec.rb
+- spec/redis-test.conf
+- spec/spec_helper.rb
+homepage: http://github.com/phuongnd08/redis-rpc-ruby
+licenses:
+- GPLv3
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5.2
+signing_key: 
+specification_version: 4
+summary: Lightweight RPC for Redis
+test_files:
+- spec/calculator_spec.rb
+- spec/redis-test.conf
+- spec/spec_helper.rb