jmx_client-parser 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9a19428165fe743e2ded03fa6d12e5c8bdf7ea92
+  data.tar.gz: 530eeaf7d2f3a9b5bc7182898cf8f51fb3f7d02b
+SHA512:
+  metadata.gz: ec3b410b561b507bb220dc70ec2c7cef56158a5ec4070543cca5c6f4f3f21b0373e8d55bcf4f94ae6bbb9032e4b92e4de893d504086f24ed7d77f0f57213e247
+  data.tar.gz: 0b45619028fa456b4cfe13c64f99375fbddd7e092f0c8ce0375f1fc9dc07ce515e44b8a67b2573caf4ecd0a4f005671656b6d3992b957977a2cfe86366953b80

data/lib/jmx_client/parser/version.rb

@@ -0,0 +1,5 @@
+module JmxClient
+  class Parser
+    VERSION = '0.0.1'
+  end
+end

data/lib/jmx_client/parser.rb

@@ -0,0 +1,173 @@
+# Interface for parsing cmdline-jmxclient output into usable Ruby objects.
+# Reads cmdline-jmxclient output and returns a Ruby hash.
+#
+# Result looks like:
+# {
+#   'ThreadCount' => '45',
+#   'HeapMemoryUsage' => {
+#     'committed' => '224...',
+#     'init' => '167...',
+#     'max' => '259...',
+#     'used' => '145...'
+#   }
+# }
+#
+module JmxClient
+
+  class Parser
+
+    MULTILINE_FIRST = %r(^
+      [0-9/]+\s+    # Matches calendar day, like 12/12/2013.
+      [0-9:]+\s+    # Matches timestamp, like 19:11:28.
+      [-+0-9]+\s+   # Matches timezone, like +0800 or -0700.
+      [a-zA-Z.]+\s+ # Matches Java Bean name, like org.archive.jmx.Client.
+      \w+:\s*\n     # Matches Bean attribute, like ThreadCount:.
+    )x
+    MULTILINE_LAST = /^\s*$/
+    MULTILINE_DATA = /^[a-zA-Z]+?: .+$/
+
+    def self.parse(cmd_output)
+      self.new.parse(cmd_output)
+    end
+
+    def parse(cmd_output)
+      parse_all_output(cmd_output)
+    end
+
+    private
+
+      def parse_all_output(cmd_output, formatted_output = {})
+        if cmd_output.nil? || cmd_output.empty?
+          return formatted_output
+        elsif single_line?(cmd_output)
+          remaining, formatted = parse_single_line(cmd_output)
+          return parse_all_output(remaining, formatted_output.merge(formatted))
+        elsif multiline?(cmd_output)
+          remaining, formatted = parse_multiple_lines(cmd_output)
+          return parse_all_output(remaining, formatted_output.merge(formatted))
+        end
+      end
+
+      def single_line?(output)
+        regex = %r(^
+          [0-9/]+\s+    # Matches calendar day, like 12/12/2013.
+          [0-9:]+\s+    # Matches timestamp, like 19:11:28.
+          [-+0-9]+\s+   # Matches timezone, like +0800 or -0700.
+          [a-zA-Z.]+\s+ # Matches Java Bean name, like org.archive.jmx.Client.
+          \w+:\s+       # Matches Bean attribute, like ThreadCount:.
+          [0-9a-zA-Z]+$ # Matches Bean attribute value.
+        )x
+        output.chomp.match(regex)
+      end
+
+      def multiline?(output)
+        output.match(MULTILINE_FIRST)
+      end
+
+      # cmd_output looks like:
+      # 12/12/2013 19:11:28 +0000 org.archive.jmx.Client ThreadCount: 45
+      #
+      # Output:
+      # [
+      #   <cmd_output, less the first line>
+      #   <Ruby hash representation of first line of cmd_output>
+      # ]
+      #
+      def parse_single_line(cmd_output)
+        _, _, _, bean, attribute, value = split_single_line(cmd_output)
+        [
+          drop_first_line(cmd_output),
+          { attribute => value.chomp }
+        ]
+      end
+
+      # cmd_output looks like:
+      # 12/12/2013 19:11:28 +0000 org.archive.jmx.Client ThreadCount: 45
+      #
+      def split_single_line(cmd_output)
+        date, time, timezone, bean, attribute, value = cmd_output.split(' ')
+        if value.nil?
+          [date, time, timezone, bean, attribute[0..-2]]
+        else
+          [date, time, timezone, bean, attribute[0..-2], value.chomp]
+        end
+      end
+
+      def drop_first_line(cmd_output)
+        cmd_output.split("\n").drop(1).join("\n")
+      end
+
+      def first_line?(output_line)
+        output_line.match(MULTILINE_FIRST)
+      end
+
+      def data_line?(output_line)
+        !output_line.match(MULTILINE_FIRST) && output_line.match(MULTILINE_DATA)
+      end
+
+      def last_line?(output_line)
+        output_line.match(MULTILINE_LAST)
+      end
+
+      # cmd_output looks like:
+      # 12/12/2013 19:11:19 +0000 org.archive.jmx.Client HeapMemoryUsage:
+      # committed: 22429696
+      # init: 16777216
+      # max: 259522560
+      # used: 14500760
+      #
+      # 12/12/2013 19:11:19 +0000 org.archive.jmx.Client NonHeapMemoryUsage:
+      # committed: 25886720
+      # init: 12746752
+      # max: 100663296
+      # used: 25679472
+      #
+      # Result is like:
+      # {
+      #   'HeapMemoryUsage' => {
+      #     committed: '2242...',
+      #     init: '167...',
+      #     max: '259...',
+      #     used: '145...'
+      #   },
+      #   'NonHeapMemoryUsage' => {
+      #     'committed' => '258...',
+      #     'init' => '127...',
+      #     'max' => '100...',
+      #     'used: '256...'
+      #   }
+      # }
+      #
+      # #parse_multiple_lines returns an array:
+      # [
+      #   <unconsumed portion of cmd_output>,
+      #   <formatted output from consumed portion of cmd_output>
+      # ]
+      #
+      def parse_multiple_lines(cmd_output)
+        report = {}
+        current_attribute = nil
+
+        cmd_output.each_line do |line|
+          case
+            when first_line?(line)
+              _, _, _, bean, attribute, _ = split_single_line(line)
+              report[attribute] = {}
+              current_attribute = attribute
+            when data_line?(line)
+              next if current_attribute.nil?
+              sub_attribute, value = line.split(' ')
+              sub_attribute = sub_attribute[0..-2] # Drop the trailing ':'
+              value = value.chomp
+              report[current_attribute][sub_attribute] = value
+            when last_line?(line)
+              current_attribute = nil
+          end
+        end
+
+        ["", report]
+      end
+
+  end
+
+end

metadata

@@ -0,0 +1,87 @@
+--- !ruby/object:Gem::Specification
+name: jmx_client-parser
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Aaron Oman
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-12-18 00:00:00.000000000 Z
+dependencies:
+- !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'
+- !ruby/object:Gem::Dependency
+  name: debugger
+  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: Utility to parse cmdline-jmxclient output into Ruby hash data.
+email:
+- aaron@unbounce.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/jmx_client/parser.rb
+- lib/jmx_client/parser/version.rb
+homepage: https://github.com/GrooveStomp/jmx_client-parser
+licenses: []
+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.0.3
+signing_key: 
+specification_version: 4
+summary: Utility to parse cmdline-jmxclient output into Ruby hash data.
+test_files: []