site_meta 0.2.0 → 0.3.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,4 @@
+doc
+pkg
+*~
+*.gem

data/History.txt

@@ -1,5 +1,7 @@
-== 0.2
+== 0.3.0
+ * Uses tag and content_tag when available (in Rails for example)
+== 0.2.0
  * Added documentation
  * meta_keywords now allows multiple arguments, strips spaces
-== 0.1
+== 0.1.0
 First public release of helpers

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Łukasz Piestrzeniewicz
+
+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/Manifest.txt

@@ -0,0 +1,5 @@
+History.txt
+init.rb
+lib/site_meta.rb
+rails/init.rb
+README.rdoc

data/README.rdoc

@@ -49,11 +49,11 @@ In your view:
 
 (The MIT License)
 
-Copyright (c) 2009 Lukasz Piestrzeniewicz
+Copyright (c) 2009 Łukasz Piestrzeniewicz
 
 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
+"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
@@ -62,10 +62,10 @@ 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,
+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.
+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,49 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "site_meta"
+    gem.summary = %Q{helpers for easy adding of html meta information in web applications}
+    gem.description = %Q{Provides helpers for easy adding of html meta information to Rails applications.
+ * Easily add default description and keywords meta tags.
+ * Customize meta tags on per-view basis
+ * Add head title tag with breadcrubms
+ * Add page title}
+    gem.email = "bragi@ragnarson.com"
+    gem.homepage = "http://github.com/bragi/site_meta"
+    gem.authors = ["Łukasz Piestrzeniewicz"]
+    gem.add_development_dependency "rspec", ">= 1.2.9"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "site_meta #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.3.0

data/lib/site_meta.rb

@@ -190,7 +190,7 @@ module SiteMeta
   end
 
   def meta_tag(name, content, key='name') #:nodoc:
-    if defined?(ActionView::Base)
+    if respond_to?(:tag)
       tag 'meta', key => name, :content => content
     else
       "<meta #{key}=\"#{name}\" content=\"#{content}\" />"
@@ -198,7 +198,11 @@ module SiteMeta
   end
 
   def title_tag(content) #:nodoc:
-    "<title>#{content}</title>"
+    if respond_to?(:content_tag)
+      content_tag "title", content
+    else
+      "<title>#{content}</title>"
+    end
   end
 
 end

data/script/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+# File: script/console
+irb = RUBY_PLATFORM =~ /(:?mswin|mingw)/ ? 'irb.bat' : 'irb'
+
+libs =  " -r irb/completion"
+# Perhaps use a console_lib to store any extra methods I may want available in the cosole
+# libs << " -r #{File.dirname(__FILE__) + '/../lib/console_lib/console_logger.rb'}"
+libs <<  " -r #{File.dirname(__FILE__) + '/../lib/site_meta.rb'}"
+puts "Loading site_meta gem"
+exec "#{irb} #{libs} --simple-prompt"

data/script/destroy

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/destroy'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Destroy.new.run(ARGV)

data/script/generate

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/generate'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Generate.new.run(ARGV)

data/site_meta.gemspec

@@ -0,0 +1,67 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{site_meta}
+  s.version = "0.3.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["\305\201ukasz Piestrzeniewicz"]
+  s.date = %q{2010-05-20}
+  s.description = %q{Provides helpers for easy adding of html meta information to Rails applications.
+ * Easily add default description and keywords meta tags.
+ * Customize meta tags on per-view basis
+ * Add head title tag with breadcrubms
+ * Add page title}
+  s.email = %q{bragi@ragnarson.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "History.txt",
+     "LICENSE",
+     "Manifest.txt",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "init.rb",
+     "lib/site_meta.rb",
+     "rails/init.rb",
+     "script/console",
+     "script/destroy",
+     "script/generate",
+     "site_meta.gemspec",
+     "spec/site_meta_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb",
+     "tasks/rspec.rake"
+  ]
+  s.homepage = %q{http://github.com/bragi/site_meta}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{helpers for easy adding of html meta information in web applications}
+  s.test_files = [
+    "spec/site_meta_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+    else
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+  end
+end
+

data/spec/site_meta_spec.rb

@@ -0,0 +1,169 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+class SiteMetaInstance
+  include SiteMeta
+end
+
+class NilClass
+  def blank?
+    true
+  end
+end
+
+describe SiteMeta do
+  before(:each) do
+    @helper = SiteMetaInstance.new
+  end
+  
+  it "should use given name and content for meta tag" do
+    @helper.meta_tag(:description, "Default").should == '<meta name="description" content="Default" />'
+  end
+  
+  it "should use provided content for title tag" do
+    @helper.title_tag("Content").should == "<title>Content</title>"
+  end
+  
+  describe "when used in ActionPack context" do
+    it "should use tag for meta" do
+      @helper.should_receive(:respond_to?).with(:tag).and_return(true)
+      @helper.should_receive("tag").with("meta", {"name" => :description, :content => "Default"})
+      @helper.meta_tag(:description, "Default")
+    end
+    
+    it "should use content_tag for title" do
+      @helper.should_receive(:respond_to?).with(:content_tag).and_return(true)
+      @helper.should_receive("content_tag").with("title", "Content")
+      @helper.title_tag("Content")
+    end
+  end
+  
+  describe "when providing description" do
+    it "should accept empty default description" do
+      @helper.meta_description
+    end
+    
+    it "should not insert empty description meta tag" do
+      @helper.meta_description.should be_blank
+    end
+    
+    it "should use default description" do
+      @helper.meta_description("Default").should == @helper.meta_tag(:description, "Default")
+    end
+    
+    it "should use provided description" do
+      @helper.set_meta_description("Non-default")
+      @helper.meta_description("Default").should == @helper.meta_tag(:description, "Non-default")
+    end
+  end
+
+  describe "when providing keywords" do
+    it "should accept empty default keywords" do
+      @helper.meta_keywords
+    end
+    
+    it "should not insert empty keywords meta tag" do
+      @helper.meta_keywords.should be_blank
+    end
+    
+    it "should use default keywords" do
+      @helper.meta_keywords("default,keywords").should == @helper.meta_tag(:keywords, "default,keywords")
+    end
+    
+    it "should use default when provided as array" do
+      @helper.meta_keywords(["default", "keywords"]).should == @helper.meta_tag(:keywords, "default,keywords")
+    end
+
+    it "should strip keywords" do
+      @helper.meta_keywords("default , keywords").should == @helper.meta_tag(:keywords, "default,keywords")
+    end
+
+    it "should merge provided keywords by default" do
+      @helper.set_meta_keywords("non,default")
+      @helper.meta_keywords("default,keywords").should == @helper.meta_tag(:keywords, "non,default,keywords")
+    end
+
+    it "should set keywords as array" do
+      @helper.set_meta_keywords(["non", "default"])
+      @helper.meta_keywords("default,keywords").should == @helper.meta_tag(:keywords, "non,default,keywords")
+    end
+
+    it "should strip set keywords" do
+      @helper.set_meta_keywords(["non ", " default"])
+      @helper.meta_keywords("default,keywords").should == @helper.meta_tag(:keywords, "non,default,keywords")
+    end
+
+    it "should merge provided keywords" do
+      @helper.set_meta_keywords("non,default", :merge)
+      @helper.meta_keywords("default,keywords").should == @helper.meta_tag(:keywords, "non,default,keywords")
+    end
+
+    it "should replace provided keywords" do
+      @helper.set_meta_keywords("non,default", :replace)
+      @helper.meta_keywords("default,keywords").should == @helper.meta_tag(:keywords, "non,default")
+    end
+
+    it "should reject unknown merge mode" do
+      lambda {
+        @helper.set_meta_keywords("non,default", :overwrite)
+      }.should raise_error(ArgumentError, "Allowed merge modes are only :replace, :merge")
+    end
+  end
+  
+  describe "when providing head title" do
+    it "should provide default title" do
+      @helper.head_title("Site name").should == @helper.title_tag("Site name")
+    end
+    
+    it "should accept string as title" do
+      @helper.set_head_title("Page title")
+      @helper.head_title("Site name").should == @helper.title_tag("Page title - Site name")
+    end
+    
+    it "should accept array as title" do
+      @helper.set_head_title(["Page title"])
+      @helper.head_title("Site name").should == @helper.title_tag("Page title - Site name")
+    end
+    
+    it "should accept multiple entries as title" do
+      @helper.set_head_title(["Item title", "View title"])
+      @helper.head_title("Site name").should == @helper.title_tag("Item title - View title - Site name")
+    end
+
+    it "should accept multiple entries as title without array" do
+      @helper.set_head_title("Item title", "View title")
+      @helper.head_title("Site name").should == @helper.title_tag("Item title - View title - Site name")
+    end
+
+    it "should use custom separator" do
+      @helper.set_head_title("Page title")
+      @helper.head_title("Site name", " &raquo; ").should == @helper.title_tag("Page title &raquo; Site name")
+    end
+  end
+  
+  describe "when providing page title" do
+    it "should use given title" do
+      @helper.set_page_title("Page title")
+      @helper.page_title.should == "Page title"
+    end
+  end
+  
+  describe "when providing page and head title" do
+    it "should accept string title" do
+      @helper.set_head_and_page_title("Page title")
+      @helper.page_title.should == "Page title"
+      @helper.head_title("Site name").should == @helper.title_tag("Page title - Site name")
+    end
+    
+    it "should accept array title" do
+      @helper.set_head_and_page_title(["Item title", "View title"])
+      @helper.page_title.should == "Item title"
+      @helper.head_title("Site name").should == @helper.title_tag("Item title - View title - Site name")
+    end
+    
+    it "should accept multiple elements title" do
+      @helper.set_head_and_page_title("Item title", "View title")
+      @helper.page_title.should == "Item title"
+      @helper.head_title("Site name").should == @helper.title_tag("Item title - View title - Site name")
+    end
+  end
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--colour

data/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+begin
+  require 'spec'
+rescue LoadError
+  require 'rubygems'
+  gem 'rspec'
+  require 'spec'
+end
+
+$:.unshift(File.dirname(__FILE__) + '/../lib')
+require 'site_meta'

data/tasks/rspec.rake

@@ -0,0 +1,21 @@
+begin
+  require 'spec'
+rescue LoadError
+  require 'rubygems'
+  require 'spec'
+end
+begin
+  require 'spec/rake/spectask'
+rescue LoadError
+  puts <<-EOS
+To use rspec for testing you must install rspec gem:
+    gem install rspec
+EOS
+  exit(0)
+end
+
+desc "Run the specs under spec/models"
+Spec::Rake::SpecTask.new do |t|
+  t.spec_opts = ['--options', "spec/spec.opts"]
+  t.spec_files = FileList['spec/**/*_spec.rb']
+end

metadata

@@ -1,91 +1,100 @@
 --- !ruby/object:Gem::Specification 
 name: site_meta
 version: !ruby/object:Gem::Version 
-  version: 0.2.0
+  prerelease: false
+  segments: 
+  - 0
+  - 3
+  - 0
+  version: 0.3.0
 platform: ruby
 authors: 
-- Lukasz Piestrzeniewicz
+- "\xC5\x81ukasz Piestrzeniewicz"
 autorequire: 
 bindir: bin
 cert_chain: []
 
-date: 2009-01-08 00:00:00 +01:00
+date: 2010-05-20 00:00:00 +02:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
-  name: actionpack
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.0.0
-    version: 
-- !ruby/object:Gem::Dependency 
-  name: newgem
+        segments: 
+        - 1
+        - 2
+        - 9
+        version: 1.2.9
   type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 1.1.0
-    version: 
-- !ruby/object:Gem::Dependency 
-  name: hoe
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 1.8.0
-    version: 
-description: Provides helpers for easy adding of html meta information to Rails applications.
-email: 
-- bragi@ragnarson.com
+  version_requirements: *id001
+description: |-
+  Provides helpers for easy adding of html meta information to Rails applications.
+   * Easily add default description and keywords meta tags.
+   * Customize meta tags on per-view basis
+   * Add head title tag with breadcrubms
+   * Add page title
+email: bragi@ragnarson.com
 executables: []
 
 extensions: []
 
 extra_rdoc_files: 
-- History.txt
+- LICENSE
 - README.rdoc
 files: 
+- .document
+- .gitignore
 - History.txt
+- LICENSE
+- Manifest.txt
+- README.rdoc
+- Rakefile
+- VERSION
 - init.rb
 - lib/site_meta.rb
 - rails/init.rb
-- README.rdoc
+- script/console
+- script/destroy
+- script/generate
+- site_meta.gemspec
+- spec/site_meta_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- tasks/rspec.rake
 has_rdoc: true
 homepage: http://github.com/bragi/site_meta
 licenses: []
 
 post_install_message: 
 rdoc_options: 
-- --main
-- README.rdoc
+- --charset=UTF-8
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      segments: 
+      - 0
       version: "0"
-  version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      segments: 
+      - 0
       version: "0"
-  version: 
 requirements: []
 
-rubyforge_project: site_meta
-rubygems_version: 1.3.5
+rubyforge_project: 
+rubygems_version: 1.3.6
 signing_key: 
-specification_version: 2
-summary: Provides helpers for easy adding of html meta information to Rails applications.
-test_files: []
-
+specification_version: 3
+summary: helpers for easy adding of html meta information in web applications
+test_files: 
+- spec/site_meta_spec.rb
+- spec/spec_helper.rb