webidl 0.0.1

data/.autotest

@@ -0,0 +1,9 @@
+require "autotest/redgreen"
+
+class Autotest
+
+  def tests_for_file(filename)
+    return Dir["spec/**/*_spec.rb"]
+  end
+
+end

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,5 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Jari Bakken
+
+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.rdoc

@@ -0,0 +1,31 @@
+= webidl
+
+This gem provides a pure-ruby parser and code generator for Web IDL, an interface description language for interfaces intended to be implemented in web browsers.
+The code generation will be used to generate part of the implementation of Watir 2.0, backed by WebDriver.
+
+= Problems
+
+The code generation could be improved a lot - a lot of the data in the IDL is just ignored. I don't need anything more ATM, but it should be easy to complete it if anyone needs to.
+
+The parser rules for ExtendedAttribute is not exactly like the grammar from the Web IDL spec, since I ran into infinite recursion issues and don't have the Treetop-fu to figure them out.
+So far this hasn't led to any problems - the parser does parse the IDLs parts of the current HTML5 spec just fine.
+
+= See also
+
+http://dev.w3.org/2006/webapi/WebIDL/
+http://dev.w3.org/2006/webapi/WebIDL/#idl-grammar
+http://dev.w3.org/html5/spec/Overview.html
+
+== Note on Patches/Pull Requests
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2009 Jari Bakken. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,65 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name        = "webidl"
+    gem.summary     = %Q{WebIDL parser/generator for ruby}
+    gem.description = %Q{Built on Treetop, this gem will parse an interface declaration in WebIDL and generate ruby code}
+    gem.email       = "jari.bakken@gmail.com"
+    gem.homepage    = "http://github.com/jarib/webidl"
+    gem.authors     = ["Jari Bakken"]
+    gem.bindir      = "bin"
+
+    gem.add_dependency "treetop"
+    gem.add_dependency "ruby2ruby"
+    gem.add_development_dependency "rspec"
+  end
+  
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern   = 'spec/**/*_spec.rb'
+  spec.rcov      = true
+  spec.rcov_opts = %w[--exclude spec,ruby-debug,/Library/Ruby,.gem --include lib/webidl]
+end
+
+namespace :parser do
+  task :compile do
+    require 'treetop'
+    compiler = Treetop::Compiler::GrammarCompiler.new
+    treetop_dir = File.expand_path(File.join(File.dirname(__FILE__), "lib", "webidl", "parser"))
+    Dir[File.join(treetop_dir, "*.{tt,treetop}")].each do |treetop_file_path|
+      compiler.compile(treetop_file_path)
+    end
+  end
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION')
+    version = File.read('VERSION')
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "webidl #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/bin/webidl2ruby

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.unshift File.expand_path(File.join(File.dirname(__FILE__), "..", "lib"))
+require "webidl"
+
+if ARGV.empty?
+  $stderr.puts "no files given, reading from stdin.."
+end
+
+puts WebIDL::Generator.new.generate(ARGF.read)
+
+
+

data/examples/html5.rb

@@ -0,0 +1,6 @@
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), '..', "lib")
+
+require "rubygems"
+require "webidl"
+
+puts WebIDL::Generator.new.generate(File.read("#{File.dirname(__FILE__)}/../spec/fixtures/html5.idl"))

data/lib/webidl.rb

@@ -0,0 +1,47 @@
+require "treetop"
+require "ruby2ruby"
+
+require "webidl/extensions/syntax_node"
+require "webidl/extensions/string"
+
+require "webidl/parse_tree/definitions"
+require "webidl/parse_tree/module"
+require "webidl/parse_tree/attribute"
+require "webidl/parse_tree/typedef"
+require "webidl/parse_tree/interface"
+require "webidl/parse_tree/argument"
+require "webidl/parse_tree/argument_list"
+require "webidl/parse_tree/extended_attributes"
+require "webidl/parse_tree/relative_scoped_name"
+require "webidl/parse_tree/absolute_scoped_name"
+require "webidl/parse_tree/nullable_type"
+require "webidl/parse_tree/interface_members"
+require "webidl/parse_tree/operation"
+require "webidl/parse_tree/const"
+require "webidl/parse_tree/specials"
+require "webidl/parse_tree/exception"
+require "webidl/parse_tree/exception_field"
+require "webidl/parse_tree/implements_statement"
+require "webidl/parse_tree/interface_inheritance"
+require "webidl/parse_tree/scoped_name_list"
+require "webidl/parse_tree/stringifier_attribute_or_operation"
+
+require "webidl/ast/node"
+require "webidl/ast/module"
+require "webidl/ast/typedef"
+require "webidl/ast/interface"
+require "webidl/ast/extended_attribute"
+require "webidl/ast/argument"
+require "webidl/ast/type"
+require "webidl/ast/scoped_name"
+require "webidl/ast/operation"
+require "webidl/ast/const"
+require "webidl/ast/exception"
+require "webidl/ast/attribute"
+require "webidl/ast/field"
+require "webidl/ast/implements_statement"
+
+require "webidl/parser/debug_helper"
+require "webidl/parser/idl"
+
+require "webidl/generator"

data/lib/webidl/ast/argument.rb

@@ -0,0 +1,25 @@
+module WebIDL
+  module Ast
+    class Argument < Node
+
+      attr_reader :name, :type
+
+      def initialize(name, type, opts = {})
+        @name = name
+        @type = type
+
+        @optional = !!opts[:optional]
+        @variadic = !!opts[:variadic]
+      end
+
+      def optional?
+        @optional
+      end
+
+      def variadic?
+        @variadic
+      end
+
+    end # Argument
+  end # Ast
+end # WebIDL

data/lib/webidl/ast/attribute.rb

@@ -0,0 +1,29 @@
+module WebIDL
+  module Ast
+    class Attribute < Node
+
+      attr_reader :type, :name, :getraises, :setraises
+      attr_accessor :extended_attributes, :stringifier
+
+      def initialize(parent, type, name, opts = {})
+        super(parent)
+
+        @type                = type
+        @name                = name
+        @readonly            = !!opts[:readonly]
+        @setraises           = opts[:setraises] || []
+        @getraises           = opts[:getraises] || []
+        @extended_attributes = opts[:extended_attributes] || []
+      end
+
+      def readonly?
+        @readonly
+      end
+
+      def stringifier?
+        !!@stringifier
+      end
+
+    end # Attribute
+  end # Ast
+end # WebIDL

data/lib/webidl/ast/const.rb

@@ -0,0 +1,17 @@
+module WebIDL
+  module Ast
+    class Const < Node
+
+      attr_reader :type, :name, :value
+
+      def initialize(parent, type, name, value)
+        super(parent)
+
+        @type  = type
+        @name  = name
+        @value = value
+      end
+
+    end # Type
+  end # Ast
+end # WebIDL

data/lib/webidl/ast/exception.rb

@@ -0,0 +1,15 @@
+module WebIDL
+  module Ast
+    class Exception < Node
+      attr_reader :name
+      attr_accessor :members
+
+      def initialize(parent, name)
+        @parent  = parent
+        @name    = name
+        @members = []
+      end
+
+    end # Exception
+  end # Ast
+end # WebIDL

data/lib/webidl/ast/extended_attribute.rb

@@ -0,0 +1,14 @@
+module WebIDL
+  module Ast
+    class ExtendedAttribute < Node
+
+      attr_reader :name, :args
+
+      def initialize(name, args = [])
+        @name = name
+        @args = args
+      end
+
+    end
+  end # Ast
+end # WebIDL

data/lib/webidl/ast/field.rb

@@ -0,0 +1,14 @@
+module WebIDL
+  module Ast
+    class Field < Node
+
+      attr_reader :type, :name
+
+      def initialize(parent, type, name)
+        super(parent)
+        @type, @name = type, name
+      end
+
+    end # Field
+  end # Ast
+end # WebIDL

data/lib/webidl/ast/implements_statement.rb

@@ -0,0 +1,14 @@
+module WebIDL
+  module Ast
+    class ImplementsStatement < Node
+
+      attr_reader :implementor, :implementee
+
+      def initialize(parent, implementor_name, implementee_name)
+        @implementor = implementor_name
+        @implementee = implementee_name
+      end
+
+    end # ImplementsStatement
+  end # Ast
+end # WebIDL

data/lib/webidl/ast/interface.rb

@@ -0,0 +1,24 @@
+module WebIDL
+  module Ast
+    class Interface < Node
+
+      def self.list
+        @list ||= {}
+      end
+
+      attr_reader :name
+      attr_accessor :extended_attributes, :members, :inherits, :implements
+
+      def initialize(parent, name)
+        super(parent)
+
+        @name                = name
+        @members             = []
+        @inherits            = []
+        @implements          = []
+        @extended_attributes = []
+      end
+
+    end
+  end # Ast
+end # WebIDL

data/lib/webidl/ast/module.rb

@@ -0,0 +1,17 @@
+module WebIDL
+  module Ast
+    class Module < Node
+
+      attr_reader :name
+      attr_accessor :extended_attributes, :definitions
+
+      def initialize(parent, name)
+        @parent              = parent
+        @name                = name
+        @definitions         = []
+        @extended_attributes = []
+      end
+
+    end # Attribute
+  end # Ast
+end # WebIDL

data/lib/webidl/ast/node.rb

@@ -0,0 +1,29 @@
+module WebIDL
+  module Ast
+    class Node
+
+      def initialize(parent = nil)
+        @parent = parent
+      end
+
+      def qualified_name
+        return unless @name
+
+        if @parent.respond_to?(:qualified_name)
+          "#{@parent.qualified_name}::#{@name}"
+        else
+          "::#{@name}"
+        end
+      end
+
+      def accept(visitor, &blk)
+        visitor.send("visit_#{snake_name}", self, &blk)
+      end
+
+      def snake_name
+        self.class.name.split("::").last.snake_case
+      end
+
+    end # Node
+  end # Ast
+end # WebIDL

data/lib/webidl/ast/operation.rb

@@ -0,0 +1,43 @@
+module WebIDL
+  module Ast
+    class Operation < Node
+
+      attr_reader :type, :name, :args, :specials, :raises
+      attr_accessor :stringifier
+
+      def initialize(parent, type, opts = {})
+        @parent   = parent
+        @type     = type
+        @name     = opts[:name]     || ''
+        @specials = opts[:specials] || []
+        @args     = opts[:args]     || []
+        @raises   = opts[:raises]   || []
+      end
+
+      def stringifier?
+        !!@stringifier
+      end
+
+      def getter?
+        @specials.include? 'getter'
+      end
+
+      def setter?
+        @specials.include? 'setter'
+      end
+
+      def creator?
+        @specials.include? 'creator'
+      end
+
+      def deleter?
+        @specials.include? 'deleter'
+      end
+
+      def caller?
+        @specials.include? 'caller'
+      end
+
+    end # Operation
+  end # Ast
+end # WebIDL