zeke-monkey_patches 0.1.4

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Zeke Sikelianos
+
+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,7 @@
+= monkey_patches
+
+Description goes here.
+
+== Copyright
+
+Copyright (c) 2009 Zeke Sikelianos. See LICENSE for details.

data/VERSION.yml

@@ -0,0 +1,4 @@
+--- 
+:patch: 4
+:major: 0
+:minor: 1

data/lib/monkey_patches.rb

@@ -0,0 +1,180 @@
+class String
+
+  # Removes the middle from long strings, replacing with a placeholder
+  def ellipsize(options={})
+     max = options[:max] || 40
+     delimiter = options[:delimiter] || "..."
+     return self if self.size <= max
+     offset = max/2
+     self[0,offset] + delimiter + self[-offset,offset]
+  end
+  
+  # Generates a permalink-style string, with odd characters removed, etc.
+  def permalinkify
+    result = self.to_s
+    result.gsub!(/[^\x00-\x7F]+/, '') # Remove anything non-ASCII entirely (e.g. diacritics).
+    result.gsub!(/[^\w_ \-]+/i,   '') # Remove unwanted chars.
+    result.gsub!(/[ \-]+/i,      '-') # No more than one of the separator in a row.
+    result.gsub!(/^\-|\-$/i,      '') # Remove leading/trailing separator.
+    result.downcase!
+  end
+
+  # Prepends 'http://' to the beginning of non-empty strings that don't already have it.
+  def add_http
+    return "" if self.blank?
+    return "http://#{self}" unless self.starts_with?("http")
+    self
+  end
+  
+  # Removes presentationally superflous http and/or www text from the beginning of the string
+  def remove_http_and_www
+    return "" if self.blank?
+    return self.split(".").remove_first_element.join(".") if self.starts_with?("www.")
+    self.gsub("http://www.", "").gsub("http://", "").gsub("https://www.", "").gsub("https://", "")
+  end
+  
+  # Shortens a string, preserving the last word. Truncation can be limited by words or characters
+  def truncate_preserving_words(options={})
+    end_string = options[:end_string] || "..."
+    max_words = options[:max_words] || nil
+    if max_words
+      words = self.split()
+      return self if words.size < max_words
+      words = words[0..(max_words-1)]
+      words << end_string
+      words.join(" ")
+    else
+      max_chars = options[:max_chars] || 60
+      return self if self.size < max_chars
+      out = self[0..(max_chars-1)].split(" ")
+      out.pop
+      out << end_string
+      out.join(" ")
+    end
+  end
+
+  def replace_wonky_characters_with_ascii
+    t = self.to_s
+    t.gsub!(/&#8211;/, '-')      # en-dash
+    t.gsub!(/&#8212;/, '--')     # em-dash
+    t.gsub!(/&#8230;/, '...')     # ellipsis    
+    t.gsub!(/&#8216;/, "'")      # open single quote
+    t.gsub!(/&#8217;/, "'")      # close single quote
+    t.gsub!(/&#8220;/, '"')      # open double quote
+    t.gsub!(/&#8221;/, '"')      # close double quote
+    
+    t.gsub!("\342\200\042", "-")    # en-dash
+    t.gsub!("\342\200\041", "--")   # em-dash
+    t.gsub!("\342\200\174", "...")  # ellipsis
+    t.gsub!("\342\200\176", "'")    # single quote
+    t.gsub!("\342\200\177", "'")    # single quote
+    t.gsub!("\342\200\230", "'")    # single quote
+    t.gsub!("\342\200\231", "'")    # single quote
+    t.gsub!("\342\200\234", "\"")   # Double quote, right
+    t.gsub!("\342\200\235", "\"")   # Double quote, left
+    t.gsub!("\342\200\242", ".")
+    t.gsub!("\342\202\254", "&euro;");   # Euro symbol
+    t.gsub!(/\S\200\S/, " ")             # every other strange character send to the moon
+    t.gsub!("\176", "\'")  # single quote
+    t.gsub!("\177", "\'")  # single quote
+    t.gsub!("\205", "-")		# ISO-Latin1 horizontal elipses (0x85)
+    t.gsub!("\221", "\'")	# ISO-Latin1 left single-quote
+    t.gsub!("\222", "\'")	# ISO-Latin1 right single-quote
+    t.gsub!("\223", "\"")	# ISO-Latin1 left double-quote
+    t.gsub!("\224", "\"")	# ISO-Latin1 right double-quote
+    t.gsub!("\225", "\*")	# ISO-Latin1 bullet
+    t.gsub!("\226", "-")		# ISO-Latin1 en-dash (0x96)
+    t.gsub!("\227", "-")		# ISO-Latin1 em-dash (0x97)
+    t.gsub!("\230", "\'")  # single quote
+    t.gsub!("\231", "\'")  # single quote
+    t.gsub!("\233", ">")		# ISO-Latin1 single right angle quote
+    t.gsub!("\234", "\"")  # Double quote
+    t.gsub!("\235", "\"")  # Double quote
+    t.gsub!("\240", " ")		# ISO-Latin1 nonbreaking space
+    t.gsub!("\246", "\|")	# ISO-Latin1 broken vertical bar
+    t.gsub!("\255", "")	  # ISO-Latin1 soft hyphen (0xAD)
+    t.gsub!("\264", "\'")	# ISO-Latin1 spacing acute
+    t.gsub!("\267", "\*")	# ISO-Latin1 middle dot (0xB7)
+    t    
+  end
+
+  # Cleans up MS Word-style text, getting rid of things like em-dashes, smart quotes, etc..
+  def replace_wonky_characters_with_entities
+    t = self.to_s
+    t.gsub!("\342\200\042", "&ndash;")   # en-dash
+    t.gsub!("\342\200\041", "&mdash;")   # em-dash
+    t.gsub!("\342\200\174", "&hellip;")  # ellipsis
+    t.gsub!("\342\200\176", "&lsquo;")   # single quote
+    t.gsub!("\342\200\177", "&rsquo;")   # single quote
+    t.gsub!("\342\200\230", "&rsquo;")   # single quote
+    t.gsub!("\342\200\231", "&rsquo;")   # single quote
+    t.gsub!("\342\200\234", "&ldquo;")   # Double quote, right
+    t.gsub!("\342\200\235", "&rdquo;")   # Double quote, left
+    t.gsub!("\342\200\242", ".")
+    t.gsub!("\342\202\254", "&euro;");   # Euro symbol
+    t.gsub!(/\S\200\S/, " ")             # every other strange character send to the moon
+    t.gsub!("\176", "\'")  # single quote
+    t.gsub!("\177", "\'")  # single quote
+    t.gsub!("\205", "-")		# ISO-Latin1 horizontal elipses (0x85)
+    t.gsub!("\221", "\'")	# ISO-Latin1 left single-quote
+    t.gsub!("\222", "\'")	# ISO-Latin1 right single-quote
+    t.gsub!("\223", "\"")	# ISO-Latin1 left double-quote
+    t.gsub!("\224", "\"")	# ISO-Latin1 right double-quote
+    t.gsub!("\225", "\*")	# ISO-Latin1 bullet
+    t.gsub!("\226", "-")		# ISO-Latin1 en-dash (0x96)
+    t.gsub!("\227", "-")		# ISO-Latin1 em-dash (0x97)
+    t.gsub!("\230", "\'")  # single quote
+    t.gsub!("\231", "\'")  # single quote
+    t.gsub!("\233", ">")		# ISO-Latin1 single right angle quote
+    t.gsub!("\234", "\"")  # Double quote
+    t.gsub!("\235", "\"")  # Double quote
+    t.gsub!("\240", " ")		# ISO-Latin1 nonbreaking space
+    t.gsub!("\246", "\|")	# ISO-Latin1 broken vertical bar
+    t.gsub!("\255", "")	  # ISO-Latin1 soft hyphen (0xAD)
+    t.gsub!("\264", "\'")	# ISO-Latin1 spacing acute
+    t.gsub!("\267", "\*")	# ISO-Latin1 middle dot (0xB7)
+    t
+  end
+  
+  unless method_defined? "ends_with?"
+    # Snagged from Rails: http://api.rubyonrails.org/classes/ActiveSupport/CoreExtensions/String/StartsEndsWith.html#M000441
+    def ends_with?(suffix)
+      suffix = suffix.to_s
+      self[-suffix.length, suffix.length] == suffix
+    end
+  end
+  
+  unless method_defined? "starts_with?"
+    # Snagged from Rails: http://api.rubyonrails.org/classes/ActiveSupport/CoreExtensions/String/StartsEndsWith.html#M000441
+    def starts_with?(prefix)
+      prefix = prefix.to_s
+      self[0, prefix.length] == prefix
+    end
+  end
+  
+end
+
+class Array
+  
+  # Like Array.shift, but returns the array instead of removed the element.
+  def remove_first_element
+    self[1..self.size]
+  end
+
+  # Like Array.pop, but returns the array instead of removed the element.
+  def remove_last_element
+    self[0..self.size-2]
+  end
+  
+end
+
+class Object
+  
+  unless method_defined? "blank?"
+    # Snagged from Rails: http://api.rubyonrails.org/classes/Object.html#M000265
+    def blank?
+      respond_to?(:empty?) ? empty? : !self
+    end
+  end
+  
+end

data/spec/monkey_patches_spec.rb

@@ -0,0 +1,59 @@
+require 'spec_helper'
+
+describe "MonkeyPatches" do
+  
+  it "ellipsizes" do
+    "short thing".ellipsize.should == "short thing"
+    "0123456789ABCDEFGHIJ".ellipsize(:max => 9).should == "0123...GHIJ"
+    "0123456789ABCDEFGHIJ".ellipsize(:max => 10, :delimiter => "|").should == "01234|FGHIJ"
+  end
+
+  it "permalinkifies" do
+    "Dog Breath".permalinkify.should == "dog-breath"
+    "Shit for @@@ BRAINS!".permalinkify.should == "shit-for-brains"
+    " A REal Doozi\"e?  \' ".permalinkify.should == "a-real-doozie"
+  end
+
+  it "prepends http only if needed" do
+    "".add_http.should == ""
+    "dog".add_http.should == "http://dog"
+    "http://dog.com".add_http.should == "http://dog.com"
+    "https://dog.com".add_http.should == "https://dog.com"
+  end
+
+  it "removes http and www" do
+    "http://shitstorm.com".remove_http_and_www.should == "shitstorm.com"
+    "http://www.google.com".remove_http_and_www.should == "google.com"
+    "http://wwwxyz.com".remove_http_and_www.should == "wwwxyz.com"
+    "www.abc.com".remove_http_and_www.should == "abc.com"
+    "https://secure.com".remove_http_and_www.should == "secure.com"
+    "https://www.dubsecure.com".remove_http_and_www.should == "dubsecure.com"
+  end
+
+  it "truncates by words" do
+    #012345678901234567890123456789012345678901234567890123456789
+    "this is short. should be fine.".truncate_preserving_words.should == "this is short. should be fine."
+    "this is longer. will cut if we leave the default max_chars in place".truncate_preserving_words.should == "this is longer. will cut if we leave the default max_chars ..."
+    "this will get cut".truncate_preserving_words(:max_chars => 15, :end_string => "..").should == "this will get .."
+    "this doesn't have too many words".truncate_preserving_words(:max_words => 10).should == "this doesn't have too many words"
+    "this has too many words".truncate_preserving_words(:max_words => 3).should == "this has too ..."
+  end
+
+  it "replaces wonky characters with ascii" do
+    "\“Ulysses\”".replace_wonky_characters_with_ascii.should == "\"Ulysses\""
+    "We ‘are’ single".replace_wonky_characters_with_ascii.should == "We 'are' single"
+    "We ‘are’ single".replace_wonky_characters_with_ascii.should == "We 'are' single"
+  end
+  
+  # Array specs
+
+  it "removes first element" do
+    %w(1 2 3).remove_first_element.should == %w(2 3)
+  end
+
+  it "removes last element" do
+    %w(1 2 3).remove_last_element.should == %w(1 2)
+  end
+
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+require 'spec'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'monkey_patches'
+
+Spec::Runner.configure do |config|
+  
+end

metadata

@@ -0,0 +1,60 @@
+--- !ruby/object:Gem::Specification 
+name: zeke-monkey_patches
+version: !ruby/object:Gem::Version 
+  version: 0.1.4
+platform: ruby
+authors: 
+- Zeke Sikelianos
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-03-23 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: 
+email: zeke@sikelianos.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+- LICENSE
+files: 
+- README.rdoc
+- VERSION.yml
+- lib/monkey_patches.rb
+- spec/monkey_patches_spec.rb
+- spec/spec_helper.rb
+- LICENSE
+has_rdoc: true
+homepage: http://github.com/zeke/monkey_patches
+post_install_message: 
+rdoc_options: 
+- --inline-source
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: A handly collection of helper methods, primarily for String and Array
+test_files: []
+