ratpack 0.1.0 → 0.1.1

data/README.rdoc

@@ -1,6 +1,6 @@
 = ratpack
 
-Common Rails view helpers, rewritten and wrapped up in a gem for use in your Sinatra app.
+A set of view helpers for Sinatra. Inspired by Rails' ActionView helpers.
 
 == Installation
 
@@ -15,6 +15,7 @@ Install the ratpack gem:
   
 Drop this line in your app:
 
+  gem 'ratpack'
   require 'sinatra/ratpack'
 
 == Usage
@@ -25,6 +26,7 @@ See auto-generated documentation at {rdoc.info/projects/zeke/ratpack}[http://rdo
 
 * Thanks to the Sinatra page on {Writing Extensions}[http://www.sinatrarb.com/extensions.html]
 * The url_for method was snagged from {http://github.com/emk/sinatra-url-for/}[github.com/emk/sinatra-url-for]
+* Tests modified from {http://github.com/wbzyl/sinatra-static-assets/}[wbzyl/sinatra-static-assets]
 * Gem built with {http://github.com/technicalpickles/jeweler/}[Jeweler]
 
 == Copyright

data/lib/sinatra/ratpack.rb

@@ -5,6 +5,10 @@ module Sinatra
 
     # Accepts a single filename or an array of filenames (with or without .js extension)
     # Assumes javascripts are in public/javascripts
+    #
+    #   javascript_include_tag "jquery.min"               # <script charset="utf-8" src="/javascripts/jquery.min.js" type="text/javascript"></script>
+    #   javascript_include_tag "jquery.min.js"            # <script charset="utf-8" src="/javascripts/jquery.min.js" type="text/javascript"></script>
+    #   javascript_include_tag %w(day night)              # <script charset="utf-8" src="/javascripts/day.js" type="text/javascript"></script>\n<script charset="utf-8" src="/javascripts/night.js" type="text/javascript"></script>
     def javascript_include_tag(string_or_array, *args)
       files = string_or_array.is_a?(Array) ? string_or_array : [string_or_array]
       options = {
@@ -22,6 +26,9 @@ module Sinatra
   
     # Accepts a single filename or an array of filenames (with or without .css extension)
     # Assumes stylesheets are in public/stylesheets
+    #
+    #   stylesheet_link_tag "styles", :media => "print"   # <link charset="utf-8" href="/stylesheets/styles.css" media="print" rel="stylesheet" type="text/css" />
+    #   stylesheet_link_tag %w(winter summer)             # <link charset="utf-8" href="/stylesheets/winter.css" media="projection" rel="stylesheet" type="text/css" />\n<link charset="utf-8" href="/stylesheets/summer.css" media="projection" rel="stylesheet" type="text/css" />
     def stylesheet_link_tag(string_or_array, *args)
       files = string_or_array.is_a?(Array) ? string_or_array : [string_or_array]
       options = {
@@ -40,12 +47,20 @@ module Sinatra
     end
         
     # Accepts a full URL, an image filename, or a path underneath /public/images/
+    #
+    #   image_tag "pony.png"                        # <image src="/images/pony.png" />
+    #   image_tag "http://foo.com/pony.png"         # <image src="http://foo.com/pony.png" />
     def image_tag(src, options={})
+      src = "/images/#{src}" unless src.include? "://" # Add images directory to path if not a full URL
       options[:src] = url_for(src)
       tag(:img, options)
     end
     
     # Works like link_to, but href is optional. If no href supplied, content is used as href
+    #
+    #   link_to "grub", "/food", :class => "eats"   # <a href="/food" class="eats">grub</a>
+    #   link_to "http://foo.com"                    # <a href="http://foo.com">http://foo.com</a>
+    #   link_to "home"                              # <a href="/home">home</a>
     def link_to(content,href=nil,options={})
       href ||= content
       options.update :href => url_for(href)
@@ -53,26 +68,18 @@ module Sinatra
     end
   
     # Just like Rails' content_tag
+    #
+    #   content_tag :div, "hello", :id => "foo"     # <div id="foo">hello</div>
     def content_tag(name,content,options={})
       "<#{name} #{options.to_html_attrs}>#{content}</#{name}>"
     end
   
     # Just like Rails' tag
+    #
+    #   tag :br, :class => "foo"                    # <br class="foo" />
     def tag(name,options={})
       "<#{name} #{options.to_html_attrs} />"
     end
-
-    # Give this helper an array, and get back a string of <li> elements. 
-    # The first item gets a class of first and the last, well.. last. 
-    # This makes it easier to apply CSS styles to lists, be they ordered or unordered.
-    def convert_to_list_items(items)
-      items.inject([]) do |all, item|
-        css = []
-        css << "first" if items.first == item
-        css << "last" if items.last == item
-        all << content_tag(:li, item, :class => css.join(" "))
-      end.join("\n")
-    end
     
     # Construct a link to +url_fragment+, which should be given relative to
     # the base of this Sinatra app.  The mode should be either
@@ -81,10 +88,10 @@ module Sinatra
     # include the site name and port number.  (The latter is typically
     # necessary for links in RSS feeds.)  Example usage:
     #
-    #   url_for "/"                       # Returns "/myapp/"
-    #   url_for "/foo"                    # Returns "/myapp/foo"
-    #   url_for "/foo", :full             # Returns "http://example.com/myapp/foo"
-    #   url_for "http://bar.com"          # Returns "http://bar.com"
+    #   url_for "/"                                 # "/myapp/"
+    #   url_for "/foo"                              # "/myapp/foo"
+    #   url_for "/foo", :full                       # "http://example.com/myapp/foo"
+    #   url_for "http://bar.com"                    # "http://bar.com"
     def url_for url_fragment, mode=:path_only
       return url_fragment if url_fragment.include? "://"
       url_fragment = "/#{url_fragment}" unless url_fragment.starts_with? "/"

data/test/sinatra_app.rb

@@ -17,7 +17,7 @@ end
 get "/image_tag" do
   content_type "text/plain"
   <<"EOD"
-#{image_tag("/images/foo.jpg", :alt => "[foo image]")}
+#{image_tag("foo.jpg", :alt => "[foo image]")}
 EOD
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: ratpack
 version: !ruby/object:Gem::Version 
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors: 
 - Zeke Sikelianos
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-10-26 00:00:00 -07:00
+date: 2009-10-29 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency