titleize 1.0.0

data.tar.gz.sig

@@ -0,0 +1 @@
+G*�~e쫇���kx �lvѪQ|:���C=-W/L���(#�N��LgS�{��`=��씯<��0}�<�r��k�N��th��V��y%�Y�S�@������8�]���(%�5-lX�|�?-�졉�ʒ��s�,t;��<��[z�:�{y6�voUk�s&M�:[�m	��ё�.�������������^��f��4Αo�\�Uq�`����L�>b��a�9�r�	�3q'%�����!��(

data/History.txt

@@ -0,0 +1,5 @@
+=== 1.0.0 / 2008-05-22
+
+* Hoe-ized for RubyGemming
+
+

data/Manifest.txt

@@ -0,0 +1,8 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/titleize.rb
+spec/spec.opts
+spec/spec/titleize_spec.rb
+spec/spec_helper.rb

data/README.txt

@@ -0,0 +1,50 @@
+= Titleize
+
+* http://rubyforge.org/projects/titleize/
+
+== DESCRIPTION:
+
+Adds String#titleize for creating properly capitalized titles.
+It can be called as Titleize.titleize or "a string".titleize. It is also
+aliased as titlecase.
+
+The list of "small words" which are not capped comes from the New York Times 
+Manual of Style, plus 'vs' and 'v'.
+
+If loaded in a Rails environment, it modifies Inflector.titleize.
+
+Based on TitleCase.pl by John Gruber.
+http://daringfireball.net/2008/05/title_case
+
+== SYNOPSIS:
+
+  "a lovely and talented title".titleize # => "A Lovely and Talented Title"
+
+== INSTALL:
+
+* gem install titleize
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 Grant Hollingworth
+
+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/Rakefile

@@ -0,0 +1,21 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/titleize.rb'
+require 'spec/rake/spectask'
+
+Hoe.new('titleize', Titleize::VERSION) do |p|
+  p.developer("Grant Hollingworth", "grant@antiflux.org")
+  p.remote_rdoc_dir = '' # Release to root
+end
+
+desc "Run all specs"
+Spec::Rake::SpecTask.new('spec') do |t|
+  t.spec_files = FileList['spec/**/*.rb']
+  t.spec_opts = ['--options', "spec/spec.opts"]
+end
+
+task :default => [:spec]
+
+# vim: syntax=Ruby

data/lib/titleize.rb

@@ -0,0 +1,103 @@
+# Adds String#titleize for creating properly capitalized titles.
+# It can be called as Titleize.titleize or "a string".titleize.
+#
+# titlecase is included as an alias for titleize.
+#
+# If loaded in a Rails environment, it modifies Inflector.titleize.
+module Titleize
+  VERSION = '1.0.0'
+  SMALL_WORDS = %w{a an and as at but by en for if in of on or the to v v. via vs vs.}
+
+  extend self
+
+  # Capitalizes most words to create a nicer looking title string.
+  #
+  # The list of "small words" which are not capped comes from
+  # the New York Times Manual of Style, plus 'vs' and 'v'.
+  #
+  #   "notes on a scandal" # => "Notes on a Scandal"
+  #   "the good german"    # => "The Good German"
+  def titleize(title)
+    phrases(title).map do |phrase|
+      words = phrase.split
+      words.map do |word|
+        def word.capitalize
+          # like String#capitalize, but it starts with the first letter
+          self.sub(/[[:alpha:]].*/) {|subword| subword.capitalize}
+        end
+
+        case word
+        when /[[:alpha:]]\.[[:alpha:]]/  # words with dots in, like "example.com"
+          word
+        when /^[[:alpha:]].*[[:upper:]]/ # non-first letter capitalized already
+          word
+        when words.first, words.last
+          word.capitalize
+        when *(SMALL_WORDS + SMALL_WORDS.map {|small| small.capitalize })
+          word.downcase
+        else
+          word.capitalize
+        end
+      end.join(" ")
+    end.join(" ")
+  end
+
+  # Splits a title into an array based on punctuation.
+  #
+  #   "simple title"              # => ["simple title"]
+  #   "more complicated: titling" # => ["more complicated:", "titling"]
+  def phrases(title)
+    phrases = title.scan(/.+?(?:[:.;?!] |$)/).map {|phrase| phrase.strip }
+
+    # rejoin phrases that were split on the '.' from a small word
+    if phrases.size > 1
+      phrases[0..-1].each_with_index do |phrase, index|
+        if SMALL_WORDS.include?(phrase.split.last.downcase)
+          phrases[index] << " " + phrases.slice!(index + 1)
+        end
+      end
+    end
+
+    phrases
+  end
+end
+
+class String
+  # Capitalizes most words to create a nicer looking title string.
+  #
+  # The list of "small words" which are not capped comes from
+  # the New York Times Manual of Style, plus 'vs' and 'v'.
+  #
+  # titleize is also aliased as titlecase.
+  #
+  #   "notes on a scandal" # => "Notes on a Scandal"
+  #   "the good german"    # => "The Good German"
+  def titleize
+    Titleize.titleize(self)
+  end
+  alias_method :titlecase, :titleize
+end
+
+if defined? Inflector
+  module Inflector
+    extend self
+
+    # Capitalizes most words to create a nicer looking title string.
+    #
+    # The list of "small words" which are not capped comes from
+    # the New York Times Manual of Style, plus 'vs' and 'v'.
+    #
+    # This replaces the default Rails titleize. Like the default, it uses
+    # Inflector.underscore and Inflector.humanize to convert
+    # underscored_names and CamelCaseNames to a more human form.
+    #
+    # titleize is also aliased as titlecase.
+    #
+    #   "notes on an active_record" # => "Notes on an Active Record"
+    #   "the GoodGerman"            # => "The Good German"
+    def titleize(title)
+      Titleize.titleize(Inflector.humanize(Inflector.underscore(title)))
+    end
+    alias_method :titlecase, :titleize
+  end
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--format specdoc --colour

data/spec/spec/titleize_spec.rb

@@ -0,0 +1,198 @@
+module Inflector
+  #stub
+end
+
+require File.dirname(__FILE__) + "/../spec_helper.rb"
+
+SMALL_WORDS = %w{a an and as at but by en for if in of on or the to v v. via vs vs.}
+
+describe Titleize do
+  describe "phrases" do
+    it "should return an array" do
+      phrases("a little sentence").should be_an_instance_of(Array)
+    end
+
+    it "should split on colons" do
+      phrases("this: a subphrase").should == ["this:", "a subphrase"]
+    end
+
+    it "should split on semi-colons" do
+      phrases("this; that").should == ["this;", "that"]
+    end
+
+    it "should split on question marks" do
+      phrases("this? that").should == ["this?", "that"]
+    end
+
+    it "should split on periods" do
+      phrases("this. that.").should == ["this.", "that."]
+    end
+
+    it "should split on exclamation marks" do
+      phrases("headache! yes").should == ["headache!", "yes"]
+    end
+
+    it "should rejoin into the original string" do
+      title = "happy: not sad; pushing! laughing? ok."
+      phrases(title).join(" ").should == title
+    end
+
+    it "should not get confused by small words with punctuation" do
+      phrases("this vs. that").should == ["this vs. that"]
+      phrases("this vs. that. no").should == ["this vs. that.", "no"]
+      phrases("this: that vs. him. no. why?").should ==
+        ["this:", "that vs. him.", "no.", "why?"]
+    end
+  end
+
+  describe "titleize" do
+    it "should return a string" do
+      titleize("this").should be_an_instance_of(String)
+    end
+
+    it "should capitalize the first letter of regular words" do
+      titleize("cat beats monkey").should == "Cat Beats Monkey"
+    end
+
+    it "should not capitalize small words" do
+      SMALL_WORDS.each do |word|
+        titleize("first #{word} last").should == "First #{word} Last"
+      end
+    end
+
+    it "should downcase a small word if it is capitalized" do
+      SMALL_WORDS.each do |word|
+        titleize("first #{word.capitalize} last").should == "First #{word} Last"
+      end
+    end
+
+    it "should capitalize a small word if it is the first word" do
+      SMALL_WORDS.each do |word|
+        titleize("#{word} is small").should == "#{word.capitalize} Is Small"
+        titleize("after: #{word} ok").should == "After: #{word.capitalize} Ok"
+        titleize("after; #{word} ok").should == "After; #{word.capitalize} Ok"
+        titleize("after. #{word} ok").should == "After. #{word.capitalize} Ok"
+        titleize("after? #{word} ok").should == "After? #{word.capitalize} Ok"
+        titleize("after! #{word} ok").should == "After! #{word.capitalize} Ok"
+      end
+    end
+
+    it "should capitalize a small word if it is the last word" do
+      SMALL_WORDS.each do |word|
+        titleize("small #{word}").should == "Small #{word.capitalize}"
+      end
+    end
+
+    it "should not screw up acronyms" do
+      titleize("the SEC's decision").should == "The SEC's Decision"
+    end
+
+    it "should not capitalize words with dots" do 
+      titleize("del.icio.us web site").should == "del.icio.us Web Site"
+    end
+
+    it "should not think a quotation mark makes a dot word" do
+      titleize("'quoted.' yes.").should == "'Quoted.' Yes."
+      titleize("ends with 'quotation.'").should == "Ends With 'Quotation.'"
+    end
+
+    it "should not capitalize words that have a lowercase first letter" do 
+      titleize("iTunes").should == "iTunes"
+    end
+
+    # http://daringfireball.net/projects/titlecase/examples-edge-cases
+    it "should handle edge cases" do
+      {
+        %{Q&A With Steve Jobs: 'That's What Happens In Technology'} =>
+          %{Q&A With Steve Jobs: 'That's What Happens in Technology'},
+
+        %{What Is AT&T's Problem?} => %{What Is AT&T's Problem?},
+
+        %{Apple Deal With AT&T Falls Through} =>
+        %{Apple Deal With AT&T Falls Through},
+
+        %{this v that}   => %{This v That},
+        %{this vs that}  => %{This vs That},
+        %{this v. that}  => %{This v. That},
+        %{this vs. that} => %{This vs. That},
+
+        %{The SEC's Apple Probe: What You Need to Know} =>
+          %{The SEC's Apple Probe: What You Need to Know},
+
+        %{'by the Way, small word at the start but within quotes.'} =>
+          %{'By the Way, Small Word at the Start but Within Quotes.'},
+
+        %{Small word at end is nothing to be afraid of} =>
+          %{Small Word at End Is Nothing to Be Afraid Of},
+
+        %{Starting Sub-Phrase With a Small Word: a Trick, Perhaps?} =>
+        %{Starting Sub-Phrase With a Small Word: A Trick, Perhaps?},
+
+        %{Sub-Phrase With a Small Word in Quotes: 'a Trick, Perhaps?'} =>
+        %{Sub-Phrase With a Small Word in Quotes: 'A Trick, Perhaps?'},
+
+        %{Sub-Phrase With a Small Word in Quotes: "a Trick, Perhaps?"} =>
+        %{Sub-Phrase With a Small Word in Quotes: "A Trick, Perhaps?"},
+
+        %{"Nothing to Be Afraid of?"} => %{"Nothing to Be Afraid Of?"},
+        %{"Nothing to Be Afraid Of?"} => %{"Nothing to Be Afraid Of?"},
+        %{a thing} => %{A Thing},
+
+        %{'Gruber on OmniFocus and Vapo(u)rware'} =>
+        %{'Gruber on OmniFocus and Vapo(u)rware'},
+      }.each do |before, after|
+        titleize(before).should == after
+      end
+    end
+  end
+
+  it "should have titleize as a singleton method" do
+    Titleize.singleton_methods.should include("titleize")
+  end
+end
+
+describe Inflector do
+  describe "titleize" do
+    before(:each) do
+      @title = "active_record and ActiveResource"
+    end
+
+    it "should call humanize and underscore like the default in Rails" do
+      underscored_title = "active_record and active_resource"
+      humanized_title = "Active record and active resource"
+      Inflector.should_receive(:underscore).with(@title).and_return(underscored_title)
+      Inflector.should_receive(:humanize).with(underscored_title).and_return(humanized_title)
+      titleize(@title).should == "Active Record and Active Resource"
+    end
+
+    it "should replace Inflector.titleize" do
+      Titleize.should_receive(:titleize).with(@title)
+      Inflector.stub!(:underscore).and_return(@title)
+      Inflector.stub!(:humanize).and_return(@title)
+      Inflector.titleize(@title)
+    end
+
+    it "should be aliased as titlecase" do
+      Inflector.singleton_methods.should include("titlecase")
+      Inflector.stub!(:titlecase).and_return("title")
+      Inflector.stub!(:titleize).and_return("title")
+      Inflector.titlecase("this").should == Inflector.titleize("this")
+    end
+  end
+end
+
+describe String do
+  it "should have a titleize method" do
+    String.instance_methods.should include("titleize")
+  end
+
+  it "should work" do
+    "this is a test".titleize.should == "This Is a Test"
+  end
+
+  it "should be aliased as #titlecase" do
+    String.instance_methods.should include("titlecase")
+    title = "this is a pile of testing text"
+    title.titlecase.should == title.titleize
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+dir = File.dirname(__FILE__)
+lib_path = File.expand_path("#{dir}/../lib")
+$LOAD_PATH.unshift lib_path unless $LOAD_PATH.include?(lib_path)
+
+require 'titleize'

metadata

@@ -0,0 +1,93 @@
+--- !ruby/object:Gem::Specification 
+name: titleize
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Grant Hollingworth
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDMjCCAhqgAwIBAgIBADANBgkqhkiG9w0BAQUFADA/MQ4wDAYDVQQDDAVncmFu
+  dDEYMBYGCgmSJomT8ixkARkWCGFudGlmbHV4MRMwEQYKCZImiZPyLGQBGRYDb3Jn
+  MB4XDTA4MDUyMjE3MTUzMloXDTA5MDUyMjE3MTUzMlowPzEOMAwGA1UEAwwFZ3Jh
+  bnQxGDAWBgoJkiaJk/IsZAEZFghhbnRpZmx1eDETMBEGCgmSJomT8ixkARkWA29y
+  ZzCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAK/iuhFkPtanxhB6Ee7Z
+  t/wG8go7TMNR9R7BBnR72CX0K+y5he/3z9y1l4rojCDbKb8mHMkvlETvmRmpM0DR
+  3xbZbLnMv5rxWAhviD1gRcYKbKkiPCmCTftOlS338DF/8GBDkPXZu7nejNLhupKB
+  uEYAy1ba1ZD1a2VRQRXNtNvMtBGibncPnLOCgjoKb9a8LWJIqLGejBwsKU9SoJkm
+  uG+PW9VpzoTmjKE1lMjzgvV5dWpNibOQEf7gar02UP/Fr9QalK+CfzlabPYex5KE
+  Tkv8SF702tePizkXEQihZsBSJVMH/8LDEPGLHpqSQ3HL8iQBH4w15QKIuCetVG1Q
+  iUECAwEAAaM5MDcwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0OBBYEFIsp
+  OtbjXDikKb9j+TIWqyB1X6bcMA0GCSqGSIb3DQEBBQUAA4IBAQAHIP292bO01VoL
+  ppuXmlPDW9GvYpQurK0zpDbzw/FlFIwhnbym3MntzcOfyVKfXUUfhUjIPhPmQ4Ax
+  QEPyZriTgmk1UfdxcjFPYEUz+kL3k6G4jOwN1qYGD6sCW0AHe5S93Bw81fXz7v2w
+  TMg1zy30CHct6LkhYSvdAmBSQdB+JROCGQ+87bYP5UmmwD7UM+lep61LbMhlJCJq
+  SdS8+20R/tshERtF5QHqRLlB2bIO7eRBJ9eR/bRqUw5O9wrp/owFE1W5P/k8HkK6
+  GHeVld4eadHrZPAOvHz4O1kUZca/DXaUkjn0yDoEOR/vXr5/WdPas6fyWM7k1YOR
+  OQhV/wB5
+  -----END CERTIFICATE-----
+
+date: 2008-05-22 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.5.3
+    version: 
+description: Adds String#titleize for creating properly capitalized titles. It can be called as Titleize.titleize or "a string".titleize. It is also aliased as titlecase.  The list of "small words" which are not capped comes from the New York Times  Manual of Style, plus 'vs' and 'v'.  If loaded in a Rails environment, it modifies Inflector.titleize.  Based on TitleCase.pl by John Gruber. http://daringfireball.net/2008/05/title_case
+email: 
+- grant@antiflux.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- lib/titleize.rb
+- spec/spec.opts
+- spec/spec/titleize_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://rubyforge.org/projects/titleize/
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+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: titleize
+rubygems_version: 1.0.1
+signing_key: 
+specification_version: 2
+summary: Adds String#titleize for creating properly capitalized titles
+test_files: []
+

metadata.gz.sig

@@ -0,0 +1,3 @@
+�J �E�)E������?l��qw�b�f2�#���ٳ��y�k�L
+_��ށ��Gl�X��筥TRuq�}�9���-�Nc7<f"��ThWc�C�g�˾՞��$?���Z�(,d�ud�ۖ_���`t��+�=J�
+%��p�u�s����ϯ����.��h���l�n��T������/��w��j�3�boy���o��o�2V�g┿���ݢ6�CA���'�}QĪ;c���
?jt��(<%