panini 1.0.0

data/lib/grammar.rb

@@ -0,0 +1,31 @@
+module Panini
+
+
+  # The Grammar stores the start symbol and nonterminals.
+  class Grammar
+    
+    def initialize
+      @nonterminals = []
+    end
+
+    # Returns the grammar's start symbol. This will always be the first
+    # nonterminal added to the grammar.
+    def start
+      @nonterminals[0]
+    end
+
+    # Add a nonterminal to the grammar.
+    def add_nonterminal(name = nil)
+      Panini::Nonterminal.new(name).tap do |new_nonterminal|
+        @nonterminals << new_nonterminal
+      end
+    end
+
+    # The list of nonterminals in the grammar.
+    def nonterminals
+      @nonterminals.dup
+    end
+    
+  end
+
+end

data/lib/hash.rb

@@ -0,0 +1,11 @@
+class Hash
+
+  def map(&block)
+    mapped_hash = {}
+    self.each do |key, value|
+      mapped_hash[key] = yield value
+    end
+    mapped_hash
+  end
+
+end

data/lib/nonterminal.rb

@@ -0,0 +1,35 @@
+module Panini
+
+  class Nonterminal
+
+    attr_reader :name
+
+    # Initialize a nonterminal. Optionally specify a name.
+    def initialize(name=nil)
+      @productions = []
+      @name = name
+    end
+
+    # Add a production to the nonterminal.  It must be an array, but the array can
+    # contain any type of Ruby object.
+    #
+    #  nonterminal.add_production([1, 'a', lambda { ...} ])
+    #
+    def add_production(production)
+      raise ArgumentError, "The production must be an Array." unless production.class == Array
+      @productions << production.dup
+      nil
+    end
+
+    # The productions for the nonterminal.
+    def productions
+      @productions.dup
+    end
+
+    def to_s
+      name.nil? ? super : @name
+    end
+
+  end
+
+end

data/lib/panini.rb

@@ -0,0 +1,6 @@
+require "grammar"
+require "hash"
+require "nonterminal"
+require "derivation_strategy/base"
+require "derivation_strategy/leftmost"
+require "derivation_strategy/random_dampened"

data/panini.gemspec

@@ -0,0 +1,73 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{panini}
+  s.version = "1.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["mjbellantoni"]
+  s.date = %q{2011-05-16}
+  s.description = %q{Panini allows you to generate sentences from a context-free grammar, also known as a CFG.}
+  s.email = %q{mjbellantoni@yahoo.com}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "examples/arithmetic_expression.rb",
+    "lib/derivation_strategy/base.rb",
+    "lib/derivation_strategy/leftmost.rb",
+    "lib/derivation_strategy/random_dampened.rb",
+    "lib/grammar.rb",
+    "lib/hash.rb",
+    "lib/nonterminal.rb",
+    "lib/panini.rb",
+    "panini.gemspec",
+    "spec/derivation_strategy/dampened_probability_production_choice_proxy_spec.rb",
+    "spec/derivation_strategy/leftmost_spec.rb",
+    "spec/derivation_strategy/random_dampened_spec.rb",
+    "spec/grammar_spec.rb",
+    "spec/nonterminal_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/support/basic_derivation_strategy_shared_example.rb"
+  ]
+  s.homepage = %q{http://github.com/mjbellantoni/panini}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Create sentences from a context-free grammar (CFG)}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.6.0"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+    else
+      s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6.0"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6.0"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+  end
+end
+

data/spec/derivation_strategy/dampened_probability_production_choice_proxy_spec.rb

@@ -0,0 +1,194 @@
+require "spec_helper"
+
+
+describe Panini::DerivationStrategy::DampenedProbabilityProductionChoiceProxy do
+
+  it "responds to #production" do
+    described_class.new(Panini::Nonterminal.new).should respond_to(:production)
+  end
+
+end
+
+
+describe Panini::DerivationStrategy::DampenedProbabilityProductionChoiceProxy, "#production" do
+
+  context "with damping 0.50" do
+
+    before(:each) do
+      @damping = 0.50
+    end
+
+    context "with a production N -> 'a' and rand() -> 0.25" do
+
+      before(:each) do
+        n = Panini::Nonterminal.new
+        n.add_production(['a'])
+        @proxy = described_class.new(n, @damping)
+        Kernel::stub(:rand).and_return(0.25)
+      end
+
+      it "returns ['a'] after one call" do
+        @proxy.production.should == ['a']
+      end
+
+      it "returns ['a'] after two calls" do
+        @proxy.production
+        @proxy.production.should == ['a']
+      end
+
+      it "returns ['a'] after three calls" do
+        @proxy.production
+        @proxy.production
+        @proxy.production.should == ['a']
+      end
+
+    end
+
+    context "with a production N -> 'a' | 'b' and rand() -> 0.25" do
+
+      before(:each) do
+        n = Panini::Nonterminal.new
+        n.add_production(['a'])
+        n.add_production(['b'])
+        @proxy = described_class.new(n, @damping)
+        Kernel::stub(:rand).and_return(0.25)
+      end
+
+      it "returns ['a'] after one call" do
+        @proxy.production.should == ['a']
+      end
+
+      it "returns ['a'] after two calls" do
+        @proxy.production
+        @proxy.production.should == ['a']
+      end
+
+      it "returns ['b'] after three calls" do
+        @proxy.production
+        @proxy.production
+        @proxy.production.should == ['b']
+      end
+
+    end
+
+    context "with a production N -> 'a' | 'b' | 'c' and rand() -> 0.3" do
+
+      before(:each) do
+        n = Panini::Nonterminal.new
+        n.add_production(['a'])
+        n.add_production(['b'])
+        n.add_production(['c'])
+        @proxy = described_class.new(n, @damping)
+        Kernel::stub(:rand).and_return(0.3)
+      end
+
+      it "returns ['a'] after one call" do
+        @proxy.production.should == ['a']
+      end
+
+      it "returns ['b'] after two calls" do
+        @proxy.production
+        @proxy.production.should == ['b']
+      end
+
+      it "returns ['b'] after three calls" do
+        @proxy.production
+        @proxy.production
+        @proxy.production.should == ['b']
+      end
+
+      it "returns ['b'] after four calls" do
+        @proxy.production
+        @proxy.production
+        @proxy.production
+        @proxy.production.should == ['b']
+      end
+
+      it "returns ['a'] after five calls" do
+        @proxy.production
+        @proxy.production
+        @proxy.production
+        @proxy.production
+        @proxy.production.should == ['a']
+      end
+
+      it "returns ['c'] after six calls" do
+        @proxy.production
+        @proxy.production
+        @proxy.production
+        @proxy.production
+        @proxy.production
+        @proxy.production.should == ['c']
+      end
+
+    end
+
+  end
+
+end
+
+
+
+describe Panini::DerivationStrategy::DampenedProbabilityProductionChoiceProxy, "#clone" do
+
+  context "with damping 0.50, a production N -> 'a' | 'b' | 'c' and rand() -> 0.3" do
+
+    before(:each) do
+      n = Panini::Nonterminal.new
+      n.add_production(['a'])
+      n.add_production(['b'])
+      n.add_production(['c'])
+      @proxy = described_class.new(n, 0.50)
+      Kernel::stub(:rand).and_return(0.3)
+    end
+
+    context "and a clone" do
+
+      before(:each) do
+        @clone_proxy = @proxy.clone        
+        @clone_proxy.stub(:rand).and_return(0.3)
+      end
+
+      context "the original" do
+        
+        it "returns ['a'] after one call" do
+          @proxy.production.should == ['a']
+        end
+
+        it "returns ['b'] after two calls" do
+          @proxy.production
+          @proxy.production.should == ['b']
+        end
+
+        it "returns ['b'] after three calls" do
+          @proxy.production
+          @proxy.production
+          @proxy.production.should == ['b']
+        end
+
+      end
+
+      context "the clone" do
+        
+        it "returns ['a'] after one call" do
+          @clone_proxy.production.should == ['a']
+        end
+
+        it "returns ['b'] after two calls" do
+          @clone_proxy.production
+          @clone_proxy.production.should == ['b']
+        end
+
+        it "returns ['b'] after three calls" do
+          @clone_proxy.production
+          @clone_proxy.production
+          @clone_proxy.production.should == ['b']
+        end
+
+      end
+
+    end
+
+  end
+
+end

data/spec/derivation_strategy/leftmost_spec.rb

@@ -0,0 +1,90 @@
+require "spec_helper"
+
+
+describe Panini::DerivationStrategy::Leftmost do
+  it_behaves_like "basic derivation strategy"  
+end
+
+
+
+describe "Grammar with the production S -> AAB, A -> 'a' | 'x', B -> 'b'" do
+
+  before (:each) do
+    @g = Panini::Grammar.new
+
+    @n_s = @g.add_nonterminal
+    @n_a = @g.add_nonterminal
+    @n_b = @g.add_nonterminal
+
+    @n_s.add_production([@n_a, @n_a, @n_b])
+    @n_a.add_production(['a'])
+    @n_a.add_production(['x'])
+    @n_b.add_production(['b'])
+  end
+
+  it "generates the sentence ['a', 'x', 'b']" do 
+    d = Panini::DerivationStrategy::Leftmost.new(@g)
+    d.sentence.should == ['a', 'x', 'b']
+  end
+
+end
+
+
+
+describe "Grammar with the production S -> 'a' | 'b'" do
+
+  before (:each) do
+    @g = Panini::Grammar.new
+    @n = @g.add_nonterminal
+    @n.add_production(['a'])
+    @n.add_production(['b'])
+  end
+
+  it "generates the sentence ['a']" do 
+    d = Panini::DerivationStrategy::Leftmost.new(@g)
+    d.sentence.should == ['a']
+  end
+
+end
+
+
+
+describe "Grammar with the production S -> S | 'a' | 'b'" do
+
+  before (:each) do
+    @g = Panini::Grammar.new
+    @n = @g.add_nonterminal
+    @n.add_production([@n])
+    @n.add_production(['a'])
+    @n.add_production(['b'])
+
+    @deriver = Panini::DerivationStrategy::Leftmost.new(@g)
+  end
+
+  it "generates the sentence ['a'] first" do 
+    @deriver.sentence.should == ['a']
+  end
+
+  it "generates the sentence ['b'] second" do 
+    @deriver.sentence.should
+    @deriver.sentence.should == ['b']
+  end
+
+end
+
+
+describe "with the production S -> 'a' | 'b'" do
+
+  before (:each) do
+    @g = Panini::Grammar.new
+    @n = @g.add_nonterminal
+    @n.add_production(['a'])
+    @n.add_production(['b'])
+  end
+
+  it "generates the sentence ['a']" do 
+    d = Panini::DerivationStrategy::Leftmost.new(@g)
+    d.sentence.should == ['a']
+  end
+
+end