sinatra-head 0.1.0

data/.document

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

data/.gitignore

@@ -0,0 +1,22 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+.rvmrc
+
+## PROJECT::SPECIFIC

data/LICENSE.markdown

@@ -0,0 +1,113 @@
+The Don't Be a Dick License
+===========================
+_version 0.2_
+
+**Project:** [Sinatra::Head](http://github.com/SFEley/sinatra-head)   
+**Author:** Stephen Eley (<sfeley@gmail.com>)
+
+This is a proposed draft of the **Don't Be a Dick** license for open source projects.  The purpose of this license is to permit the broadest feasible scope for reuse and modification of creative work, restricted only by the requirement that one is not a dick about it.
+
+1. Legal Parameters
+-------------------
+For legal purposes, the DBAD license is a superset of the [Apache License, Version 2.0][1] and incorporates all terms, conditions, privileges and limitations therein.  The following text is a binding part of this license for this project:
+
+> Copyright 2010 Stephen Eley
+
+> Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+>   <http://www.apache.org/licenses/LICENSE-2.0>
+
+> Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+  
+Nothing in the following text should be construed to inhibit, contradict, or override any part of the Apache License, Version 2.0.  
+
+2. Definitions
+--------------
+The following terms and definitions shall be in effect for the rest of this document.
+
+>  **NOTE:** Singular nouns and pronouns are used throughout this License for 
+  grammatical convenience.  However, any of the terms below _may_ refer to a
+  collective work or group of people.  If this pegs your punctiliousness, you
+  are directed to mentally substitute "Person _or persons_," "Dick _or 
+  dicks,_" etc., throughout this license.  Just don't tell us about it.
+
+### A. Project
+
+A creative work of (software | writing | visual art | music) into which significant time and energy have been invested by people who _are not you,_ and which has been released into the world for the benefit of the general public (_including you._)
+
+The **Project** may include, incorporate, derive from, or be inspired by other works.  The Author, being a Reasonable Person, has made use of such source materials only as permitted by their own licenses or applicable law.  The License you are reading applies only to those portions of the Project which are original and distinct to it.  Source materials may be covered by their own licenses or conditions, and should not be assumed to have coverage under this License.  (However, you are strongly encouraged not to be a dick about them either.)
+
+### B. Author
+
+A person who has invested significant time and energy into the Project licensed herein.  Given the Author's release of the Project to the world under a liberal license, the Author is declared a Reasonable Person (at least within this context) and inherits all attributes, freedoms, and responsibilities thereof.  No other assumptions are made about the Author, nor should you make any.
+
+### C. Reasonable Person
+
+A person who respects the time and energy that have been invested in the Project licensed herein, and acts accordingly.  A Reasonable Person is broadly characterized as one who exercises his or her privilege to use, _not_ use, redistribute, modify, improve, worsen, review, report issues upon, participate in the community of, or ignore the work _without_ placing undue demands upon the Author.  I.e., a Reasonable Person is a constituent of the majority of open source users and the population at large who are not Dicks.
+
+### D. Dick
+
+A person who _does not_ respect the time and energy that have been invested in the Project, and acts to punish such effort by giving others associated with the Project -- including, but not limited to, the Author -- a hard time.  A Dick is nearly always selfish, but not necessarily with deliberate intent; some Dicks are merely thoughtless.  The distinguishing characteristic of a Dick is that he or she places burdens upon Reasonable People, reducing their motivation to engage in open source activities.  This damping effect is a significant detriment to the Project, to open source in general, to the production of new intellectual value in the world -- and, ultimately, to the Dick himself or herself.
+
+>  **NOTE:** Despite its original gender association, the word "Dick" is used herein in a _cultural_ context and not a _genital_ context.  This License has chosen to adopt the term for its linguistic force and psychological impact, and sincerely regrets any inference of sexism.  For purposes of the terms and conditions contained herein, it is understood that both men and women are equally capable of being Dicks.  
+  
+>  (But they shouldn't be.)  
+  
+3. Permissions
+--------------
+
+The following privileges are granted explicitly and exclusively to Reasonable People.  Although the Author acknowledges the practical unfeasibility of barring Dicks from enjoying the same privileges, they are nevertheless asked to refrain from any activity related to the Project _and/or_ to reconsider their behavior and stop being Dicks.
+
+1. You are permitted to use the Project or any component of the Project.
+
+2. You are permitted to redistribute the Project or any component of the Project, by itself or as part of a different work, provided that you give fair and reasonable credit back to the Author.
+
+3. You are permitted to change the Project for your own needs or anyone else's.  You may keep your changes to yourself or submit them back to the Author or the community, as you see fit, provided you are not a Dick about it.
+
+4. You are permitted and encouraged to participate in any community related to the Project, or to create new communities.
+
+5. You are permitted to report issues or problems with the Project, and to request that they be addressed, so long as the request is made in a reasonable fashion.  (This privilege does _not_ oblige the Author to respond.)
+
+6. You are permitted to make money from the Project.  No recompense is owed to the Author unless by separate agreement, although sharing opportunities for mutual benefit is by no means discouraged.
+
+7. You are permitted to discuss the Project in any medium, in any positive or negative spirit, so long as criticism is not libelous nor _ad hominem._  (I.e., don't lie, and keep it about the _work_ and not the _people._)
+
+8. You are permitted to ignore the Project completely and make no use of it whatsoever.  This right is irrevocable and absolute, and extended to Dicks and Reasonable People alike.
+
+4. Limitations
+--------------
+
+The following restrictions are imposed explicitly and exclusively upon Dicks.  These limitations are the inverse of the above privileges and are also tautological, as the prohibited actions are those _definitive_ of Dickhood.
+
+1. You may not impede Reasonable People from exercising their privilege to use, redistribute, change, participate in, profit from, discuss, or ignore the Project.
+
+2. You may not withhold the Author's credit for the Project, nor otherwise present the work of anyone else as your own.
+
+3. You may not hold the Author responsible for any use or abuse of the Project by you or anyone else.
+
+4. You may not troll, flame, nor dumb down any community associated with the Project.
+
+5. Barring separate agreements, you may not _demand_ any time or attention on the part of the Author nor anyone else in the community.  You may not hold the Author personally accountable for any issues you discover nor otherwise spread your own problems to other people.
+
+6. You may not attempt to _compel_ time nor money from the Author nor any other community member by any means, including but not limited to legal action, intimidation, or annoyance.  
+
+7. You may not engage in _ad hominem_ (i.e. personal) attacks or criticism of the Author in the course of criticizing the Project.
+
+8. You may not impede the absolute and irrevocable privilege of the Author and other members of the community to ignore you.  
+
+5. Use of This License
+----------------------
+The Don't Be a Dick License is released under the terms of the Don't Be a Dick License. Projects released under this License should remain under the License, and the terms of the License may not be modified by anyone other than the Project's original Author.
+  
+If you wish to make use of the License for your own open work, you may do so without asking permission, provided said work is truly your own, truly open, and you are truly not a Dick. You may modify the terms of the License to suit your own needs, but are strongly advised to annotate said changes.  Modifications may not reduce the freedoms granted to Reasonable People as described in Section 3.
+
+Reasonable People are _invited,_ but not compelled, to visit the Web site at <http://dbad-license.org> and browse or add their project to the repository of works released under the License.
+ 
+
+[1]: http://apache.org/licenses/LICENSE-2.0

data/README.markdown

@@ -0,0 +1,169 @@
+Sinatra::Head
+=============
+             
+This is a simple asset and `<head>` tag manager for Sinatra projects.  It allows dynamically adding or 
+changing stylesheets, javascript includes, or the page title at any level of Sinatra class inheritance 
+or within an action.
+
+Setting Up
+----------
+You should know this part:
+    
+    $ gem install sinatra-head
+
+(Or `sudo gem install` if you're the last person on Earth who isn't using [RVM][1] yet.)
+
+If you're developing a Sinatra ['classic'][2] application, then all you need to do is require the library:
+
+    # blah_app.rb
+    require 'sinatra'
+    require 'sinatra/head'
+    
+    title << 'My Wonderful App'
+    stylesheets << 'main.css'
+      
+    get '/blah' do
+      title << 'Feeling blah'
+      stylesheets << 'blah.css'
+    end
+    
+Then, in your layout, just call the `head_tag` helper:
+
+    # views/layout.haml
+    %html
+      =head_tag
+      %body
+        =yield
+
+When called, you'll see a head that sets the charset to UTF-8, "**Feeling blah | My Wonderful App**" as the page title, and 
+includes both */stylesheets/main.css* and *stylesheets/blah.css*.  You can override the default choices here with Sinatra settings.
+
+If you're using the [Sinatra::Base][2] style, you also need to register the extension:
+
+    # bleh_app.rb
+    require 'sinatra/base'
+    require 'sinatra/head'
+    
+    class BlehApp < Sinatra::Base
+      register Sinatra::Head
+      
+      # Everything else is the same as the 'classic' example above.
+    end
+    
+See the Sinatra documentation on [using extensions][3] for more detail and rationale.
+
+Head element
+------------
+**Tag helpers:** `head_tag`
+
+This extension is all about the head and the layout.  Accordingly, there's a convenient `head_tag` helper that puts together the four other elements described below:
+
+    <head>
+      <meta charset='UTF-8' />
+      <title>All title elements | as appended using the 'title' call | in reverse order</title>
+      <link rel='stylesheet' href='/stylesheets/first.css' />
+      <!-- ...other stylesheets as declared in order... -->
+      <script src="/javascript/first.js"></script>
+      <!-- ...other javascripts as declared in order... -->
+    </head>
+    
+If you want something more or something different, you can of course skip this and call the other _*\_tag_ methods any way you want.
+
+*A note on style:* My markup flavor of choice is [HTML5][4]. HTML5 is backwards compatible with everything and does not require self-closing tags. However, some of you may be using XHTML, and I don't want to break your stuff over a minor religious difference. So the `meta` and `link` tags are self-closed, to keep your validators from complaining and because it doesn't really hurt anyone else.
+
+Charset
+-------
+**Sinatra settings:** `:charset`  
+**Tag helpers:** `charset_tag`
+
+It's best practice for all Web pages to declare their encoding -- even if the server _should_ be doing it, even if you only use ASCII, etc. etc. **Sinatra::Head** makes an opinionated choice and sets this to **utf-8** for you, but you can override it if you want:
+
+    set :charset, 'shift-jis'
+
+You are of course responsible for making sure that the page output keeps any encoding promise you make.  If you're using Ruby 1.9, it's a good idea to set the `Encoding.default_internal` value to utf-8 as well.  Also note that using Sinatra's **content_type** helper will override this for any page by setting the HTTP headers directly, which take precedence over `<meta>` tags.
+
+*A note on meta tags:* Someone is doubtless going to ask what happened to the _http-equiv_ or _content_ attributes. [This][5] is my short answer. If this fails to validate for any common use case, let me know.
+
+Title
+-----
+**Sinatra settings:** `:title`, `:title_separator`  
+**Data helpers:** `title`, `title=`, `title_string`  
+**Tag helpers:** `title_tag`
+
+Multi-part titles that describe the page, the category, and the site are standard practice for SEO and other reasons. **Sinatra::Head** manages this by setting up **title** as a Sinatra setting with an empty array and letting you add to it:
+
+    title << 'Site'
+    title << 'Page' # => 'Page | Site'
+
+Note that the title chain unspools in LIFO order, not FIFO.  (I.e., it's a stack, not a queue.)
+
+If you want to blow away this chain for a single action, we do have a `title=` helper for the purpose. You can also change the separator from ` | ` to anything you want with the `:title_separator` setting.
+
+Stylesheets
+-----------
+**Sinatra settings:** `:stylesheets`, `:stylesheet_path`  
+**Data helpers:** `stylesheets`, `expand_stylesheet_path`  
+**Tag helpers:** `stylesheet_tag`, `stylesheet_tags`
+
+Like the _title_ setting, the _stylesheets_ setting begins life as an empty array.  Thus, you can add sheets to it at any time.  Simple filenames will have the *stylesheet_path* setting prepended for a consistent relative path (it defaults simply to _"stylesheets"_); hyperlinks beginning with `http:` or `https:` will not be touched.
+
+    stylesheets << 'main.css'
+    stylesheets << 'http://someothersite.org/popular_css_extension.css'
+    
+    get '/blah' do
+      stylesheets << 'specific.css'
+    end
+
+In your layout, you can call the `stylesheet_tag` helper for a single filename or URL you provide, or the `stylesheet_tags` helper which walks the array and creates a tag for each.  (In FIFO or queue order, unlike _title._)
+
+Currently nothing is done for nicer asset packaging, fingerprinting, compressing, etc. There's [Rack][10] [middleware][9] for some of it, and future iterations may include these features. If you'd really really like to see them, [create an issue][7] and ask for them.
+
+Javascripts
+-----------
+**Sinatra settings:** `:javascripts`, `:javascript_path`  
+**Data helpers:** `javascripts`, `expand_javascript_path`  
+**Tag helpers:** `javascript_tag`, `javascript_tags`
+
+These helpers are functionally very similar to the _stylesheets_ ones, allowing the addition of relative filenames (which will be expanded with the *javascript_path* setting) or full URLs.  One wrinkle here is that you can _also_ include inline code:
+
+    javascripts << 'main.js'
+    javascripts << 'http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js'
+    
+    get '/blah' do
+      javascripts << %q[
+        window.onload = function(){
+          some_silly_thing;
+        };]
+    end
+
+Inline code is detected by the presence of a semicolon, and will be included as the body of the `<script>` tag rather than as the **src=** attribute.  (So if you have semicolons in your scripts' filenames or URLs...  _What were you thinking?_)
+
+As noted above for stylesheets, right now there are no facilities to minify, compress, or recombobulate your Javascript. Also as noted, [feel free to ask][7] or contribute.
+
+Credit, Support, and Contributions
+----------------------------------
+This extension is the fault of **Stephen Eley**. You can reach me at <sfeley@gmail.com>. If you like science fiction stories, I know a [good podcast][6] for them as well.
+
+If you find bugs, please report them on the [Github issue tracker][7]. 
+
+The documentation can of course be found on [RDoc.info][8].
+
+Contributions are welcome. This was a quick start to get me some features I needed in a complex stack of Sinatra apps. There's a lot more that _can_ be done on this, but I'll keep sniffing the wind to find out what _should_ be done.
+
+License
+-------
+This project is licensed under the **Don't Be a Dick License**, version 0.2, and is copyright 2010 by Stephen Eley. See the [LICENSE.markdown][11] file or the [DBAD License site][12] for elaboration on not being a dick.
+
+
+[1]: http://rvm.beginrescueend.com
+[2]: https://sinatra.lighthouseapp.com/projects/9779/tickets/240-sinatrabase-vs-sinatradefault-vs-sinatraapplication
+[3]: http://www.sinatrarb.com/extensions-wild.html
+[4]: http://diveintohtml5.org/semantics.html
+[5]: http://diveintohtml5.org/semantics.html#encoding
+[6]: http://escapepod.org
+[7]: http://github.com/SFEley/sinatra-head/issues
+[8]: http://rdoc.info/projects/SFEley/sinatra-head
+[9]: http://coderack.org/users/chriskottom/middlewares/66-rackdomainsprinkler
+[10]: http://rack.rubyforge.org/doc/Rack/Static.html
+[11]: http://github.com/SFEley/sinatra-head/blob/master/LICENSE.markdown
+[12]: http://dbad-license.org

data/Rakefile

@@ -0,0 +1,48 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "sinatra-head"
+    gem.summary = %Q{A Sinatra extension that gets inside your <HEAD>.}
+    gem.description = %Q{Sinatra::Head provides class methods and helpers for dynamically controlling the fields in your <HEAD> element that are usually preset in your layout: the page title, stylesheet and javascript assets, etc.  Asset lists are inherited throughout superclasses, subclasses, and within action methods, and basic asset path management is supported.}
+    gem.email = "sfeley@gmail.com"
+    gem.homepage = "http://github.com/SFEley/sinatra-head"
+    gem.authors = ["Stephen Eley"]
+    gem.add_development_dependency "rspec", ">= 1.2.9"
+    gem.add_development_dependency "yard", ">= 0"
+    gem.add_development_dependency "haml", ">= 3"
+    gem.add_development_dependency "capybara", ">= 0.3.8"
+    
+    # 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
+
+begin
+  require 'yard'
+  YARD::Rake::YardocTask.new
+rescue LoadError
+  task :yardoc do
+    abort "YARD is not available. In order to run yardoc, you must: sudo gem install yard"
+  end
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/sinatra/head.rb

@@ -0,0 +1,39 @@
+require 'sinatra/base'
+
+require 'sinatra/head/data_helpers'
+require 'sinatra/head/tag_helpers'
+
+module Sinatra
+  module Head
+    
+    # # Exposes the 'title' setting so that it can be overwritten or appended to.
+    # # @see DataHelpers#title
+    # def title
+    #   settings.title
+    # end
+    # 
+    # # Exposes the 'stylesheets' setting so that it can be overwritten or appended to.
+    # # @see DataHelpers#stylesheets
+    # def stylesheets
+    #   settings.stylesheets
+    # end
+    
+    def self.registered(app)
+      app.helpers DataHelpers
+      app.helpers TagHelpers
+      
+      app.configure do
+        app.set :charset, 'utf-8'
+
+        app.set :title, []
+        app.set :title_separator, ' | '
+        
+        app.set :stylesheets, []
+        app.set :stylesheet_path, '/stylesheets'
+        
+        app.set :javascripts, []
+        app.set :javascript_path, '/javascript'        
+      end
+    end
+  end
+end

data/lib/sinatra/head/data_helpers.rb

@@ -0,0 +1,94 @@
+module Sinatra
+  module Head
+    
+    # Helpers intended to be used in your Sinatra actions rather than your views.  (Yes, you can use them both places,
+    # but setting any of these in a view _after_ your layout's rendered the <head> element is sort of pointless.)
+    module DataHelpers
+      # Exposes an array of title elements that you can read or add to.  Can be set at both the class and
+      # instance (action) level.
+      #
+      # @example Recommended usage
+      #   class MyApp < Sinatra::Base
+      #     register Sinatra::Head
+      #     title << 'My Application'
+      #     
+      #     get '/people' do
+      #       title << 'Directory'
+      #     end
+      #   end
+      #
+      # This will create a title by default that looks like:
+      #   Directory | My Application
+      def title
+        @title ||= Array(settings.title.clone)
+      end
+      
+      # Overrides any title elements you've already set.  It's more conventional to use the << operator instead.
+      def title=(val)
+        @title = Array(val)
+      end
+      
+      # Returns the title elements you've set, in reverse order, separated by ' | '.  (You can override this with
+      # a Sinatra option: `set :title_separator, ' <*> '`)
+      def title_string
+        title.reverse.join(settings.title_separator)
+      end
+      
+      # Exposes an array of stylesheets.  Can be set at both the class and the instance (action) level.
+      # Full hyperlinks or relative filenames can be set; if relative, the final result will include the
+      # Sinatra stylesheet_path setting.
+      # @example Recommended usage
+      #   class MyApp < Sinatra::Base
+      #     register Sinatra::Head
+      #     stylesheets << 'main.css'
+      #     stylesheets << 'http://example.org/some_famous_grid_stylesheet.css'
+      #
+      #     get '/form' do
+      #       stylesheets << 'form.css'
+      #     end
+      #   end
+      def stylesheets
+        @stylesheets ||= Array(settings.stylesheets.clone)
+      end
+      
+      # Returns the full path for a stylesheet's filename, with the Sinatra `stylesheet_path` setting
+      # prepending it.  Full hyperlinks are not altered.
+      def expand_stylesheet_path(sheet)
+        if sheet =~ %r{^https?://}
+          sheet
+        else
+          File.join(settings.stylesheet_path, sheet)
+        end
+      end
+      
+      # Exposes an array of javascript sources.  Can be set at both the class and the instance (action) level.
+      # Full hyperlinks or relative filenames can be set; if relative, the final result will include the
+      # Sinatra stylesheet_path setting.
+      # @example Recommended usage
+      #   class MyApp < Sinatra::Base
+      #     register Sinatra::Head
+      #     javascripts << 'main.js'
+      #     javascripts << 'http://example.org/some_popular_script.js'
+      #
+      #     get '/form' do
+      #       javascripts << 'form.js'
+      #     end
+      #   end
+      def javascripts
+        @javascripts ||= Array(settings.javascripts.clone)
+      end
+      
+      # Returns the full path for a javascript source's filename, with the Sinatra `javascript_path` setting
+      # prepending it.  Full hyperlinks are not altered.
+      def expand_javascript_path(script)
+        if script =~ %r{^https?://}
+          script
+        else
+          File.join(settings.javascript_path, script)
+        end
+      end
+      
+    end
+    
+  end
+end

data/lib/sinatra/head/tag_helpers.rb

@@ -0,0 +1,72 @@
+require 'sinatra/head/data_helpers'
+
+# Helper methods 
+module Sinatra
+  module Head
+    # Methods intended for view or layout templates, to generate the usual set of metadata and include tags.
+    module TagHelpers
+      
+      # Spits out a default <head> element which incorporates the <meta> and <title> elements as well as any given
+      # stylesheet or Javascript includes.  This is a convenience; if there are other things you want in your head,
+      # there's no need to use this instead of making your own inside your layout.
+      def head_tag
+        <<-HEAD_TAG
+        <head>
+          #{charset_tag}
+          #{title_tag}
+          #{stylesheet_tags}
+          #{javascript_tags}
+        </head>
+        HEAD_TAG
+      end
+      
+      # Spits out a <meta> tag with the named charset.  Defaults to UTF-8, but you can override it 
+      # with the Sinatra 'charset' setting.
+      def charset_tag
+        "<meta charset='#{settings.charset}' />"
+      end
+      
+      # Spits out a <title> element with anything that's been added to the title by various actions.
+      # The title array is treated like a stack; items are popped off of it in reverse order of 
+      # inclusion.
+      def title_tag
+        "<title>#{title_string}</title>"
+      end
+
+      # Spits out a <link rel='stylesheet'> element for the given stylesheet reference.
+      # Relative filenames will be expanded with the Sinatra assets path, if set.
+      #
+      # @param [String] sheet
+      def stylesheet_tag(sheet)
+        "<link rel='stylesheet' href='#{expand_stylesheet_path(sheet)}' />"
+      end
+      
+      # Spits out stylesheet tags for all declared stylesheets, one per line.
+      def stylesheet_tags
+        stylesheets.collect{|s| stylesheet_tag(s)}.join("\n")
+      end
+      
+      # Spits out a <script src='filename'> element for the given javascript file.
+      # Relative filenames will be expanded with the Sinatra assets path, if set.
+      # 
+      # EXCEPTION: If an item in 'javascripts' contains a semicolon, it will be interpreted
+      # as Javascript source code instead of a filename, and will be included inline in the
+      # script tag instead of on the 'src' element.
+      # 
+      # @param [String] script
+      def javascript_tag(script)
+        if script.include?(';')
+          "<script>\n#{script}\n</script>"
+        else
+          "<script src='#{expand_javascript_path(script)}'></script>"
+        end
+      end
+      
+      # Spits out javascript tags for all declared scripts, one per line.
+      def javascript_tags
+        javascripts.collect{|s| javascript_tag(s)}.join("\n")
+      end
+      
+    end
+  end
+end

data/spec/sinatra/head_spec.rb

@@ -0,0 +1,43 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Sinatra::Head do
+  include DummyFixture
+  
+  before(:each) do
+    visit '/'
+  end
+  
+  it "displays the head" do
+    page.should have_css('head')
+  end
+  
+  it "has a title element" do
+    within 'head' do
+      page.should have_css('title')
+    end
+  end
+  
+  it "has a meta tag for the charset" do
+    within 'head' do
+      page.should have_css("meta[charset='utf-8']")
+    end
+  end
+  
+  it "lets you override the charset" do
+    class DummyGrandkid < DummyFixture::DummyChild
+      set :charset, 'iso-8859-1'
+      get '/new' do
+        title << 'Really Low Level'
+        haml "This is something new."
+      end
+    end
+    app DummyGrandkid
+
+    visit '/'
+    within 'head' do
+      page.should have_css("meta[charset='iso-8859-1']")
+    end    
+  end
+  
+  
+end

data/spec/sinatra/javascripts_spec.rb

@@ -0,0 +1,67 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Sinatra::Head, "javascripts" do
+  include DummyFixture
+  
+  
+  class DummyFixture::DummyApp
+    javascripts << 'main.js'
+  end
+  
+  class DummyFixture::DummyChild
+    javascripts << 'secondary.js'
+    set :javascript_path, '/things/javascript'
+  end
+  
+  before(:each) do
+    app DummyFixture::DummyChild
+    @instance = app.new
+  end
+  
+  it "can be appended to in a top-level class" do
+    @instance.javascripts.should include('main.js')
+  end
+  
+  it "can be appended to in a subclass" do
+    @instance.javascripts.should include('secondary.js')
+  end
+  
+  it "can be appended to in an instance" do
+    @instance.javascripts << 'specific.js'
+    @instance.javascripts.should == ['main.js', 'secondary.js', 'specific.js']
+  end
+
+  
+  it "expands the assets path for relative filenames" do
+    @instance.expand_javascript_path(@instance.javascripts.first).should == '/things/javascript/main.js'
+  end
+  
+  it "leaves fully qualified hyperlinks intact" do
+    @instance.javascripts << 'http://google.com/google_script.js'
+    @instance.expand_javascript_path(@instance.javascripts[2]).should == 'http://google.com/google_script.js'
+  end
+  
+  it "knows how to make a tag" do
+    @instance.javascript_tag(@instance.javascripts.first).should == "<script src='/things/javascript/main.js'></script>"
+  end
+  
+  it "can make a tag for inline code" do
+    @instance.javascripts << "window.onload=alert('This is a page!');"
+    @instance.javascript_tag(@instance.javascripts[2]).should == "<script>\nwindow.onload=alert('This is a page!');\n</script>"
+  end
+  
+  
+  it "knows how to make all the tags" do
+    @instance.javascripts << 'http://yahoo.com/yahoo_script.js'
+    @instance.javascript_tags.should == "<script src='/things/javascript/main.js'></script>\n<script src='/things/javascript/secondary.js'></script>\n<script src='http://yahoo.com/yahoo_script.js'></script>"
+  end
+  
+  it "shows up in the header" do
+    visit '/'
+    within 'head' do
+      page.should have_css("script[src='/things/javascript/main.js']")
+      page.should have_css("script[src='/things/javascript/secondary.js']")
+    end
+  end
+  
+end

data/spec/sinatra/stylesheet_spec.rb

@@ -0,0 +1,62 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Sinatra::Head, "stylesheets" do
+  include DummyFixture
+  
+  
+  class DummyFixture::DummyApp
+    stylesheets << 'main.css'
+  end
+  
+  class DummyFixture::DummyChild
+    stylesheets << 'secondary.css'
+    set :stylesheet_path, '/stuff/stylesheets'
+  end
+  
+  before(:each) do
+    app DummyFixture::DummyChild
+    @instance = app.new
+  end
+  
+  it "can be appended to in a top-level class" do
+    @instance.stylesheets.should include('main.css')
+  end
+  
+  it "can be appended to in a subclass" do
+    @instance.stylesheets.should include('secondary.css')
+  end
+  
+  it "can be appended to in an instance" do
+    @instance.stylesheets << 'specific.css'
+    @instance.stylesheets.should == ['main.css', 'secondary.css', 'specific.css']
+  end
+
+  
+  it "expands the assets path for relative filenames" do
+    @instance.expand_stylesheet_path(@instance.stylesheets.first).should == '/stuff/stylesheets/main.css'
+  end
+  
+  it "leaves fully qualified hyperlinks intact" do
+    @instance.stylesheets << 'http://google.com/google_style.css'
+    @instance.expand_stylesheet_path(@instance.stylesheets[2]).should == 'http://google.com/google_style.css'
+  end
+  
+  it "knows how to make a tag" do
+    @instance.stylesheet_tag(@instance.stylesheets.first).should == "<link rel='stylesheet' href='/stuff/stylesheets/main.css' />"
+  end
+  
+  it "knows how to make all the tags" do
+    @instance.stylesheets << 'http://yahoo.com/yahoo_style.css'
+    @instance.stylesheet_tags.should == "<link rel='stylesheet' href='/stuff/stylesheets/main.css' />\n<link rel='stylesheet' href='/stuff/stylesheets/secondary.css' />\n<link rel='stylesheet' href='http://yahoo.com/yahoo_style.css' />"
+  end
+  
+  it "shows up in the header" do
+    visit '/'
+    within 'head' do
+      page.should have_css("link[rel='stylesheet'][href='/stuff/stylesheets/main.css']")
+      page.should have_css("link[rel='stylesheet'][href='/stuff/stylesheets/secondary.css']")
+    end
+
+  end
+  
+end

data/spec/sinatra/title_spec.rb

@@ -0,0 +1,68 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Sinatra::Head, "titles" do
+  include DummyFixture
+  
+  
+  class DummyFixture::DummyApp
+    title << 'High Level'
+  end
+  
+  class DummyFixture::DummyChild
+    title << 'Mid-Level'
+  end
+  
+  before(:each) do
+    @instance = app.new
+  end
+  
+  it "can be appended to in a top-level class" do
+    @instance.title.should include('High Level')
+  end
+  
+  it "can be appended to in a subclass" do
+    @instance.title.should include('Mid-Level')
+  end
+  
+  it "can be appended to in an instance" do
+    @instance.title << 'Low Level'
+    @instance.title.should == ['High Level', 'Mid-Level', 'Low Level']
+  end
+  
+  it "can be overridden" do
+    @instance.title = 'Kaboom!'
+    @instance.title.should == ['Kaboom!']
+  end
+  
+  it "returns itself as a string" do
+    @instance.title << 'Low Level'
+    @instance.title_string.should == 'Low Level | Mid-Level | High Level'
+  end
+  
+  it "can set a different title separator" do
+    class DummyGrandkid < DummyFixture::DummyChild
+      set :title_separator, ' <*> '
+    end
+    
+    instance = DummyGrandkid.new
+    instance.title_string.should == 'Mid-Level <*> High Level'
+  end
+    
+  it "knows how to make a tag" do
+    @instance.title_tag.should == '<title>Mid-Level | High Level</title>'
+  end
+  
+  it "shows up in the title tag" do
+    class DummyGrandkid < DummyFixture::DummyChild
+      get '/new' do
+        title << 'Really Low Level'
+        haml "This is something new."
+      end
+    end
+    app DummyGrandkid
+
+    visit '/new'
+    page.locate('title').text.should == 'Really Low Level | Mid-Level | High Level'
+  end
+  
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,27 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'rack/test'
+require 'spec'
+require 'spec/autorun'
+require 'capybara'
+require 'capybara/dsl'
+
+require 'sinatra/head'
+require 'support/dummy_app'
+
+Spec::Runner.configure do |config|
+  include Rack::Test::Methods
+  include Capybara
+  Capybara.default_selector = :css
+end
+
+# Confirm our dummy app
+describe "Dummy app" do
+  include DummyFixture
+  
+  it "returns a page" do
+    app DummyApp
+    visit('/')
+    page.should have_content('Hello dummy')
+  end
+end

data/spec/support/dummy_app.rb

@@ -0,0 +1,38 @@
+require 'sinatra/base'
+
+module DummyFixture
+  # A simple dummy app to perform our tests against. We make our templates out of strings so that we
+  # can change them easily in our tests.
+  class DummyApp < Sinatra::Base
+    set :environment, :test
+    enable :inline_templates
+  
+    register Sinatra::Head
+  
+    get "/" do
+      haml :index
+    end
+  end
+  
+  class DummyChild < DummyApp
+  end
+  
+  def app(klass=nil)
+    if klass
+      Capybara.app = klass
+    else
+      Capybara.app ||= DummyChild
+    end
+  end
+end
+
+__END__
+
+@@ layout
+%html
+  =head_tag
+  %body
+    = yield
+
+@@ index
+Hello dummy!

data/spec/title_spec.rb

@@ -0,0 +1,5 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe "title" do
+  
+end

metadata

@@ -0,0 +1,149 @@
+--- !ruby/object:Gem::Specification 
+name: sinatra-head
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Stephen Eley
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-05-20 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 13
+        segments: 
+        - 1
+        - 2
+        - 9
+        version: 1.2.9
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: yard
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: haml
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 5
+        segments: 
+        - 3
+        version: "3"
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: capybara
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        - 3
+        - 8
+        version: 0.3.8
+  type: :development
+  version_requirements: *id004
+description: "Sinatra::Head provides class methods and helpers for dynamically controlling the fields in your <HEAD> element that are usually preset in your layout: the page title, stylesheet and javascript assets, etc.  Asset lists are inherited throughout superclasses, subclasses, and within action methods, and basic asset path management is supported."
+email: sfeley@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.markdown
+- README.markdown
+files: 
+- .document
+- .gitignore
+- LICENSE.markdown
+- README.markdown
+- Rakefile
+- VERSION
+- lib/sinatra/head.rb
+- lib/sinatra/head/data_helpers.rb
+- lib/sinatra/head/tag_helpers.rb
+- spec/sinatra/head_spec.rb
+- spec/sinatra/javascripts_spec.rb
+- spec/sinatra/stylesheet_spec.rb
+- spec/sinatra/title_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- spec/support/dummy_app.rb
+- spec/title_spec.rb
+has_rdoc: true
+homepage: http://github.com/SFEley/sinatra-head
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: A Sinatra extension that gets inside your <HEAD>.
+test_files: 
+- spec/sinatra/head_spec.rb
+- spec/sinatra/javascripts_spec.rb
+- spec/sinatra/stylesheet_spec.rb
+- spec/sinatra/title_spec.rb
+- spec/spec_helper.rb
+- spec/support/dummy_app.rb
+- spec/title_spec.rb