wordnet 1.0.0.pre.134 → 1.0.0.pre.136

data.tar.gz.sig

@@ -1 +1 @@
-�<�L�}
XJ��5��-�TLW%������cʵ?���O��dj��#��}/���KS*�m��H����Y��.G>�zg�Fr��m#ʮ���$�:h瀾V�d
�rn�\~jD��*޴��$��GRFŜ)��_q��a���vDdsQv��䔰'} $�qe����^���02��L0��s�T���4v4d����x����,MJ;���!�N	���~�[��j�٧�����;ޠ#�z�.$.N`O�u
+o�ۡʸ�`)�&�T����\�R�Bo(��FM�nP�,�;m��V�]�cTV7���}�WF�w\��?�Z�/�}]Q�X�c����V�H��t%�{���n�1l��~��"繤
����%[c�b3-Bݍ���
��4lſ�~����
ꮡ��t������)�V}���;r�������>(\N�-����wơY

data/README.rdoc

@@ -4,18 +4,19 @@
 
 == Description
 
-This library is a Ruby interface to WordNet®. WordNet® is an online lexical
-reference system whose design is inspired by current psycholinguistic theories
-of human lexical memory. English nouns, verbs, adjectives and adverbs are
-organized into synonym sets, each representing one underlying lexical
-concept. Different relations link the synonym sets.
-
-It uses WordNet-SQL, which is a conversion of the lexicon flatfiles into a
-relational database format. You can either install the 'wordnet-defaultdb' gem,
-which packges up the SQLite3 version of WordNet-SQL, or install your own and
-point the lexicon at it by passing a Sequel URL to the constructor.
-
-TO-DO: More details and better writing later.
+This library is a Ruby interface to WordNet®. WordNet® is an online
+lexical reference system whose design is inspired by current
+psycholinguistic theories of human lexical memory. English nouns, verbs,
+adjectives and adverbs are organized into synonym sets, each
+representing one underlying lexical concept. Different relations link
+the synonym sets.
+
+It uses WordNet-SQL, which is a conversion of the lexicon flatfiles into
+a relational database format. You can either install the 'wordnet-
+defaultdb' gem, which packages up the SQLite3 version of WordNet-SQL, or
+install your own and point the lexicon at it by passing a Sequel URL to
+the constructor.
+
 
 
 == Requirements

data/lib/wordnet/lexicon.rb

@@ -209,5 +209,13 @@ class WordNet::Lexicon
 		return dataset.all
 	end
 
+
+	### Return a human-readable string representation of the Lexicon, suitable for
+	### debugging.
+	def inspect
+		return "#<%p:%0#x %s>" % [ self.class, self.object_id * 2, self.db.url ]
+	end
+
+
 end # class WordNet::Lexicon
 

data/lib/wordnet/model.rb

@@ -13,10 +13,6 @@ module WordNet
 	# The base WordNet database-backed domain class. It's a subclass of Sequel::Model, so
 	# you'll first need to be familiar with Sequel (http://sequel.rubyforge.org/) and
 	# especially its Sequel::Model ORM.
-	#
-	# See the Sequel::Plugins::InlineMigrations module and the documentation for the
-	# 'validation_helpers', 'schema', and 'subclasses' Sequel plugins.
-	#
 	class Model < Sequel::Model
 		extend Loggability
 

data/lib/wordnet/synset.rb

@@ -414,6 +414,32 @@ class WordNet::Synset < WordNet::Model( :synsets )
 	semantic_link :verb_groups
 
 
+	#
+	# :section: Traversal Methods
+	#
+
+	### Union: Return the least general synset that the receiver and
+	### +othersyn+ have in common as a hypernym, or nil if it doesn't share
+	### any.
+	def |( othersyn )
+
+		# Find all of this syn's hypernyms
+		hypersyns = self.traverse( :hypernyms ).to_a
+		commonsyn = nil
+
+		# Now traverse the other synset's hypernyms looking for one of our
+		# own hypernyms.
+		othersyn.traverse( :hypernyms ) do |syn|
+			if hypersyns.include?( syn )
+				commonsyn = syn
+				throw :stop_traversal
+			end
+		end
+
+		return commonsyn
+	end
+
+
 	### With a block, yield a WordNet::Synset related to the receiver via a link of
 	### the specified +type+, recursing depth first into each of its links if the link
 	### type is recursive. To exit from the traversal at any depth, throw :stop_traversal.
@@ -429,16 +455,16 @@ class WordNet::Synset < WordNet::Model( :synsets )
 			traversals = [ self.semanticlink_enum(type) ]
 			syn        = nil
 			typekey    = SEMANTIC_TYPEKEYS[ type ]
-			recurses   = self.linktypes[ typekey ][:recurses]
+			recurses   = self.class.linktypes[ typekey ][:recurses]
 
 			self.log.debug "Traversing %s semlinks%s" % [ type, recurses ? " (recursive)" : ''  ]
 
 			catch( :stop_traversal ) do
 				until traversals.empty?
 					begin
-						self.log.debug "  %d traversal/s left"
+						self.log.debug "  %d traversal/s left" % [ traversals.length ]
 						syn = traversals.last.next
-						yielder.yield( syn, traversals.length )
+						yielder.yield( syn )
 						traversals << syn.semanticlink_enum( type ) if recurses
 					rescue StopIteration
 						traversals.pop
@@ -460,5 +486,19 @@ class WordNet::Synset < WordNet::Model( :synsets )
 		return depth
 	end
 
+
+	### Return a human-readable representation of the objects, suitable for debugging.
+	def inspect
+		return "#<%p:%0#x {%d} '%s' (%s): [%s] %s>" % [
+			self.class,
+			self.object_id * 2,
+			self.synsetid,
+			self.words.map(&:to_s).join(', '),
+			self.part_of_speech,
+			self.lexical_domain,
+			self.definition,
+		]
+	end
+
 end # class WordNet::Synset
 

data/spec/wordnet/synset_spec.rb

@@ -78,8 +78,51 @@ describe WordNet::Synset, :requires_database => true do
 			enum.should be_a( Enumerator )
 		end
 
+		it "can recursively traverse its semantic links" do
+			res = @synset.traverse( :hypernyms ).to_a
+			res.should have( 6 ).members
+			res.should == [
+				WordNet::Synset[ 104341686 ],
+				WordNet::Synset[ 100021939 ],
+				WordNet::Synset[ 100003553 ],
+				WordNet::Synset[ 100002684 ],
+				WordNet::Synset[ 100001930 ],
+				WordNet::Synset[ 100001740 ],
+			]
+		end
+
+		it "can return an Enumerator for recursively traversing its semantic links" do
+			enum = @synset.traverse( :hypernyms )
+
+			enum.next.should == WordNet::Synset[ 104341686 ]
+			enum.next.should == WordNet::Synset[ 100021939 ]
+			enum.next.should == WordNet::Synset[ 100003553 ]
+			enum.next.should == WordNet::Synset[ 100002684 ]
+			enum.next.should == WordNet::Synset[ 100001930 ]
+			enum.next.should == WordNet::Synset[ 100001740 ]
+			expect {
+				enum.next
+			}.to raise_error( StopIteration )
+		end
+
+
+		end
+
+	context "for 'knight (noun)' [110238375]" do
+
+		before( :each ) do
+			@synset = @lexicon[ :knight, "noble" ]
+		end
+
+		it "can find the hypernym that it and another synset share in common through the intersection operator" do
+			res = @synset | @lexicon[ :squire ]
+			res.should == @lexicon[:person]
+		end
+
 	end
 
+
+
 end
 
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: wordnet
 version: !ruby/object:Gem::Version
-  version: 1.0.0.pre.134
+  version: 1.0.0.pre.136
   prerelease: 
 platform: ruby
 authors:
@@ -36,7 +36,7 @@ cert_chain:
   YUhDS0xaZFNLai9SSHVUT3QrZ2JsUmV4OEZBaDhOZUEKY21saFhlNDZwWk5K
   Z1dLYnhaYWg4NWpJang5NWhSOHZPSStOQU01aUg5a09xSzEzRHJ4YWNUS1Bo
   cWo1UGp3RgotLS0tLUVORCBDRVJUSUZJQ0FURS0tLS0tCg==
-date: 2012-08-06 00:00:00.000000000 Z
+date: 2012-08-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sequel
@@ -167,27 +167,27 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '3.0'
 description: ! 'This library is a Ruby interface to WordNet®. WordNet® is an online
-  lexical
 
-  reference system whose design is inspired by current psycholinguistic theories
+  lexical reference system whose design is inspired by current
 
-  of human lexical memory. English nouns, verbs, adjectives and adverbs are
+  psycholinguistic theories of human lexical memory. English nouns, verbs,
 
-  organized into synonym sets, each representing one underlying lexical
+  adjectives and adverbs are organized into synonym sets, each
 
-  concept. Different relations link the synonym sets.
+  representing one underlying lexical concept. Different relations link
 
+  the synonym sets.
 
-  It uses WordNet-SQL, which is a conversion of the lexicon flatfiles into a
 
-  relational database format. You can either install the ''wordnet-defaultdb'' gem,
+  It uses WordNet-SQL, which is a conversion of the lexicon flatfiles into
 
-  which packges up the SQLite3 version of WordNet-SQL, or install your own and
+  a relational database format. You can either install the ''wordnet-
 
-  point the lexicon at it by passing a Sequel URL to the constructor.
+  defaultdb'' gem, which packages up the SQLite3 version of WordNet-SQL, or
 
+  install your own and point the lexicon at it by passing a Sequel URL to
 
-  TO-DO: More details and better writing later.'
+  the constructor.'
 email:
 - ged@FaerieMUD.org
 executables: []