Module: TireSwing

Defined in:
lib/tire_swing.rb,
lib/tire_swing/node.rb,
lib/tire_swing/error.rb,
lib/tire_swing/visitor.rb,
lib/tire_swing/node_creator.rb,
lib/tire_swing/parser_extension.rb

Defined Under Namespace

Modules: NodeDefinition, ParserExtension, VisitorDefinition Classes: Node, NodeCreator, ParseError, Visitor

Constant Summary collapse

VERSION =

:stopdoc:

"0.0.6"
LIBPATH = 
::File.expand_path(::File.dirname(__FILE__)) + ::File::SEPARATOR
PATH = 
::File.dirname(LIBPATH) + ::File::SEPARATOR

Class Method Summary collapse

Class Method Details

.libpath(*args) ⇒ Object

Returns the library path for the module. If any arguments are given, they will be joined to the end of the libray path using File.join.



19
20
21
 
# File 'lib/tire_swing.rb', line 19

def self.libpath( *args )
  args.empty? ? LIBPATH : ::File.join(LIBPATH, *args)
end

.parses_grammar(grammar, ast = nil) ⇒ Object

Extends the treetop-provided grammar parser with a .ast class method for simple parsing and building of an AST defined by TireSwing. Takes the grammar module as an argument.

Additionally, this defines a #node method on the grammar to delegate to the class or the AST to create new nodes, e.g. <node(:variable)> instead of <AST.create_node(:variable)>

You can specify an alternate module which contains the AST if desired.



31
32
33
34
35
36
37
38
39
40
41
42
43
44
 
# File 'lib/tire_swing/parser_extension.rb', line 31

def self.parses_grammar(grammar, ast=nil)
  # use either extlib or activesupport, if that's loaded instead
  parser = grammar.to_s + "Parser"
  parser = if defined?(Extlib::Inflection)
    Extlib::Inflection.constantize
  else
    parser.constantize
  end
  ast ||= grammar
  parser.module_eval do
    extend ParserExtension
    define_method(:node) { |*args| ast.create_node(*args) }
  end
end

.path(*args) ⇒ Object

Returns the lpath for the module. If any arguments are given, they will be joined to the end of the path using File.join.



27
28
29
 
# File 'lib/tire_swing.rb', line 27

def self.path( *args )
  args.empty? ? PATH : ::File.join(PATH, *args)
end

.require_all_libs_relative_to(fname, dir = nil) ⇒ Object

Utility method used to rquire all files ending in .rb that lie in the directory below this file that has the same name as the filename passed in. Optionally, a specific directory name can be passed in such that the filename does not have to be equivalent to the directory.



36
37
38
39
40
41
42
 
# File 'lib/tire_swing.rb', line 36

def self.require_all_libs_relative_to( fname, dir = nil )
  dir ||= ::File.basename(fname, '.*')
  search_me = ::File.expand_path(
      ::File.join(::File.dirname(fname), dir, '**', '*.rb'))

  Dir.glob(search_me).sort.each {|rb| require rb}
end

.version ⇒ Object

Returns the version string for the library.



11
12
13
 
# File 'lib/tire_swing.rb', line 11

def self.version
  VERSION
end