# File lib/ooparser.rb, line 112
    def self::grammar( &block )
        if block
            self.log.debug "Defining grammar with %p" % block
            @grammar = OOParser::Grammar::new( &block )
        end

        return @grammar
    end

# File lib/ooparser.rb, line 101
    def self::log
        if !defined?( @log ) || @log.nil?
            @log = Logger::new( $deferr )
            @log.level = Logger::WARN
        end

        return @log
    end

# File lib/ooparser.rb, line 128
    def initialize
        @log = self.class.log.clone
        @rules = {}

        self.install_grammar
    end

# File lib/ooparser.rb, line 145
    def inspect
        return "#<%s:0x%0x @rules=%p>" % [
            self.class.name,
            self.object_id,
            @rules,
        ]
    end

# File lib/ooparser.rb, line 165
    def install_grammar
        grammar = self.class.grammar or raise OOParser::Error,
            "Cannot instantiate %s: no grammar defined" % self.class.name
        if grammar.rules.empty?
            raise OOParser::Error,
                "Cannot instantiate %s: grammar has no rules"
        end

        # Install a singleton method on the parser object for each rule of the
        # grammar
        grammar.rules.each do |name,rule|
            block = rule.as_proc( self )
            @rules[ name.to_sym ] = block

            self.log.debug "Installing rule %p: %s" % [ rule, block ]
            self.metaclass.send( :define_method, name.to_sym, block )
        end

        # Alias the #parse method to the grammar's default rule
        self.metaclass.send( :alias_method, :parse, grammar.default_rule )
    end

# File lib/ooparser.rb, line 159
    def metaclass
        (class << self; self; end)
    end