stomp_parser 1.0.0-universal-java

data/spec/stomp_parser/ruby_parser_spec.rb

@@ -0,0 +1,3 @@
+describe StompParser::RubyParser do
+  it_behaves_like "a stomp_parser parser"
+end

data/spec/stomp_parser_spec.rb

@@ -0,0 +1,9 @@
+describe StompParser do
+  specify { defined?(StompParser::VERSION).should be_true }
+
+  describe ".max_frame_size" do
+    it "has a sane default value" do
+      StompParser.max_frame_size.should be_a(Fixnum)
+    end
+  end
+end

data/spec/support/shared_parser_examples.rb

@@ -0,0 +1,268 @@
+# encoding: UTF-8
+RSpec.shared_examples_for "a stomp_parser parser" do
+  let(:parser) { described_class.new }
+
+  context "#parse" do
+    def parse_all(data)
+      frames = []
+      parser.parse(data) { |m| frames << m }
+      frames
+    end
+
+    it "parses frame as binary" do
+      frames = parse_all("CONNECT\n\n\x00")
+      frames.length.should eq(1)
+      frames[0].command.encoding.should eq Encoding::BINARY
+    end
+
+    context "command" do
+      it "can parse commands" do
+        frames = parse_all("CONNECT\n\n\x00")
+        frames.length.should eq(1)
+        frames[0].command.should eq("CONNECT")
+      end
+    end
+
+    context "headers" do
+      it "can parse simple headers" do
+        frames = parse_all("CONNECT\nmoo:cow\n\n\x00")
+        frames.length.should eq(1)
+        frames[0].headers.should eq("moo" => "cow")
+      end
+
+      it "can parse multiple headers" do
+        frames = parse_all("CONNECT\nmoo:cow\nbaah:sheep\n\n\x00")
+        frames.length.should eq(1)
+        frames[0].headers.should eq("moo" => "cow", "baah" => "sheep")
+      end
+
+      it "can parse headers with NULLs in them" do
+        frames = parse_all("CONNECT\nnull\x00:null\x00\n\n\x00")
+        frames.length.should eq(1)
+        frames[0].headers.should eq("null\x00" => "null\x00")
+      end
+
+      it "can parse headers with escape characters" do
+        frames = parse_all("CONNECT\nnull\\c:\\r\\n\\c\\\\\n\n\x00")
+        frames.length.should eq(1)
+        frames[0].headers.should eq("null:" => "\r\n:\\")
+      end
+
+      it "can parse headers with no value" do
+        frames = parse_all("CONNECT\nmoo:\n\n\x00")
+        frames.length.should eq(1)
+        frames[0].headers.should eq("moo" => nil)
+      end
+
+      it "nullifies previous headers" do
+        frames = parse_all("CONNECT\nmoo:\nmoo:hello\n\n\x00")
+        frames.length.should eq(1)
+        frames[0].headers.should eq("moo" => nil)
+      end
+
+      it "prioritises first header when given multiple of same key" do
+        frames = parse_all("CONNECT\nkey:first\nkey:second\n\n\x00")
+        frames.length.should eq(1)
+        frames[0].headers.should eq("key" => "first")
+      end
+
+      it "parses multibyte headers as UTF-8 even if content type specifies something else" do
+        frames = parse_all("MESSAGE\ncontent-type:text/plain;charset=ISO-8859-1\nwhät:üp\n\n\x00")
+        frames.length.should eq(1)
+
+        key, value = frames[0].headers.to_a[1]
+
+        key.should eq "wh\xC3\xA4t".force_encoding("UTF-8")
+        key.encoding.should eq Encoding::UTF_8
+
+        value.should eq "\xC3\xBCp".force_encoding("UTF-8")
+        value.encoding.should eq Encoding::UTF_8
+      end
+    end
+
+    context "body" do
+      it "can parse body" do
+        frames = parse_all("CONNECT\n\nbody\x00")
+        frames.length.should eq(1)
+        frames[0].body.should eq "body"
+      end
+
+      it "can parse binary body" do
+        frames = parse_all("CONNECT\ncontent-length:5\n\nbo\x00dy\x00")
+        frames.length.should eq(1)
+        frames[0].body.should eq "bo\x00dy"
+      end
+
+      it "parses body as binary string when no content-type given" do
+        frames = parse_all("MESSAGE\n\nWhat üp\x00")
+        frames.length.should eq(1)
+        frames[0].body.should eq "What \xC3\xBCp".force_encoding("BINARY")
+        frames[0].body.encoding.should eq Encoding::BINARY
+      end
+
+      it "parses body as encoded string when content-type is a text type and charset is given" do
+        frames = parse_all("MESSAGE\ncontent-type:text/plain;charset=ISO-8859-1\n\nWhat \xFCp\x00")
+        frames.length.should eq(1)
+        frames[0].body.should eq "What \xFCp".force_encoding("iso-8859-1")
+        frames[0].body.encoding.should eq Encoding::ISO_8859_1
+      end
+
+      it "parses body as encoded string when content-type is not a text type and charset is given" do
+        frames = parse_all("MESSAGE\ncontent-type:application/octet-stream;charset=ISO-8859-1\n\nWhat \xFCp\x00")
+        frames.length.should eq(1)
+        frames[0].body.should eq "What \xFCp".force_encoding("iso-8859-1")
+        frames[0].body.encoding.should eq Encoding::ISO_8859_1
+      end
+
+      it "parses body as utf-8 encoded string when content-type is a text type and charset is not given" do
+        frames = parse_all("MESSAGE\ncontent-type:text/plain\n\nWhat üp\x00")
+        frames.length.should eq(1)
+        frames[0].body.should eq "What \xC3\xBCp".force_encoding("UTF-8")
+        frames[0].body.encoding.should eq Encoding::UTF_8
+      end
+
+      it "parses body as binary string when content-type is not a text type and charset is not given" do
+        frames = parse_all("MESSAGE\ncontent-type:application/octet-stream\n\nWhat \xFCp\x00")
+        frames.length.should eq(1)
+        frames[0].body.should eq "What \xFCp".force_encoding("BINARY")
+        frames[0].body.encoding.should eq Encoding::BINARY
+      end
+    end
+
+    context "multiple frames" do
+      it "yields multiple frames in a single invocation" do
+        frames = parse_all("CONNECT\n\n\x00CONNECT\n\n\x00CONNECT\n\n\x00")
+        frames.length.should eq(3)
+        frames.map(&:command).should eq %w[CONNECT CONNECT CONNECT]
+        frames.uniq.length.should eq(3)
+      end
+
+      it "allows newlines between frames" do
+        frames = parse_all("\n\r\n\nCONNECT\n\n\x00\n\n\r\nCONNECT\n\n\x00\n\n")
+        frames.length.should eq(2)
+        frames.map(&:command).should eq %w[CONNECT CONNECT]
+        frames.uniq.length.should eq(2)
+      end
+    end
+
+    context "multiple invocations" do
+      it "parses simple split up frames" do
+        frames = parse_all("CONNECT\n")
+        frames.should be_empty
+
+        frames = parse_all("\n\x00")
+        frames.length.should eq(1)
+        frames[0].command.should eq "CONNECT"
+      end
+
+      it "parses frames split across buffer markings" do
+        frames = parse_all("\n\nCONN")
+        frames.should be_empty
+
+        frames = parse_all("ECT\n\n\x00")
+        frames.length.should eq(1)
+        frames[0].command.should eq "CONNECT"
+      end
+
+      it "parses frames split across header keys" do
+        frames = parse_all("CONNECT\nheader:")
+        frames.should be_empty
+
+        frames = parse_all("value\n\n\x00")
+        frames.length.should eq(1)
+        frames[0].command.should eq "CONNECT"
+        frames[0].headers.should eq("header" => "value")
+      end
+
+      it "parses binary frame split across body" do
+        frames = parse_all("CONNECT\ncontent-length:4\n\n\x00a")
+        frames.should be_empty
+
+        frames = parse_all("b\x00\x00")
+        frames.length.should eq(1)
+        frames[0].command.should eq "CONNECT"
+        frames[0].body.should eq("\x00ab\x00")
+      end
+
+      it "parses frames split across frames" do
+        frames = parse_all("CONNECT\n")
+        frames.should be_empty
+
+        frames = parse_all("\n\x00CONNEC")
+        frames.length.should eq(1)
+        frames[0].command.should eq "CONNECT"
+
+        frames = parse_all("T\n\n\x00")
+        frames.length.should eq(1)
+        frames[0].command.should eq "CONNECT"
+      end
+    end
+
+    context "fails on invalid frames" do
+      specify "no block given" do
+        expect { parser.parse("CONNECT\n\n\x00") }.to raise_error(LocalJumpError)
+      end
+
+      specify "invalid command" do
+        expect { parser.parse("CONNET\n\n\x00") }.to raise_error(StompParser::ParseError)
+      end
+
+      specify "unfinished command" do
+        expect { parser.parse("CONNECT\x00") }.to raise_error(StompParser::ParseError)
+      end
+
+      specify "header with colon" do
+        expect { parser.parse("CONNECT\nfoo: :bar\n\n\x00") }.to raise_error(StompParser::ParseError)
+      end
+
+      specify "header with invalid escape" do
+        expect { parser.parse("CONNECT\nfoo:\\t\n\n\x00") }.to raise_error(StompParser::ParseError)
+      end
+
+      specify "body longer than content length" do
+        expect { parser.parse("CONNECT\ncontent-length:0\n\nx\x00") }.to raise_error(StompParser::ParseError)
+      end
+
+      specify "invalid content length" do
+        expect { parser.parse("CONNECT\ncontent-length:LAWL\n\nx\x00") }.to raise_error(StompParser::Error, /invalid content length "LAWL"/)
+      end
+
+      specify "re-trying invocation after an error" do
+        first_error = begin
+          parser.parse("CONNET")
+        rescue StompParser::ParseError => ex
+          ex
+        end
+
+        first_error.should be_a(StompParser::ParseError)
+
+        second_error = begin
+          parser.parse("")
+        rescue StompParser::ParseError => ex
+          ex
+        end
+
+        second_error.should eql(first_error)
+      end
+
+      specify "total size bigger than global max frame size setting" do
+        StompParser.stub(:max_frame_size => 30)
+        parser = described_class.new
+        parser.parse("CONNECT\n") # 8
+        parser.parse("header:value\n") # 21
+        expect {
+          parser.parse("other:val\n") # 31
+        }.to raise_error(StompParser::FrameSizeExceeded)
+      end
+
+      specify "total size bigger than local max frame size setting" do
+        parser = described_class.new(max_frame_size = 30)
+        parser.parse("CONNECT\n") # 8
+        parser.parse("header:value\n") # 21
+        expect {
+          parser.parse("other:val\n") # 31
+        }.to raise_error(StompParser::FrameSizeExceeded)
+      end
+    end
+  end
+end

data/stomp_parser.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'stomp_parser/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "stomp_parser"
+  spec.version       = StompParser::VERSION
+  spec.authors       = ["Kim Burgestrand", "Jonas Nicklas"]
+  spec.email         = ["kim@burgestrand.se", "jonas.nicklas@gmail.com"]
+  spec.summary       = %q{STOMP frame parser.}
+  spec.homepage      = "https://github.com/stompede/stomp_parser"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.files        += ["lib/stomp_parser/ruby_parser.rb"]
+  spec.files        += ["ext/stomp_parser/c_parser.c"]
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+  spec.extensions    = %w[ext/stomp_parser/extconf.rb]
+
+  spec.add_development_dependency "bundler", "~> 0"
+  spec.add_development_dependency "rake", "~> 0"
+  spec.add_development_dependency "rake-compiler", "~> 0"
+  spec.add_development_dependency "rspec", "~> 0"
+  spec.add_development_dependency "pry", "~> 0"
+end

metadata

@@ -0,0 +1,162 @@
+--- !ruby/object:Gem::Specification
+name: stomp_parser
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: universal-java
+authors:
+- Kim Burgestrand
+- Jonas Nicklas
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-02-11 00:00:00.000000000 Z
+dependencies:
+- !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: rake-compiler
+  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'
+- !ruby/object:Gem::Dependency
+  name: pry
+  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: 
+email:
+- kim@burgestrand.se
+- jonas.nicklas@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Brewfile
+- Gemfile
+- MIT-LICENSE.txt
+- README.md
+- Rakefile
+- ext/java/stomp_parser/JavaParser.java.rl
+- ext/java/stomp_parser/JavaParserService.java
+- ext/stomp_parser/c_parser.c
+- ext/stomp_parser/c_parser.c.rl
+- ext/stomp_parser/extconf.rb
+- lib/stomp_parser.rb
+- lib/stomp_parser/error.rb
+- lib/stomp_parser/frame.rb
+- lib/stomp_parser/java_parser.jar
+- lib/stomp_parser/ruby_parser.rb
+- lib/stomp_parser/ruby_parser.rb.rl
+- lib/stomp_parser/version.rb
+- parser_common.rl
+- spec/bench_helper.rb
+- spec/benchmarks/message_bench.rb
+- spec/benchmarks/parser_bench.rb
+- spec/profile.rb
+- spec/profile/.gitkeep
+- spec/spec_helper.rb
+- spec/stomp_parser/c_parser_spec.rb
+- spec/stomp_parser/java_parser_spec.rb
+- spec/stomp_parser/message_spec.rb
+- spec/stomp_parser/ruby_parser_spec.rb
+- spec/stomp_parser_spec.rb
+- spec/support/shared_parser_examples.rb
+- stomp_parser.gemspec
+homepage: https://github.com/stompede/stomp_parser
+licenses:
+- MIT
+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.2.0.rc.1
+signing_key: 
+specification_version: 4
+summary: STOMP frame parser.
+test_files:
+- spec/bench_helper.rb
+- spec/benchmarks/message_bench.rb
+- spec/benchmarks/parser_bench.rb
+- spec/profile.rb
+- spec/profile/.gitkeep
+- spec/spec_helper.rb
+- spec/stomp_parser/c_parser_spec.rb
+- spec/stomp_parser/java_parser_spec.rb
+- spec/stomp_parser/message_spec.rb
+- spec/stomp_parser/ruby_parser_spec.rb
+- spec/stomp_parser_spec.rb
+- spec/support/shared_parser_examples.rb