nasl 0.0.6 → 0.0.7

data/README.md

@@ -0,0 +1,107 @@
+Installation
+============
+
+Git
+---
+
+Installing the source from Git is done as follows:
+
+    git clone git://github.com/tenable/nasl.git
+
+Gem
+---
+
+Installing the package from RubyGems is done as follows:
+
+    gem install nasl
+
+Usage
+=====
+
+Standalone
+----------
+
+To avoid conflicting with the NASL interpreter, the NASL gem's binary is
+installed as <nasl-parse>. As an application, it has very few actions that it
+can perform.
+
+# Benchmark: This benchmarks the time taken to parse the input path(s) over a
+  number of iterations. The number of iterations can be adjusted by the <-i>
+  switch.
+
+    % nasl-parse -i 10 benchmark /opt/nessus/lib/nessus/plugins/ssl_certificate_chain.nasl
+    -------------------------[ ssl_certificate_chain.nasl ]-------------------------
+    Rehearsal --------------------------------------------
+    Tokenize   1.687500   0.000000   1.687500 (  1.688397)
+    Parse      1.835938   0.015625   1.851562 (  1.857094)
+    ----------------------------------- total: 3.539062sec
+
+                   user     system      total        real
+    Tokenize   1.304688   0.015625   1.320312 (  1.319951)
+    Parse      1.046875   0.000000   1.046875 (  1.046957)
+    -------------------------[ ssl_certificate_chain.nasl ]-------------------------
+
+# Parse: This parses the input path(s) and indicates whether the parse was
+  successful.
+
+    % nasl-parse parse /opt/nessus/lib/nessus/plugins/ssl_certificate_chain.nasl
+    -------------------------[ ssl_certificate_chain.nasl ]-------------------------
+    Successfully parsed the contents of the file.
+    -------------------------[ ssl_certificate_chain.nasl ]-------------------------
+
+# Test: This runs unit tests distributed with the application. Specific unit
+  tests can be specified on the command line, otherwise all tests will be run.
+
+    % nasl-parse test
+    Run options:
+    
+    # Running tests:
+    
+    .............................................................................
+    
+    Finished tests in 11.773983s, 6.5398 tests/s, 33493.8487 assertions/s.
+    
+    77 tests, 394356 assertions, 0 failures, 0 errors, 0 skips
+
+# Tokenize: This tokenizes the input path(s) and prints the token/byte-range
+  pairs to stdout.
+
+    % nasl-parse tokenize /opt/nessus/lib/nessus/plugins/ssl_certificate_chain.nasl
+    -------------------------[ ssl_certificate_chain.nasl ]-------------------------
+    [COMMENT,              0...1076]
+    [IF,                1076...1079]
+    [LPAREN,            1079...1080]
+    [IDENT,             1080...1091]
+    [CMP_LT,            1091...1093]
+    ...
+    -------------------------[ ssl_certificate_chain.nasl ]-------------------------
+
+# XML: This parses the input path(s), and then prints an XML representation of
+  the parse tree to stdout.
+
+    % nasl-parse xml /opt/nessus/lib/nessus/plugins/ssl_certificate_chain.nasl
+    -------------------------[ ssl_certificate_chain.nasl ]-------------------------
+    <tree>
+      <if>
+        <expression>
+          <op>&lt;</op>
+          <lvalue>
+    ...
+    -------------------------[ ssl_certificate_chain.nasl ]-------------------------
+
+Library
+-------
+
+The primary users of this gem are [Pedant][pedant] and [Nasldoc][nasldoc]. Other
+uses are encouraged, of course! The <Parser> class is the most useful part,
+obviously, and can be used as follows:
+
+    require 'nasl'
+
+    tree = Nasl::Parser.new.parse(file_contents, path_to_file)
+
+That's all there is to it. If there are any errors, it'll throw an instance of
+<ParseException> that will include as much context about the error as possible.
+
+[nasldoc]: https://github.com/tenable/nasldoc
+[pedant]: https://github.com/tenable/pedant

data/Rakefile

@@ -1,8 +1,27 @@
+$LOAD_PATH.unshift File.expand_path("../lib", __FILE__)
+
 require 'bundler/gem_tasks'
+require 'rake'
+require 'rake/clean'
 require 'rake/testtask'
 
 Rake::TestTask.new do |t|
   t.libs << 'test'
-  t.test_files = FileList['test/**/test*.rb']
-  t.verbose = true
+  t.test_files = FileList['test/**/test_*.rb']
+end
+
+rule(%r{\.tab\.rb$} => lambda { |f| f.sub(/\.tab.rb/, '.racc') }) do |t|
+  sh "racc #{t.source}"
+end
+
+desc "Generate grammar modules from Racc source."
+task :grammars => FileList['**/*.racc'].ext('.tab.rb')
+
+desc "Produce a fully-functional application."
+task :compile => [:grammars, :test]
+
+task :build => :compile do
+  system "gem build nasl.gemspec"
 end
+
+task :default => :compile

data/lib/nasl/cli.rb

@@ -86,6 +86,7 @@ module Nasl
       puts "    benchmark   Benchmarks the parsing of the input path(s)."
       puts "    parse       Parses the input path(s)."
       puts "    test        Runs the specified unit tests, all are selected by default."
+      puts "    tokenize    Tokenizes the input path(s)."
       puts "    xml         Parses the input path(s) and displays them as XML."
     end
   end

data/lib/nasl/command.rb

@@ -89,7 +89,11 @@ module Nasl
       if self.respond_to? :analyze_all then
         analyze_all(cfg, dirents, args)
       else
-        dirents.each { |d| analyze(cfg, d, args) }
+        dirents.each do |d|
+          puts banner(d.basename)
+          analyze(cfg, d, args)
+          puts banner(d.basename)
+        end
       end
     end
   end

data/lib/nasl/commands/benchmark.rb

@@ -33,23 +33,19 @@ module Nasl
     end
 
     def self.analyze(cfg, path, args)
-      puts banner(path.basename)
-
       Benchmark.bmbm do |b|
         # Read in the file outside of the benchmark, to avoid contaminating it
         # with filesystem operations.
         contents = File.open(path, "rb").read
 
         b.report("Tokenize") do
-          cfg[:iterations].times { Tokenizer.new(contents).get_all }
+          cfg[:iterations].times { Tokenizer.new(contents, path).get_tokens }
         end
 
-        #b.report("Parse") do
-        #  cfg[:iterations].times { Parser.new.parse(contents) }
-        #end
+        b.report("Parse") do
+          cfg[:iterations].times { Parser.new.parse(contents) }
+        end
       end
-
-      puts banner(path.basename)
     end
   end
 end

data/lib/nasl/commands/parse.rb

@@ -24,8 +24,6 @@
 # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 ################################################################################
 
-require 'rainbow'
-
 module Nasl
   class CommandParse < Command
     def self.binding
@@ -36,20 +34,20 @@ module Nasl
       begin
         contents = File.open(path, "rb").read
       rescue
-        puts '[' + 'VOID'.color(:magenta) + "] #{path}"
+        puts "Failed to read in the contents of the file."
         return
       end
 
       begin
         Parser.new.parse(contents, path)
       rescue Exception => e
-        puts '[' + 'FAIL'.color(:red) + "] #{path}"
+        puts "Failed to parse the contents of the file."
         puts e.message
         puts e.backtrace
         return
       end
 
-      puts '[' + 'PASS'.color(:green) + "] #{path}"
+      puts "Successfully parsed the contents of the file."
     end
   end
 end

data/lib/nasl/commands/tokenize.rb

@@ -34,7 +34,9 @@ module Nasl
       contents = File.open(path, "rb").read
 
       begin
-        Tokenizer.new(contents, path).get_tokens
+        Tokenizer.new(contents, path).get_tokens.each do |t|
+          puts "[#{(t.first.to_s + ',').ljust(10)}#{t.last.region.to_s.rjust(20)}]"
+        end
       rescue TokenException => e
         puts "The tokenizer raised the following exceptions when processing #{path}:"
         puts e.message

data/lib/nasl/commands/xml.rb

@@ -32,10 +32,7 @@ module Nasl
 
     def self.analyze(cfg, path, args)
       contents = File.open(path, "rb").read
-
-      puts banner(path.basename)
       puts Parser.new.parse(contents).to_s
-      puts banner(path.basename)
     end
   end
 end

data/lib/nasl/grammar.racc

@@ -151,7 +151,7 @@ rule
   ##############################################################################
 
   assign     : assign_exp SEMICOLON
-             { n(:Assignment, *val[0], val[1]) }
+             { val[0] }
              ;
 
   break      : BREAK SEMICOLON
@@ -159,7 +159,7 @@ rule
              ;
 
   call       : call_exp SEMICOLON
-             { n(:Call, *val[0], val[1]) }
+             { val[0] }
              ;
 
   continue   : CONTINUE SEMICOLON
@@ -167,7 +167,7 @@ rule
              ;
 
   decr       : decr_exp SEMICOLON
-             { n(:Decrement, *val[0], val[1]) }
+             { val[0] }
              ;
 
   empty      : SEMICOLON
@@ -179,7 +179,7 @@ rule
              ;
 
   incr       : incr_exp SEMICOLON
-             { n(:Increment, *val[0], val[1]) }
+             { val[0] }
              ;
 
   import     : IMPORT LPAREN string RPAREN SEMICOLON
@@ -195,7 +195,7 @@ rule
              ;
 
   rep        : call_exp REP expr SEMICOLON
-             { n(:Repetition, n(:Call, *val[0]), *val[1..-1]) }
+             { n(:Repetition, n(:Call, val[0]), *val[1..-1]) }
              ;
 
   return     : RETURN expr SEMICOLON
@@ -241,40 +241,40 @@ rule
   ##############################################################################
 
   assign_exp : lval ASS_EQ expr
-             { val }
+             { n(:Assignment, *val) }
              | lval ADD_EQ expr
-             { val }
+             { n(:Assignment, *val) }
              | lval SUB_EQ expr
-             { val }
+             { n(:Assignment, *val) }
              | lval MUL_EQ expr
-             { val }
+             { n(:Assignment, *val) }
              | lval DIV_EQ expr
-             { val }
+             { n(:Assignment, *val) }
              | lval MOD_EQ expr
-             { val }
+             { n(:Assignment, *val) }
              | lval SRL_EQ expr
-             { val }
+             { n(:Assignment, *val) }
              | lval SRA_EQ expr
-             { val }
+             { n(:Assignment, *val) }
              | lval SLL_EQ expr
-             { val }
+             { n(:Assignment, *val) }
              ;
 
   call_exp   : ident LPAREN args RPAREN
-             { val }
+             { n(:Call, *val) }
              | ident LPAREN RPAREN
-             { val }
+             { n(:Call, *val) }
 
   decr_exp   : DECR lval
-             { val }
+             { n(:Decrement, val[0]) }
              | lval DECR
-             { val }
+             { n(:Decrement, val[0]) }
              ;
 
   incr_exp   : INCR lval
-             { val }
+             { n(:Increment, val[0]) }
              | lval INCR
-             { val }
+             { n(:Increment, val[0]) }
              ;
 
   expr       : LPAREN expr RPAREN
@@ -314,9 +314,9 @@ rule
              | expr BIT_SLL expr
              { n(:Expression, *val) }
              | incr_exp
-             { n(:Increment, *val[0]) }
+             { val[0] }
              | decr_exp
-             { n(:Decrement, *val[0]) }
+             { val[0] }
              | expr SUBSTR_EQ expr
              { n(:Expression, *val) }
              | expr SUBSTR_NE expr
@@ -338,11 +338,11 @@ rule
              | expr CMP_LE expr
              { n(:Expression, *val) }
              | assign_exp
-             { n(:Assignment, *val[0]) }
+             { val[0] }
              | string
              { val[0] }
              | call_exp
-             { n(:Call, *val[0]) }
+             { val[0] }
              | lval
              { val[0] }
              | ip

data/lib/nasl/parser/argument.rb

@@ -43,8 +43,9 @@ module Nasl
         @type = :anonymous
       end
 
-      @attributes << :name
-      @attributes << :expr
+      @attributes << :type
+      @children << :name
+      @children << :expr
     end
   end
 end

data/lib/nasl/parser/assigment.rb

@@ -37,9 +37,9 @@ module Nasl
       @op = @tokens[1]
       @expr = @tokens[2]
 
-      @attributes << :op
-      @attributes << :lval
-      @attributes << :expr
+      @children << :op
+      @children << :lval
+      @children << :expr
     end
   end
 end

data/lib/nasl/parser/block.rb

@@ -35,7 +35,7 @@ module Nasl
 
       @body = if @tokens.length == 3 then @tokens[1] else [] end
 
-      @attributes << :body
+      @children << :body
     end
   end
 end

data/lib/nasl/parser/break.rb

@@ -1,4 +1,4 @@
-################################################################################
+!################################################################################
 # Copyright (c) 2011-2012, Mak Kolybabi
 # All rights reserved.
 #

data/lib/nasl/parser/call.rb

@@ -41,8 +41,8 @@ module Nasl
         @arg[a.name.name] = a.expr
       end
 
-      @attributes << :name
-      @attributes << :args
+      @children << :name
+      @children << :args
     end
   end
 end

data/lib/nasl/parser/comment.rb

@@ -1,4 +1,4 @@
-################################################################################
+!################################################################################
 # Copyright (c) 2011-2012, Mak Kolybabi
 # All rights reserved.
 #

data/lib/nasl/parser/continue.rb

@@ -1,4 +1,4 @@
-################################################################################
+!################################################################################
 # Copyright (c) 2011-2012, Mak Kolybabi
 # All rights reserved.
 #

data/lib/nasl/parser/decrement.rb

@@ -41,8 +41,8 @@ module Nasl
         @ident = @tokens[1]
       end
 
-      @attributes << :ident
-      @attributes << :type
+      @children << :ident
+      @children << :type
     end
   end
 end

data/lib/nasl/parser/empty.rb

@@ -1,4 +1,4 @@
-################################################################################
+!################################################################################
 # Copyright (c) 2011-2012, Mak Kolybabi
 # All rights reserved.
 #

data/lib/nasl/parser/export.rb

@@ -35,7 +35,7 @@ module Nasl
 
       @function = @tokens[1]
 
-      @attributes << :function
+      @children << :function
     end
   end
 end

data/lib/nasl/parser/expression.rb

@@ -33,7 +33,7 @@ module Nasl
     def initialize(tree, *tokens)
       super
 
-      @attributes << :op
+      @children << :op
 
       if @tokens.first.is_a?(Token) && @tokens.first.type == :LPAREN
         @op = '()'
@@ -44,13 +44,13 @@ module Nasl
         @lhs = nil
         @rhs = @tokens.last
       else
-        @attributes << :lhs
+        @children << :lhs
         @lhs = @tokens[0]
         @op = @tokens[1]
         @rhs = @tokens[2]
       end
 
-      @attributes << :rhs
+      @children << :rhs
     end
   end
 end

data/lib/nasl/parser/for.rb

@@ -1,4 +1,4 @@
-################################################################################
+!################################################################################
 # Copyright (c) 2011-2012, Mak Kolybabi
 # All rights reserved.
 #
@@ -38,10 +38,10 @@ module Nasl
       @each = @tokens[6]
       @body = @tokens[8]
 
-      @attributes << :init
-      @attributes << :cond
-      @attributes << :each
-      @attributes << :body
+      @children << :init
+      @children << :cond
+      @children << :each
+      @children << :body
     end
   end
 end

data/lib/nasl/parser/foreach.rb

@@ -37,9 +37,9 @@ module Nasl
       @expr = @tokens[3]
       @body = @tokens[5]
 
-      @attributes << :iter
-      @attributes << :expr
-      @attributes << :body
+      @children << :iter
+      @children << :expr
+      @children << :body
     end
   end
 end

data/lib/nasl/parser/function.rb

@@ -37,9 +37,9 @@ module Nasl
       @params = if @tokens.length == 6 then @tokens[3] else [] end
       @body = @tokens.last
 
-      @attributes << :name
-      @attributes << :params
-      @attributes << :body
+      @children << :name
+      @children << :params
+      @children << :body
     end
   end
 end

data/lib/nasl/parser/global.rb

@@ -35,7 +35,7 @@ module Nasl
 
       @idents = @tokens[1]
 
-      @attributes << :idents
+      @children << :idents
     end
   end
 end

data/lib/nasl/parser/identifier.rb

@@ -1,4 +1,4 @@
-################################################################################
+!################################################################################
 # Copyright (c) 2011-2012, Mak Kolybabi
 # All rights reserved.
 #

data/lib/nasl/parser/if.rb

@@ -1,4 +1,4 @@
-################################################################################
+!################################################################################
 # Copyright (c) 2011-2012, Mak Kolybabi
 # All rights reserved.
 #
@@ -37,9 +37,9 @@ module Nasl
       @true = @tokens[4]
       @false = if @tokens.length == 7 then @tokens.last else nil end
 
-      @attributes << :cond
-      @attributes << :true
-      @attributes << :false
+      @children << :cond
+      @children << :true
+      @children << :false
     end
   end
 end

data/lib/nasl/parser/import.rb

@@ -35,7 +35,7 @@ module Nasl
 
       @filename = @tokens[2]
 
-      @attributes << :filename
+      @children << :filename
     end
   end
 end

data/lib/nasl/parser/include.rb

@@ -1,4 +1,4 @@
-################################################################################
+!################################################################################
 # Copyright (c) 2011-2012, Mak Kolybabi
 # All rights reserved.
 #
@@ -35,7 +35,7 @@ module Nasl
 
       @filename = @tokens[2]
 
-      @attributes << :filename
+      @children << :filename
     end
   end
 end

data/lib/nasl/parser/increment.rb

@@ -41,8 +41,8 @@ module Nasl
         @ident = @tokens[1]
       end
 
-      @attributes << :ident
-      @attributes << :type
+      @children << :ident
+      @children << :type
     end
   end
 end

data/lib/nasl/parser/integer.rb

@@ -1,4 +1,4 @@
-################################################################################
+!################################################################################
 # Copyright (c) 2011-2012, Mak Kolybabi
 # All rights reserved.
 #

data/lib/nasl/parser/ip.rb

@@ -1,4 +1,4 @@
-################################################################################
+!################################################################################
 # Copyright (c) 2011-2012, Mak Kolybabi
 # All rights reserved.
 #

data/lib/nasl/parser/local.rb

@@ -35,7 +35,7 @@ module Nasl
 
       @idents = @tokens[1]
 
-      @attributes << :idents
+      @children << :idents
     end
   end
 end

data/lib/nasl/parser/lvalue.rb

@@ -36,8 +36,8 @@ module Nasl
       @ident = @tokens.first
       @indexes = if @tokens.length == 2 then tokens.last else [] end
 
-      @attributes << :ident
-      @attributes << :indexes
+      @children << :ident
+      @children << :indexes
     end
   end
 end

data/lib/nasl/parser/node.rb

@@ -32,9 +32,9 @@ module Nasl
       # Register new node in the tree.
       tree.register(self)
 
-      # Create the attributes array which is used for converting the parse tree
-      # to XML.
+      # Create the arrays which are used for converting the parse tree to XML.
       @attributes = []
+      @children = []
 
       # Store all of the tokens that made up this node.
       @tokens = tokens
@@ -56,22 +56,25 @@ module Nasl
       name = self.class.name.split('::').last
       name = name.gsub(/(.)([A-Z])/, '\1_\2').downcase
 
+      # Create a hash from the attribute array.
+      attr = Hash[@attributes.map{ |el| [el, self.send(el)] }]
+
       # If there are no attributes, make a modified opening tag.
-      return xml.tag!(name) if @attributes.empty?
+      return xml.tag!(name, attr) if @children.empty?
 
       # Create the tag representing this node.
-      xml.tag!(name) do
-        @attributes.each do |name|
+      xml.tag!(name, attr) do
+        @children.each do |name|
           # Retrieve the object that the symbol indicates.
           obj = self.send(name)
 
-          # Skip over unused attributes.
+          # Skip over empty children.
           next if obj.nil?
 
           # Handle objects that are arrays holding nodes, or basic types that
           # aren't nodes.
           if obj.is_a? Array
-            obj.each { |node| node.to_xml(xml) }
+            obj.each { |el| el.to_xml(xml) }
           elsif obj.is_a? Node
             obj.to_xml(xml)
           else

data/lib/nasl/parser/repeat.rb

@@ -36,8 +36,8 @@ module Nasl
       @body = @tokens[1]
       @cond = @tokens[3]
 
-      @attributes << :body
-      @attributes << :cond
+      @children << :body
+      @children << :cond
     end
   end
 end

data/lib/nasl/parser/repetition.rb

@@ -36,8 +36,8 @@ module Nasl
       @call = tokens[0]
       @expr = tokens[2]
 
-      @attributes << :call
-      @attributes << :expr
+      @children << :call
+      @children << :expr
     end
   end
 end

data/lib/nasl/parser/return.rb

@@ -35,7 +35,7 @@ module Nasl
 
       @expr = if @tokens.length == 3 then @tokens[1] else nil end
 
-      @attributes << :expr
+      @children << :expr
     end
   end
 end

data/lib/nasl/parser/string.rb

@@ -1,4 +1,4 @@
-################################################################################
+!################################################################################
 # Copyright (c) 2011-2012, Mak Kolybabi
 # All rights reserved.
 #
@@ -38,11 +38,7 @@ module Nasl
     end
 
     def to_xml(xml)
-      if @type == :DATA
-        xml.data(@text)
-      else
-        xml.string(@text)
-      end
+      xml.method_missing(@type.downcase, @text)
     end
   end
 end

data/lib/nasl/parser/undefined.rb

@@ -1,4 +1,4 @@
-################################################################################
+!################################################################################
 # Copyright (c) 2011-2012, Mak Kolybabi
 # All rights reserved.
 #

data/lib/nasl/parser/while.rb

@@ -36,8 +36,8 @@ module Nasl
       @cond = @tokens[2]
       @body = @tokens[4]
 
-      @attributes << :cond
-      @attributes << :body
+      @children << :cond
+      @children << :body
     end
   end
 end

data/lib/nasl/version.rb

@@ -1,3 +1,3 @@
 module Nasl
-  VERSION = '0.0.6'
+  VERSION = '0.0.7'
 end

data/nasl.gemspec

@@ -1,25 +1,29 @@
 # -*- encoding: utf-8 -*-
 $:.push File.expand_path('../lib', __FILE__)
+
 require 'nasl/version'
 
 Gem::Specification.new do |s|
   s.name        = 'nasl'
   s.version     = Nasl::VERSION
+  s.license     = "BSD"
+  s.homepage    = 'http://github.com/tenable/nasl'
+  s.summary     = 'A parser for the Nessus Attack Scripting Language.'
+  s.description = File.open('README.md').read
+
   s.authors     = ['Mak Kolybabi']
   s.email       = ['mak@kolybabi.com']
-  s.homepage    = 'http://github.com/mogigoma/nasl'
-  s.summary     = %q{A parser for the Nessus Attack Scripting Language.}
 
   s.rubyforge_project = 'nasl'
 
-  s.files         = `git ls-files`.split("\n") + ['lib/nasl/grammar.tab.rb']
-  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.files         = `git ls-files`.split("\n") + Dir.glob('**/*.tab.rb')
+  s.test_files    = `git ls-files -- test/*`.split("\n")
   s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   s.require_paths = ['lib']
 
+  s.add_development_dependency 'racc'
   s.add_development_dependency 'rake'
 
   s.add_runtime_dependency 'builder'
-  s.add_runtime_dependency 'racc'
   s.add_runtime_dependency 'rainbow'
 end

data/test/unit/parser/test_assignment.rb

@@ -37,7 +37,7 @@ class TestAssignment < Test::Unit::TestCase
   def test_string
     same(
       "q = '';",
-      '<tree><assignment><op>=</op><lvalue><identifier name="q"/></lvalue><data></data></assignment></tree>'
+      '<tree><assignment><op>=</op><lvalue><identifier name="q"/></lvalue><data/></assignment></tree>'
     )
     same(
       "q = 'foo';",
@@ -45,7 +45,7 @@ class TestAssignment < Test::Unit::TestCase
     )
     same(
       'q = "";',
-      '<tree><assignment><op>=</op><lvalue><identifier name="q"/></lvalue><string></string></assignment></tree>'
+      '<tree><assignment><op>=</op><lvalue><identifier name="q"/></lvalue><string/></assignment></tree>'
     )
     same(
       'q = "foo";',

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nasl
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.7
   prerelease: 
 platform: ruby
 authors:
@@ -9,10 +9,10 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-09-17 00:00:00.000000000 Z
+date: 2012-10-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: racc
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
@@ -28,14 +28,14 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: builder
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-  type: :runtime
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
@@ -44,7 +44,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: racc
+  name: builder
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
@@ -75,7 +75,48 @@ dependencies:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-description: 
+description: ! "Installation\n============\n\nGit\n---\n\nInstalling the source from
+  Git is done as follows:\n\n    git clone git://github.com/tenable/nasl.git\n\nGem\n---\n\nInstalling
+  the package from RubyGems is done as follows:\n\n    gem install nasl\n\nUsage\n=====\n\nStandalone\n----------\n\nTo
+  avoid conflicting with the NASL interpreter, the NASL gem's binary is\ninstalled
+  as <nasl-parse>. As an application, it has very few actions that it\ncan perform.\n\n#
+  Benchmark: This benchmarks the time taken to parse the input path(s) over a\n  number
+  of iterations. The number of iterations can be adjusted by the <-i>\n  switch.\n\n
+  \   % nasl-parse -i 10 benchmark /opt/nessus/lib/nessus/plugins/ssl_certificate_chain.nasl\n
+  \   -------------------------[ ssl_certificate_chain.nasl ]-------------------------\n
+  \   Rehearsal --------------------------------------------\n    Tokenize   1.687500
+  \  0.000000   1.687500 (  1.688397)\n    Parse      1.835938   0.015625   1.851562
+  (  1.857094)\n    ----------------------------------- total: 3.539062sec\n\n                   user
+  \    system      total        real\n    Tokenize   1.304688   0.015625   1.320312
+  (  1.319951)\n    Parse      1.046875   0.000000   1.046875 (  1.046957)\n    -------------------------[
+  ssl_certificate_chain.nasl ]-------------------------\n\n# Parse: This parses the
+  input path(s) and indicates whether the parse was\n  successful.\n\n    % nasl-parse
+  parse /opt/nessus/lib/nessus/plugins/ssl_certificate_chain.nasl\n    -------------------------[
+  ssl_certificate_chain.nasl ]-------------------------\n    Successfully parsed the
+  contents of the file.\n    -------------------------[ ssl_certificate_chain.nasl
+  ]-------------------------\n\n# Test: This runs unit tests distributed with the
+  application. Specific unit\n  tests can be specified on the command line, otherwise
+  all tests will be run.\n\n    % nasl-parse test\n    Run options:\n    \n    # Running
+  tests:\n    \n    .............................................................................\n
+  \   \n    Finished tests in 11.773983s, 6.5398 tests/s, 33493.8487 assertions/s.\n
+  \   \n    77 tests, 394356 assertions, 0 failures, 0 errors, 0 skips\n\n# Tokenize:
+  This tokenizes the input path(s) and prints the token/byte-range\n  pairs to stdout.\n\n
+  \   % nasl-parse tokenize /opt/nessus/lib/nessus/plugins/ssl_certificate_chain.nasl\n
+  \   -------------------------[ ssl_certificate_chain.nasl ]-------------------------\n
+  \   [COMMENT,              0...1076]\n    [IF,                1076...1079]\n    [LPAREN,
+  \           1079...1080]\n    [IDENT,             1080...1091]\n    [CMP_LT,            1091...1093]\n
+  \   ...\n    -------------------------[ ssl_certificate_chain.nasl ]-------------------------\n\n#
+  XML: This parses the input path(s), and then prints an XML representation of\n  the
+  parse tree to stdout.\n\n    % nasl-parse xml /opt/nessus/lib/nessus/plugins/ssl_certificate_chain.nasl\n
+  \   -------------------------[ ssl_certificate_chain.nasl ]-------------------------\n
+  \   <tree>\n      <if>\n        <expression>\n          <op>&lt;</op>\n          <lvalue>\n
+  \   ...\n    -------------------------[ ssl_certificate_chain.nasl ]-------------------------\n\nLibrary\n-------\n\nThe
+  primary users of this gem are [Pedant][pedant] and [Nasldoc][nasldoc]. Other\nuses
+  are encouraged, of course! The <Parser> class is the most useful part,\nobviously,
+  and can be used as follows:\n\n    require 'nasl'\n\n    tree = Nasl::Parser.new.parse(file_contents,
+  path_to_file)\n\nThat's all there is to it. If there are any errors, it'll throw
+  an instance of\n<ParseException> that will include as much context about the error
+  as possible.\n\n[nasldoc]: https://github.com/tenable/nasldoc\n[pedant]: https://github.com/tenable/pedant\n"
 email:
 - mak@kolybabi.com
 executables:
@@ -85,6 +126,7 @@ extra_rdoc_files: []
 files:
 - .gitignore
 - Gemfile
+- README.md
 - Rakefile
 - bin/nasl-parse
 - lib/nasl.rb
@@ -158,8 +200,9 @@ files:
 - test/unit/tokenizer/test_integer.rb
 - test/unit/tokenizer/test_string.rb
 - lib/nasl/grammar.tab.rb
-homepage: http://github.com/mogigoma/nasl
-licenses: []
+homepage: http://github.com/tenable/nasl
+licenses:
+- BSD
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -170,16 +213,44 @@ required_ruby_version: !ruby/object:Gem::Requirement
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
+      hash: -1091891794194809699
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
+      hash: -1091891794194809699
 requirements: []
 rubyforge_project: nasl
 rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: A parser for the Nessus Attack Scripting Language.
-test_files: []
+test_files:
+- test/test_helper.rb
+- test/unit/parser/test_assignment.rb
+- test/unit/parser/test_blank.rb
+- test/unit/parser/test_block.rb
+- test/unit/parser/test_call.rb
+- test/unit/parser/test_comment.rb
+- test/unit/parser/test_constant.rb
+- test/unit/parser/test_empty.rb
+- test/unit/parser/test_expressions.rb
+- test/unit/parser/test_function.rb
+- test/unit/parser/test_if.rb
+- test/unit/parser/test_include.rb
+- test/unit/parser/test_incr_decr.rb
+- test/unit/parser/test_ip.rb
+- test/unit/parser/test_return.rb
+- test/unit/parser/test_string.rb
+- test/unit/parser/test_whitespace.rb
+- test/unit/test_context.rb
+- test/unit/tokenizer/test_comment.rb
+- test/unit/tokenizer/test_empty.rb
+- test/unit/tokenizer/test_integer.rb
+- test/unit/tokenizer/test_string.rb