word 0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.swn
+*.swp
+*.swo
+.rvmrc

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,17 @@
+PATH
+  remote: .
+  specs:
+    word (0.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    minitest (2.1.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (>= 1.0.0)
+  minitest
+  word!

data/MIT-LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2011 Mohammad Satrio http://tyok.org/
+
+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,20 @@
+== Word
+Extends String with word matching capabilities
+
+== Installation
+Install the gem:
+  gem install word
+Add it to your Gemfile:
+  gem "word"
+
+== Usage
+You can use `has_none?`, `has_any?`, `has_all?` to check if a string contain some word
+  "penguin guy".has_any? "bear"               # false
+  "penguin guy".has_any? "bear", "penguin"    # true
+
+You can also use array of string as input
+  "penguin guy".has_none? ["bear", "penguin"] # false
+  "penguin guy".has_all? ["guy", "penguin"]   # true
+
+== License
+MIT License. Copyright 2011 Mohammad Satrio.

data/Rakefile

@@ -0,0 +1,25 @@
+# encoding: utf-8
+
+require "bundler"
+Bundler::GemHelper.install_tasks
+
+require "rake"
+require "rake/testtask"
+Rake::TestTask.new(:test) do |test|
+  test.libs << "lib"
+  test.libs << "spec"
+  test.pattern = "spec/**/*_spec.rb"
+  test.verbose = true
+end
+
+task :default => :test
+
+require "rake/rdoctask"
+Rake::RDocTask.new do |rdoc|
+  require "word/version"
+
+  rdoc.rdoc_dir = "rdoc"
+  rdoc.title = "Word #{Word::VERSION}"
+  rdoc.rdoc_files.include("README*")
+  rdoc.rdoc_files.include("lib/**/*.rb")
+end

data/lib/word/extract.rb

@@ -0,0 +1,10 @@
+require File.expand_path("../wildcard", __FILE__)
+module Word
+  module Extract
+    # "a b 'c d'" => ["a", "b", "\"c d\""]
+    def extract_words(wildcard = Word::WILDCARD)
+      word = /".*?"|'.*?'|#{wildcard}?\w+#{wildcard}?/ # "word1 word2" | 'word1 word2' | word
+      scan(word).flatten.map{|x| x.gsub(/"|'/, '"')}.uniq
+    end
+  end
+end

data/lib/word/match.rb

@@ -0,0 +1,29 @@
+require File.expand_path("../regexp", __FILE__)
+module Word
+  module Match
+    include Regexp
+
+    def has_none?(*args)
+      words = args.first.respond_to?(:first) ? args.first : args
+      return nil == (self =~ Regexp.has_any_regexp(words))
+    end
+
+    def has_any?(*args)
+      words = args.first.respond_to?(:first) ? args.first : args
+      return nil != (self =~ Regexp.has_any_regexp(words))
+    end
+
+    def has_all?(*args)
+      words = args.first.respond_to?(:first) ? args.first : args
+      matching = match(Regexp.has_any_regexp(words)).to_s.downcase
+      return false if matching.empty?
+      remain = words - [matching]
+      if remain.empty?
+        true
+      else
+        has_all?(remain)
+      end
+    end
+
+  end
+end

data/lib/word/regexp.rb

@@ -0,0 +1,24 @@
+require File.expand_path("../wildcard", __FILE__)
+module Word
+  module Regexp
+
+    def word_regexp(wildcard = Word::WILDCARD, options = true)
+      wildcard = wildcard || Word::WILDCARD
+      prefixed = /^(#{wildcard})/
+      suffixed = /(#{wildcard})$/
+
+      prefix = (wildcard and self =~ prefixed) ? "" : "\\b"
+      suffix = (wildcard and self =~ suffixed) ? "" : "\\b"
+
+      w = self.gsub(/#{prefixed}|#{suffixed}/, "")
+      w = prefix + ::Regexp.escape(w) + suffix
+
+      ::Regexp.new(w, options)
+    end
+
+    def self.has_any_regexp(words, wildcard = Word::WILDCARD, options = true)
+      /#{words.map{|w| w.word_regexp(wildcard, options)}.join('|')}/
+    end
+
+  end
+end

data/lib/word/version.rb

@@ -0,0 +1,3 @@
+module Word
+  VERSION = '0.1'
+end

data/lib/word/wildcard.rb

@@ -0,0 +1,3 @@
+module Word
+  WILDCARD = /\*/
+end

data/lib/word.rb

@@ -0,0 +1,8 @@
+require File.expand_path("../word/extract", __FILE__)
+require File.expand_path("../word/match", __FILE__)
+require File.expand_path("../word/regexp", __FILE__)
+require File.expand_path("../word/version", __FILE__)
+require File.expand_path("../word/wildcard", __FILE__)
+
+String.send :include, Word::Match
+String.send :include, Word::Extract

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+require "rubygems"
+require "minitest/autorun"
+
+$:.unshift File.expand_path("../../lib", __FILE__)

data/spec/word/extract_spec.rb

@@ -0,0 +1,23 @@
+require "spec_helper"
+require "word/extract"
+
+String.send :include, Word::Extract
+
+describe Word::Extract do
+
+  describe "extract_words" do
+    it "returns an array" do
+      "penguin guy".extract_words.must_be_kind_of Array
+    end
+
+    it "extracts words from a string" do
+      "penguin guy".extract_words.must_equal %w[ penguin guy ]
+      "PenguIn guy".extract_words.must_equal %w[ PenguIn guy ]
+    end
+
+    it "treats a pair of quote and anything between as a word" do
+      "'awesome penguin' guy".extract_words.must_equal %w[ "awesome\ penguin" guy ]
+    end
+  end
+
+end

data/spec/word/match_spec.rb

@@ -0,0 +1,61 @@
+require "spec_helper"
+require "word/match"
+
+String.send :include, Word::Match
+
+describe Word::Match do
+
+  describe "has_none?" do
+    it "returns true if none of its arguments is in the string" do
+      "penguin guy".has_none?( "bear" ).must_equal true
+      "penguin guy".has_none?(["bear"]).must_equal true
+    end
+
+    it "returns false if any of its arguments is in the string" do
+      "penguin guy".has_none?( "bear", "guy" ).must_equal false
+      "penguin guy".has_none?(["bear", "guy"]).must_equal false
+    end
+
+    it "returns false if all of its arguments is in the string" do
+      "penguin guy".has_none?( "penguin", "guy" ).must_equal false
+      "penguin guy".has_none?(["penguin", "guy"]).must_equal false
+    end
+  end
+
+  describe "has_any?" do
+    it "returns false if none of its arguments is in the string" do
+      "penguin guy".has_any?( "bug", "bear" ).must_equal false
+      "penguin guy".has_any?(["bug", "bear"]).must_equal false
+    end
+
+    it "returns true if any of its arguments is in the string" do
+      "penguin guy".has_any?( "penguin", "lover" ).must_equal true
+      "penguin guy".has_any?(["penguin", "lover"]).must_equal true
+    end
+
+    it "returns true if all of its arguments is in the string" do
+      "penguin guy".has_any?( "penguin", "guy" ).must_equal true
+      "penguin guy".has_any?(["penguin", "guy"]).must_equal true
+    end
+  end
+
+  describe "has_all?" do
+    it "returns false if none of its arguments is in the string" do
+      "penguin guy".has_all?( "bug", "bear" ).must_equal false
+      "penguin guy".has_all?(["bug", "bear"]).must_equal false
+    end
+
+    it "returns false if any of its arguments is in the string" do
+      "penguin guy".has_all?( "penguin", "lover" ).must_equal false
+      "penguin guy".has_all?(["penguin", "lover"]).must_equal false
+    end
+
+    it "returns true if all of its arguments is in the string" do
+      "penguin guy".has_all?( "penguin", "guy" ).must_equal true
+      "penguin guy".has_all?(["penguin", "guy"]).must_equal true
+    end
+  end
+
+end
+
+

data/spec/word/regexp_spec.rb

@@ -0,0 +1,103 @@
+require "spec_helper"
+require "word/regexp"
+
+String.send :include, Word::Regexp
+
+describe Word::Regexp do
+
+  describe "word_regexp" do
+    before :each do
+      @word = "penguin"
+      @normal_matches      = ["penguin", "Ima penguin!", "Me da'penguin"]
+      @insensitive_matches = ["PenGuin", "Ima PengUin!", "Me da'PENGUIN"]
+      @normal_not_matches  = ["kitten", "dog", "pengu", "guin"]
+      @suffixed_matches    = ["real penguinterminator", "penguinhuh, yeah"]
+      @prefixed_matches    = ["I'm dapenguin y'know?"]
+      @wildcard_matches    = ["oh my supercalifragilisticexpenguindociou OMIGOD!!!"]
+    end
+
+    it "returns a valid regexp" do
+      @word.word_regexp.must_be_kind_of ::Regexp
+    end
+
+    it "returns a regexp to match a word" do
+      penguin = @word.word_regexp
+      (@normal_matches + @insensitive_matches).each do |string|
+        penguin.must_match string
+      end
+      (@normal_not_matches + @suffixed_matches).each do |string|
+        penguin.wont_match string
+      end
+    end
+
+    it "accepts prefix wildcard" do
+      penguin_pref = "*#{@word}".word_regexp nil
+      (@normal_matches + @insensitive_matches + @prefixed_matches).each do |string|
+        penguin_pref.must_match string
+      end
+      (@normal_not_matches + @suffixed_matches).each do |string|
+        penguin_pref.wont_match string
+      end
+    end
+
+    it "accepts sufix wildcard" do
+      penguin_suf = "#{@word}*".word_regexp nil
+      (@normal_matches + @insensitive_matches + @suffixed_matches).each do |string|
+        penguin_suf.must_match string
+      end
+      (@normal_not_matches + @prefixed_matches).each do |string|
+        penguin_suf.wont_match string
+      end
+    end
+
+    it "accepts prefix and sufix wildcard" do
+      penguin_wild = "*#{@word}*".word_regexp nil
+      (@normal_matches + @insensitive_matches + @suffixed_matches + @prefixed_matches).each do |string|
+        penguin_wild.must_match string
+      end
+      (@normal_not_matches).each do |string|
+        penguin_wild.wont_match string
+      end
+    end
+
+    it "accepts custom wildcard" do
+      penguin_wild = "%#{@word}%".word_regexp /%/
+      (@normal_matches + @insensitive_matches + @suffixed_matches + @prefixed_matches).each do |string|
+        penguin_wild.must_match string
+      end
+      (@normal_not_matches).each do |string|
+        penguin_wild.wont_match string
+      end
+    end
+
+    it "accepts regexp options" do
+      penguin = @word.word_regexp nil, nil
+      (@insensitive_matches).each do |string|
+        penguin.wont_match string
+      end
+
+      penguin_wild = "*#{@word}*".word_regexp nil, ::Regexp::IGNORECASE
+      (@normal_matches + @insensitive_matches + @suffixed_matches + @prefixed_matches).each do |string|
+        penguin_wild.must_match string
+      end
+    end
+  end
+
+  describe "self.has_any_regexp" do
+    before :each do
+      @penguin_or_guy = Word::Regexp.has_any_regexp(%w[ penguin guy])
+    end
+
+    it "returns a Regexp" do
+      @penguin_or_guy.must_be_kind_of ::Regexp
+    end
+
+    it "matches any of the words provided" do
+      @penguin_or_guy.must_match "a quick brown penguin jumps over lazy polar bear"
+      @penguin_or_guy.must_match "a quick brown guy jumps over lazy polar bear"
+      @penguin_or_guy.must_match "a quick brown guy jumps over lazy penguin"
+      @penguin_or_guy.wont_match "a quick brown fox jumps over lazy dog"
+    end
+  end
+
+end

data/word.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "word/version"
+
+Gem::Specification.new do |s|
+  s.name        = "word"
+  s.version     = Word::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Mohammad Satrio"]
+  s.email       = ["wolfaeon@gmail.com"]
+  s.homepage    = "https://github.com/tyok/word"
+  s.summary     = "Extends String with word matching capabilities"
+  s.description = "Extends String with word matching capabilities"
+
+  s.files            = `git ls-files`.split("\n")
+  s.test_files       = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.extra_rdoc_files = ["README.rdoc"]
+  s.require_paths    = ["lib"]
+
+  s.licenses = ["MIT"]
+
+  s.add_development_dependency "bundler", [">= 1.0.0"]
+  s.add_development_dependency "minitest", [">= 0"]
+end
+

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification 
+name: word
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: "0.1"
+platform: ruby
+authors: 
+- Mohammad Satrio
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-05-05 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.0.0
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: minitest
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id002
+description: Extends String with word matching capabilities
+email: 
+- wolfaeon@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- MIT-LICENSE
+- README.rdoc
+- Rakefile
+- lib/word.rb
+- lib/word/extract.rb
+- lib/word/match.rb
+- lib/word/regexp.rb
+- lib/word/version.rb
+- lib/word/wildcard.rb
+- spec/spec_helper.rb
+- spec/word/extract_spec.rb
+- spec/word/match_spec.rb
+- spec/word/regexp_spec.rb
+- word.gemspec
+homepage: https://github.com/tyok/word
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.0
+signing_key: 
+specification_version: 3
+summary: Extends String with word matching capabilities
+test_files: []
+