udpbucket 0.0.8 → 0.0.9

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8dded6b7b74f8c9ed42f37b5b0e01ef7f11e81b5
+  data.tar.gz: 66baffdeca1e8fa233c0c8dbd090f705e61d4bff
+SHA512:
+  metadata.gz: f11b2881d7fb037b3aa3891e69a35ec9cf10c700492e21e89923c2bc87ff2b0e61fcef455797f190e4009c736071dcd748992af11d1b6f85424197255312be02
+  data.tar.gz: b45ca23f11f6757fdc6d171abd8326cc47917df2618f7898dc1718a24a8206b4f3a8683056f5eb06fc538b9973f7cb83130d3e7424e89dbea7dd65bb2c4df049

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/Gemfile.lock

@@ -0,0 +1,22 @@
+PATH
+  remote: .
+  specs:
+    udpbucket (0.0.9)
+      asetus (>= 0.0.7)
+      json
+      logger (>= 1.2.8)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    asetus (0.0.7)
+      slop
+    json (1.8.1)
+    logger (1.2.8)
+    slop (3.5.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  udpbucket!

data/README.md

@@ -0,0 +1,45 @@
+## UDPBucket
+
+A simple UDP server library using working queue.
+
+## requirements
+
++ ruby 1.9.3+
++ json
++ asetus 0.0.7+
++ logger 1.2.8+
+
+## install
+
+	> gem install udpbucket
+	>
+
+## packets
+
+UDPBucket returns to a block each packet it receives to the listening UDP port formatted in a standard hash.
+
+## hash format
+
+	{ :client_sock => <socket_object>, 
+	  :client_ip => 'x.x.x.x', 
+	  :client_port => xxxxx, 
+	  :payload => '\x00\xFF\xFF' }
+
+## example:
+
+	require 'udpbucket'
+
+	begin
+	  cfg = { :localhost => '0.0.0.0', :localport => 1024, :debug => 0 }
+	  udpbucket = UDPBucket::Core.new cfg
+	  udpbucket.listen do |req|
+	    if req[:payload] == '\x00\xFF\xFF'
+	      req[:client_sock].send '<..some payload..>', 0, req[:client_ip], req[:client_port]
+              udpbucket.debug "reply sent to client: #{req[:client_ip]}:#{req[:client_port]}" if cfg[:debug] == 1
+	    end
+	  end
+	end
+
+## configuration:
+
+The configuration is loaded at the start via Asetus. If the configuration is not passed to the 'Core' class, Asetus will load the default set (localhost:0.0.0.0,localport:16265,debug:1)

data/Rakefile

@@ -0,0 +1,36 @@
+begin
+  require 'bundler'
+  Bundler.setup
+rescue => e
+  warn "ERROR: #{e}"
+  exit 1
+end
+
+gemspec = eval(File.read(Dir['*.gemspec'].first))
+file    = [gemspec.name, gemspec.version].join('-') + '.gem'
+
+task :validate do
+  gemspec.validate
+end
+
+task :build do
+  system "gem build #{gemspec.name}.gemspec"
+  FileUtils.mkdir_p 'gems'
+  FileUtils.mv file, 'gems'
+end
+
+task :install => [ :validate, :build ] do
+  system "sudo -E sh -c \'umask 022; gem install gems/#{file} --no-ri --no-rdoc\'"
+end
+
+task :clean do
+  FileUtils.rm_rf 'gems'
+end
+
+task :push do
+  system "gem push gems/#{file}"
+end
+
+task :remove do
+  system "sudo -E sh -c \'umask 022; gem uninstall #{gemspec.name}\'"
+end

data/examples/dns_xlate.rb

@@ -0,0 +1,24 @@
+#!/usr/bin/env ruby
+
+require 'udpbucket'
+
+resolver = '8.8.8.8'
+
+begin
+  cfg = { :localhost => '::', :localport => 53, :debug => 1 }
+  udpbucket = UDPBucket::Core.new cfg
+  udpbucket.listen do |pkt_hash|
+    out_sock = UDPSocket.new
+    r = Random.new
+    sport = r.rand(1024..65535)
+    out_sock.bind '0.0.0.0', sport
+    udpbucket.debug "forwarding request to resolver : #{resolver}:53" if cfg[:debug] == 1
+    out_sock.send pkt_hash[:payload], 0, resolver, 53
+    reply, _ = out_sock.recvfrom(1500)
+    re_hash = { :resolver_ip => resolver, :reply => reply }
+    udpbucket.debug "reply received : #{re_hash}" if cfg[:debug] == 1
+    pkt_hash[:client_sock].send reply, 0, pkt_hash[:client_ip], pkt_hash[:client_port]
+    out_sock.close
+    udpbucket.debug "translation completed"  if cfg[:debug] == 1
+  end
+end

data/examples/rsabin.rb

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+
+require 'udpbucket'
+
+begin
+  cfg = { :localhost => '::', :localport => 53, :debug => 1 }
+  udpbucket = UDPBucket::Core.new cfg
+  udpbucket.listen do |pkt_hash|
+    puts pkt_hash[:payload]
+  end
+end  

data/lib/udpbucket/core.rb

@@ -1,23 +1,26 @@
 module UDPBucket
   class Core
+    require 'asetus'
 
-    def initialize cfg
-      @cfg              = cfg
-      @debug            = @cfg[:debug]
-      @localhost        = @cfg[:localhost] || '0.0.0.0'
-      @localport        = @cfg[:localport] || 16265
+    def initialize usercfg={}
+      cfgs = Asetus.new :name=>'udpbucket', :load=>false
+      cfgs.default.debug      = usercfg[:debug] || 0
+      cfgs.default.localhost  = usercfg[:localhost] || '0.0.0.0'
+      cfgs.default.localport  = usercfg[:localport] || 16265
+      cfgs.load
+      @cfg = cfgs.cfg
+      load
+    end
+
+    def load
       @rx_queue         = Queue.new
-      if IPAddr.new(@localhost).ipv6?
+      if IPAddr.new(@cfg.localhost).ipv6?
         @sock           = UDPSocket.new Socket::AF_INET6
       else
         @sock           = UDPSocket.new
       end
-      @sock.bind @localhost, @localport
-      debug "udpbucket server up: #{@localhost}:#{@localport}" if @debug == 1
-    end
-
-    def debug msg
-      puts [ "D, [#{Time.now} ", [ "#", "#{Process.pid}" ].join, "] DEBUG -- ", msg ].join 
+      @sock.bind @cfg.localhost, @cfg.localport
+      Log.debug "udpbucket server up: #{@cfg.localhost}:#{@cfg.localport}" if @cfg.debug == 1
     end
 
     def listen
@@ -28,7 +31,7 @@ module UDPBucket
             buffer, sockaddr = @sock.recvfrom_nonblock(1500)
             pkt = { :client_sock => @sock, :client_ip => sockaddr[3], :client_port => sockaddr[1], :payload => buffer }
 	    @rx_queue << pkt
-            debug "packet queued (queue size:#{@rx_queue.size}): #{pkt}" if @debug == 1
+            Log.debug "packet queued (queue size:#{@rx_queue.size}): #{pkt}" if @cfg.debug == 1
           end
         end
       end
@@ -36,7 +39,7 @@ module UDPBucket
         while true do
           begin
             yield @rx_queue.pop
-            debug "yield to block (queue size:#{@rx_queue.size})" if @debug == 1
+            Log.debug "yield to block (queue size:#{@rx_queue.size})" if @cfg.debug == 1
           end
         end
       end

data/lib/udpbucket/log.rb

@@ -0,0 +1,5 @@
+module UDPBucket
+  require 'logger'
+  target = STDOUT
+  Log = Logger.new target
+end

data/lib/udpbucket.rb

@@ -4,5 +4,6 @@ module UDPBucket
  require 'socket'
  require 'thread'
  require 'ipaddr'
+ require 'udpbucket/log'
  require 'udpbucket/core'
 end

data/udpbucket.gemspec

@@ -0,0 +1,18 @@
+Gem::Specification.new do |s|
+  s.name              = 'udpbucket'
+  s.version           = '0.0.9'
+  s.platform          = Gem::Platform::RUBY
+  s.authors           = [ 'Samer Abdel-Hafez' ]
+  s.email             = %w( sam@arahant.net )
+  s.homepage          = 'http://github.com/nopedial/udpbucket'
+  s.summary           = 'udp bucket'
+  s.description       = 'a lightweight udp server'
+  s.rubyforge_project = s.name
+  s.files             = `git ls-files`.split("\n")
+  s.executables       = %w( )
+  s.require_path      = 'lib'
+
+  s.add_dependency 'json'
+  s.add_dependency 'asetus', '>= 0.0.7'
+  s.add_dependency 'logger', '>= 1.2.8'
+end

metadata

@@ -1,8 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: udpbucket
 version: !ruby/object:Gem::Version
-  version: 0.0.8
-  prerelease: 
+  version: 0.0.9
 platform: ruby
 authors:
 - Samer Abdel-Hafez
@@ -14,19 +13,45 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: asetus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.0.7
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.0.7
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.2.8
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.2.8
 description: a lightweight udp server
 email:
 - sam@arahant.net
@@ -34,36 +59,37 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- examples/dns_xlate.rb
+- examples/rsabin.rb
 - lib/udpbucket.rb
 - lib/udpbucket/core.rb
+- lib/udpbucket/log.rb
+- udpbucket.gemspec
 homepage: http://github.com/nopedial/udpbucket
 licenses: []
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: 427306861
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: 427306861
 requirements: []
 rubyforge_project: udpbucket
-rubygems_version: 1.8.23
+rubygems_version: 2.0.14
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: udp bucket
 test_files: []