messQ 0.0.1

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.log
+*pidfile

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in messQ.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 AbhishekKr
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README

@@ -0,0 +1,31 @@
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+   _  _   __   ___  ___       _____
+  ||\/|| //_  //_  //_   __  //  //    messQ v0.0.1
+  ||  || \\_  __// __//     //__//\\_  simplistic socket mess Queue
+
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+  ~=ABK=~ http://github.com/abhishekkr
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+  a very simplistic socket-based message enQueue/deQueue facility
+
+  |||||||||||||| HOW TO USE |||||||||||||||||
+
+  messq --start
+  messq --stop
+  messq -enq element || messq --enqueue element || MessQ::Agent.enqueue(elelemnt)
+  messq -deq || messq --dequeue || MessQ::Agent.dequeue
+
+  [] To enqueue a message
+    open a connection to it (default at port 8888)
+    and send as 'enq MESSAGE'
+    it will return the enqueued message, if wanna check back
+
+  [] To dequeue a message
+    open a connection to it (default at port 8888)
+    and send as 'deq'
+    it will return the dequeued message
+
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/messQ

@@ -0,0 +1,45 @@
+#!/usr/bin/env ruby
+$LOAD_PATH.unshift File.dirname(__FILE__) + '/../lib'
+
+require 'arg0'
+require 'messQ'
+
+que = Arg0::Console.value_for(['--enqueue', '-enq'])
+que.each do |q|
+  MessQ::Agent.enqueue q
+end
+
+if Arg0::Console.switch?('--start')
+  MessQ.messQ_server
+  puts "MessQ server started."
+elsif Arg0::Console.switch?('--stop')
+  MessQ::Server.stop
+  puts "MessQ server stopped."
+elsif Arg0::Console.switch?(['--dequeue', '-deq'])
+  puts "Value dequeued: #{MessQ::Agent.dequeue}"
+elsif Arg0::Console.switch?(['-h', '--help']) || que.empty?
+  puts <<-HELP
+  MessQ v0.0.1
+  a very simplistic queue server and agent
+  MessQ can be started in daemon mode as
+    $ messQ --start
+  Can be stopped in following way
+    $ messQ --stop
+  Enqueue & Dequeue at Console happens like
+    $ messQ -enq <element>
+    $ messQ --enqueue <element>
+    $ messQ -deq
+    $ messQ --dequeue
+  Enqueue & Dequeue from Ruby Code requires
+    requie 'messQ'
+    # if required configure
+    MessQ.host = <host IP>
+    MessQ.port = <port for MessQ Server>
+    # mandatory
+    MessQ::Agent.enqueue(<element>) # returns enqueued <element>
+    MessQ::Agent.dequeue            # returns dequeued element
+  This message comes on
+    $ messq -h
+    $ messq --help
+  HELP
+end

data/lib/messQ.rb

@@ -0,0 +1,34 @@
+# messQ
+
+messq_libs = File.join(File.dirname(File.expand_path __FILE__), 'messQ', '*.rb')
+Dir.glob(messq_libs).each do |lib|
+    require lib
+end
+
+require 'socket'
+
+module MessQ
+
+  class << self
+    attr_accessor :host, :port, :q
+    attr_accessor :pid, :pidfile, :logfile
+  end
+  @host ||= '0.0.0.0'
+  @port ||= 5566
+  @q    ||= []
+  @pidfile = File.join(File.dirname(__FILE__), '..', 'bin', 'pidfile')
+  @logfile = File.join(File.dirname(__FILE__), '..', 'bin', 'messQ.log')
+
+  def self.messQ_server
+    begin
+      Process.daemon(true)
+      @pid = Process.fork do
+        MessQ::Server.start
+      end
+      File.open(@pidfile, 'w'){|fyl| fyl.puts @pid}
+      MessQ::Verbose.logme "MessQ server PID:#{@pid}"
+    rescue
+      MessQ::Verbose.logme "messQ failed."
+    end
+  end
+end

data/lib/messQ/agent.rb

@@ -0,0 +1,28 @@
+# MessQ::Agent
+
+module MessQ
+  module Agent
+
+    def self.enqueue(msg)
+      client "enq #{msg}"
+    end
+
+    def self.dequeue
+      client 'deq'
+    end
+
+    def self.client(cmd)
+      begin
+        TCPSocket.open(MessQ.host, MessQ.port) do |socket|
+          socket.puts cmd
+          server_says = socket.read
+          socket.flush
+          socket.close
+          return server_says
+        end
+      rescue
+        MessQ::Verbose.logme 'Can not connect to MessQ.'
+      end
+    end
+  end
+end

data/lib/messQ/server.rb

@@ -0,0 +1,25 @@
+# MessQ::Server
+
+module MessQ
+  module Server
+
+    def self.start
+      begin
+        webserver = TCPServer.new(MessQ.host, MessQ.port)
+        MessQ::Verbose.logme "messQ has been started at #{MessQ.host}:#{MessQ.port}"
+        while (session = webserver.accept)
+          MessQ::Session.handler session
+        end
+      rescue
+        MessQ::Verbose.logme "messQ failed starting at #{MessQ.host}:#{MessQ.port}."
+      end
+    end
+
+    def self.stop
+      return unless File.exists? MessQ.pidfile
+      MessQ.pid = File.read(MessQ.pidfile).strip.to_i
+      MessQ::Verbose.logme  "Killing PID: #{MessQ.pid}"
+      Process.kill(15, MessQ.pid)
+    end
+  end
+end

data/lib/messQ/session.rb

@@ -0,0 +1,22 @@
+# MessQ::Session
+
+module MessQ
+  module Session
+
+    def self.handler(session)
+      request = session.gets
+      Thread.start(session, request) do |session, request|
+        if request.match(/[eE][nN][qQ]\ /)
+          MessQ.q << request.gsub(/[eE][nN][qQ]\ /, '').chomp
+          MessQ::Verbose.logme "added to messQ: #{MessQ.q[-1]}"
+          session.print MessQ.q[-1]
+        elsif request.match(/[dD][eE][qQ]/)
+          deq = MessQ.q.shift
+          MessQ::Verbose.logme "removed from messQ: #{deq}"
+          session.print deq
+        end
+        session.close
+      end
+    end
+  end
+end

data/lib/messQ/verbose.rb

@@ -0,0 +1,11 @@
+# MessQ::Verbose
+
+module MessQ
+  module Verbose
+
+    def self.logme(message)
+      puts "sockQ> #{message}"
+      File.open(MessQ.logfile, 'a'){|fyl| fyl.puts message}
+    end
+  end
+end

data/lib/messQ/version.rb

@@ -0,0 +1,3 @@
+module MessQ
+  VERSION = "0.0.1"
+end

data/messQ.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'messQ/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "messQ"
+  gem.version       = MessQ::VERSION
+  gem.authors       = ["AbhishekKr"]
+  gem.email         = ["abhikumar163@gmail.com"]
+  gem.description   = %q{a very simplistic queue server and agent}
+  gem.summary       = %q{a very simplistic socket-based message enQueue/deQueue facility}
+  gem.homepage      = "https://github.com/abhishekkr/messQ"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+
+  gem.executables   = %w( messQ )
+
+  gem.add_runtime_dependency 'arg0', '>= 0.0.2'
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification
+name: messQ
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- AbhishekKr
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-01-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: arg0
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+description: a very simplistic queue server and agent
+email:
+- abhikumar163@gmail.com
+executables:
+- messQ
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README
+- Rakefile
+- bin/messQ
+- lib/messQ.rb
+- lib/messQ/agent.rb
+- lib/messQ/server.rb
+- lib/messQ/session.rb
+- lib/messQ/verbose.rb
+- lib/messQ/version.rb
+- messQ.gemspec
+homepage: https://github.com/abhishekkr/messQ
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: a very simplistic socket-based message enQueue/deQueue facility
+test_files: []