arvicco-amqp 0.6.8

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+*.rbc
+~*
+#*

data/HISTORY

@@ -0,0 +1,7 @@
+== 0.6.7 / 2010-11-03
+
+* Forked tmm1/amqp at Github
+
+== 0.6.8 / 2010-11-03
+
+* Additional improvements from latest forks added

data/README.md

@@ -0,0 +1,155 @@
+What AMQP gem is
+================
+
+Simple asynchronous AMQP driver for Ruby/EventMachine
+This library works with Ruby 1.8, Ruby 1.9, JRuby and Rubinius,
+and is licensed under [the Ruby License](http://www.ruby-lang.org/en/LICENSE.txt).
+
+This library was tested primarily with RabbitMQ, although it should be compatible with any
+server implementing the [AMQP 0-8 spec](http://www.amqp.org/confluence/download/attachments/720900/amqp0-8.pdf).
+
+
+This fork of AMQP
+=================
+
+Contains following improvements:
+ * Support for setting extended headers in MQ::Exchange#publish. Particularly useful for :reply_to for RPC.
+ * Multibyte character support (Ruby 1.9) in MQ::Exchange#publish.
+ * MQ::Queue only wraps headers with new MQ::Headers if they are not nil. This allows pops to tell more easily when they've requested a message from an empty queue.
+ * Support for receiving Headers with zero-size data packets. Such contents with no body frames are totally legit if indicated header size is zero.
+
+
+Getting started
+===============
+
+To use examples with RabbitMQ, first [install the broker](http://www.rabbitmq.com/install.html).
+If you have Mercurial and Erlang/OTP installed, here is how to do it in 4 lines:
+
+    hg clone http://hg.rabbitmq.com/rabbitmq-codegen
+    hg clone http://hg.rabbitmq.com/rabbitmq-server
+    cd rabbitmq-server
+    make run
+
+Then have a look at the various bundled examples:
+
+    ruby examples/mq/pingpong.rb   # 1-1 communication using amq.direct
+    ruby examples/mq/clock.rb      # 1-N communication using amq.fanout
+    ruby examples/mq/stocks.rb     # 1-subscriber communication using amq.topic
+
+    ruby examples/mq/multiclock.rb # header based routing (new rabbitmq feature)
+    ruby examples/mq/ack.rb        # using ack
+    ruby examples/mq/pop.rb        # pop off messages one at a time
+
+    ruby examples/mq/hashtable.rb  # simple async rpc layer
+    ruby examples/mq/primes.rb 4   # parallelized prime number generation
+    ruby examples/mq/logger.rb     # simple logging api
+
+For high level API documentation see MQ class.
+For more details into the lower level AMQP client API, run the simple client example:
+
+    ruby examples/amqp/simple.rb   # low-level AMQP api
+    ruby examples/mq/internal.rb   # low-level Queue/Exchange api
+
+Or refer to protocol/doc.txt, which enumerates packets sent between a server and client
+during a typical session, in both binary and decoded formats.
+
+How to use AMQP gem with Ruby on Rails, Merb, Sinatra and other web frameworks
+==============================================================================
+
+To use AMQP gem from web applications, you would need to have EventMachine reactor running.
+If you use [Thin](http://code.macournoyer.com/thin/), you are set: Thin uses EventMachine under
+the hook.
+
+With other web servers, you need to start EventMachine reactor in it's own thread like this:
+
+    Thread.new { EM.run }
+
+because otherwise EventMachine will block current thread. Then connect to AMQP broker:
+
+    AMQP.connect(:host => "localhost", :user => "guest", :pass => "guest", :vhost => "/")
+
+In a Ruby on Rails app, probably the best place for this code is initializer
+(like config/initializers/amqp.rb). For Merb apps, it is config/init.rb. For
+Sinatra and pure Rack applications, place it next to other configuration
+code.
+
+Same separate thread technique can be used to make EventMachine play nicely with other
+libraries that would block current thread (like [File::Tail](http://rubygems.org/gems/file-tail)).
+
+AMQP gem mailing list
+==============================
+
+* [AMQP gem mailing list](http://groups.google.com/group/ruby-amqp)
+* [AMQP gem at GitHub](http://github.com/tmm1/amqp)
+* [AMQP gem at Gemcutter](http://rubygems.org/gems/amqp)
+
+Running specifications suite
+============================
+
+To run the test suite make sure you have [bacon](http://gemcutter.org/gems/bacon) gem installed and run:
+
+    rake spec
+
+The lib/amqp/spec.rb file is generated automatically based on the [AMQP specification](http://www.amqp.org/confluence/display/AMQP/AMQP+Specification). To generate it:
+
+    rake codegen
+
+Credits and more information
+============================
+
+(c) 2008—2010 [Aman Gupta](http://github.com/tmm1) (tmm1)
+
+This project was inspired by [py-amqplib](http://barryp.org/software/py-amqplib/), [rabbitmq](http://rabbitmq.com), [qpid](http://qpid.apache.org/) and [rubbyt](http://github.com/rubbyt/rubbyt).
+Special thanks to Dmitriy Samovskiy, Ben Hood and Tony Garnock-Jones.
+
+AMQP brokers
+------------
+
+ * [RabbitMQ](http://rabbitmq.com) (Rabbit Technologies, Erlang/OTP, MPL)
+ * [ZeroMQ](http://www.zeromq.org) (iMatix/FastMQ/Intel, C++, GPL3)
+ * [OpenAMQ](http://openamq.org) (iMatix, C, GPL2)
+ * [ActiveMQ](http://activemq.apache.org) (Apache Foundation, Java, Apache2)
+
+AMQP resources
+--------------
+
+ * Steve Vinoski [explains AMQP](http://steve.vinoski.net/pdf/IEEE-Advanced_Message_Queuing_Protocol.pdf) in his column, Towards Integration
+
+ * John O'Hara on [the history of AMQP](http://www.acmqueue.org/modules.php?name=Content&pa=showpage&pid=485)
+
+ * Dmitriy's [presentation on RabbitMQ/AMQP](http://somic-org.homelinux.org/blog/2008/07/31/slides-for-my-amqprabbitmq-talk/)
+
+ * ZeroMQ's [analysis of the messaging technology market](http://www.zeromq.org/whitepapers:market-analysis)
+
+ * Pieter Hintjens's [background to AMQP](http://www.openamq.org/doc:amqp-background)
+
+ * Barry Pederson's [py-amqplib](http://barryp.org/software/py-amqplib/)
+
+ * Ben Hood on [writing an AMQP client](http://hopper.squarespace.com/blog/2008/6/21/build-your-own-amqp-client.html)
+
+ * Dmitriy Samovskiy introduces [Ruby + QPid + RabbitMQ](http://somic-org.homelinux.org/blog/2008/06/24/ruby-amqp-rabbitmq-example/)
+
+ * Ben Hood's [as3-amqp](http://github.com/0x6e6562/as3-amqp) ([two](http://hopper.squarespace.com/blog/2008/7/4/server-side-as3.html), [three](http://hopper.squarespace.com/blog/2008/3/24/as3-amqp-client-first-cut.html))
+
+ * RabbitMQ's [AMQP protocol code generator](http://hg.rabbitmq.com/rabbitmq-codegen/)
+
+ * Erlang Exchange [presentation on the implementation of RabbitMQ](http://skillsmatter.com/podcast/erlang/presenting-rabbitmq-an-erlang-based-implementatio-nof-amqp) (and on the [LShift blog](http://www.lshift.net/blog/2008/07/01/slides-from-our-erlang-exchange-talk))
+
+ * Jonathan Conway's series on RabbitMQ and using it with Ruby and Merb: [One](http://jaikoo.com/2007/9/4/didn-t-you-get-the-memo), [Two](http://jaikoo.com/2008/2/29/friday-round-up-2008-02-29), [Three](http://jaikoo.com/2008/3/14/oh-hai-rabbitmq), [Four](http://jaikoo.com/2008/3/20/daemonize-rabbitmq)
+
+ * Open Enterprise's series on messaging middleware and AMQP: [Part 1](http://www1.interopsystems.com/analysis/can-amqp-break-ibms-mom-monopoly-part-1.html), [Part 2](http://www1.interopsystems.com/analysis/can-amqp-break-ibms-mom-monopoly-part-2.html), [Part 3](http://www1.interopsystems.com/analysis/can-amqp-break-ibms-mom-monopoly-part-3.html)
+
+Messaging and distributed systems resources
+-------------------------------------------
+
+ * [A Critique of the Remote Procedure Call Paradigm](http://www.cs.vu.nl/~ast/publications/euteco-1988.pdf)
+
+ * [A Note on Distributed Computing](http://research.sun.com/techrep/1994/smli_tr-94-29.pdf)
+
+ * [Convenience Over Correctness](http://steve.vinoski.net/pdf/IEEE-Convenience_Over_Correctness.pdf)
+
+ * [Metaprotocol Taxonomy and Communications Patterns](http://hessian.caucho.com/doc/metaprotocol-taxonomy.xtp)
+
+ * Joe Armstrong on [Erlang messaging vs RPC](http://armstrongonsoftware.blogspot.com/2008/05/road-we-didnt-go-down.html)
+
+ * [SEDA: scalable internet services using message queues](http://www.eecs.harvard.edu/~mdw/papers/seda-sosp01.pdf)

data/Rakefile

@@ -0,0 +1,29 @@
+require 'rake'
+require 'pathname'
+
+BASE_PATH = Pathname.new(__FILE__).dirname
+LIB_PATH =  BASE_PATH + 'lib'
+PKG_PATH =  BASE_PATH + 'pkg'
+DOC_PATH =  BASE_PATH + 'rdoc'
+
+$LOAD_PATH.unshift LIB_PATH.to_s unless $LOAD_PATH.include? LIB_PATH.to_s
+
+require 'amqp/version'
+
+NAME = 'arvicco-amqp'
+CLASS_NAME = AMQP
+VERSION = CLASS_NAME::VERSION
+
+# Load rakefile tasks
+Dir['tasks/*.rake'].sort.each { |file| load file }
+
+desc "Generate AMQP specification classes"
+task :codegen do
+  sh 'ruby protocol/codegen.rb > lib/amqp/spec.rb'
+  sh 'ruby lib/amqp/spec.rb'
+end
+
+desc "Run spec suite (uses bacon gem)"
+task :test do
+  sh 'bacon lib/amqp.rb'
+end

data/TODO

@@ -0,0 +1,30 @@
+- breaks with header values that are nil (deleting nil headers in Exchange#publish for now)
+
+- generate amqp/spec.rb from original xml spec
+- add peek and pop to queues
+- use rabbitmq generated consumer tag from basic.consume-ok reply
+
+- allow temporary queues with amq.queue(nil) syntax (use uuids)
+  - use as temp queue in rpc
+  - use uuids for message ids in rpc
+
+- add ack/completed responses for messages
+- deleting queues/bindings/exchanges
+  + queue.unbind
+  - queue.remove or queue.close or queue.delete
+  - exchange.remove
+  - rpc.remove
+
+- handle errors and exceptions
+    binding to a non-existent (or not yet created in clock.rb) exchange
+      #<AMQP::Protocol::Channel::Close:0x11d35d4
+       @class_id=50,
+       @debug=1,
+       @method_id=20,
+       @reply_code=404,
+       @reply_text="NOT_FOUND - no exchange 'clock' in vhost '/'">>]
+
+- handle connection.redirect during connect (for rabbitmq in distributed mode) [or just set insist to true]
+
+- add amq.queue('name').size{ |num| "#{num} messages in the queue" } (send declare passive, look at declare-ok response)
+- clean up MQ.default on disconnect

data/VERSION

@@ -0,0 +1 @@
+0.6.8

data/doc/EXAMPLE_01_PINGPONG

@@ -0,0 +1,2 @@
+== Ping Pong Example
+  :include: mq/pingpong.rb

data/doc/EXAMPLE_02_CLOCK

@@ -0,0 +1,2 @@
+== Clock Example
+  :include: mq/clock.rb

data/doc/EXAMPLE_03_STOCKS

@@ -0,0 +1,2 @@
+== Stocks Example
+  :include: mq/stocks.rb

data/doc/EXAMPLE_04_MULTICLOCK

@@ -0,0 +1,2 @@
+== Muti-format Clock Example
+  :include: mq/multiclock.rb

data/doc/EXAMPLE_05_ACK

@@ -0,0 +1,2 @@
+== Ack Example
+  :include: mq/ack.rb

data/doc/EXAMPLE_05_POP

@@ -0,0 +1,2 @@
+== Pop Example
+  :include: mq/pop.rb

data/doc/EXAMPLE_06_HASHTABLE

@@ -0,0 +1,2 @@
+== HashTable RPC Example
+  :include: mq/hashtable.rb

metadata

@@ -0,0 +1,119 @@
+--- !ruby/object:Gem::Specification 
+name: arvicco-amqp
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: false
+  segments: 
+  - 0
+  - 6
+  - 8
+  version: 0.6.8
+platform: ruby
+authors: 
+- Aman Gupta
+- Arvicco
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-11-03 00:00:00 +03:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: eventmachine
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 39
+        segments: 
+        - 0
+        - 12
+        - 4
+        version: 0.12.4
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: bacon
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 31
+        segments: 
+        - 0
+        - 0
+        - 0
+        version: 0.0.0
+  type: :development
+  version_requirements: *id002
+description: An implementation of the AMQP protocol in Ruby/EventMachine. Fork of original tmm1/amqp with improvements (see README).
+email: arvitallian@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.md
+- HISTORY
+- doc/EXAMPLE_01_PINGPONG
+- doc/EXAMPLE_02_CLOCK
+- doc/EXAMPLE_03_STOCKS
+- doc/EXAMPLE_04_MULTICLOCK
+- doc/EXAMPLE_05_ACK
+- doc/EXAMPLE_05_POP
+- doc/EXAMPLE_06_HASHTABLE
+files: 
+- Rakefile
+- README.md
+- VERSION
+- TODO
+- HISTORY
+- .gitignore
+- doc/EXAMPLE_01_PINGPONG
+- doc/EXAMPLE_02_CLOCK
+- doc/EXAMPLE_03_STOCKS
+- doc/EXAMPLE_04_MULTICLOCK
+- doc/EXAMPLE_05_ACK
+- doc/EXAMPLE_05_POP
+- doc/EXAMPLE_06_HASHTABLE
+has_rdoc: true
+homepage: http://github.com/arvicco/amqp
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --include=examples
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Fork of original tmm1/amqp with some tweaks.
+test_files: []
+