hoshi 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 221a93d1028f8a61613f742d6d260f5678e83b1f
-  data.tar.gz: 10addb7f304cb7fc5f533e77b48fae2442df608a
+  metadata.gz: d94fffbfa325feff79de2aa56200eabbb6b6cd3f
+  data.tar.gz: ea241fff24e0384e17ee484a25ae8b2ce0c7bee3
 SHA512:
-  metadata.gz: a3e4b240018e7bc059f8eaa810c0c280587df6336645c44a5911d6a8b5fb9f41c44db2f934beb1eb5ec80c8f4375088d436f064b6b54d8bd10a6a4fde3422552
-  data.tar.gz: dc0fb5a542d44f605f9133668c092ef1d03a745c76ef0bd2ed3ccd9528edc53477e4d251a67cd238c62d52fa5654a5b5bed7ed3afe07855821114f077b4b58ad
+  metadata.gz: e28120927da5cd877dae48cd6c2df0ac23f27525af4927337b6240720c53b4f695f71c21934981048fce6ec954671ccbd80168d4ef7363c3155af03556b8cf2c
+  data.tar.gz: 275632c8f6190be96e463cc3f4318c52f0ededd275691e7db76e37fc6a06e804f020f13e230bc8c9de7af36371ceb6fab4c769f1b055253344c39b321734b71b

data/README

@@ -0,0 +1,194 @@
+= Hoshi
+
+== Summary
+
+Hoshi is a library for creating real, first-class HTML/XML views.  So,
+unlike template libraries, you can take advantage of mixins,
+inheritance, and all the other wonderful features of Ruby's object
+system.  There is also support for easy RSS feeds and CGI.
+
+Hoshi is designed to:
+	* Generate clean HTML/XHTML/XML with minimal effort
+	* Be easy for a coder to use and understand
+	* Take full advantage of Ruby's object sytem
+	* Be more readable and easier to write than bare HTML
+
+It is semi-modeled after Markaby, but with a much more straightforward
+implementation and different semantics (e.g., no instance_eval, so scope
+inside a tag is as expected).
+
+See doc/LICENSE for the license, doc/examples for examples.
+
+== Installation
+
+You can install via rubygems,
+
+  gem install hoshi
+
+or by downloading from github (http://github.com/pete/hoshi).
+
+== Usage
+
+These examples and more featured in the fabulous doc/examples directory.
+Also, there is a program included called html2hoshi (and associated
+lib/html2hoshi.rb; see Hoshi.from_html) that takes HTML as input and
+converts it to Ruby code using Hoshi.
+
+=== Class-based
+
+These should be fairly straightforward:
+
+  require 'hoshi'
+
+  class Trivial < Hoshi::View :html5
+    def show
+      doctype
+      html {
+        head {
+          title "Hello, world!"
+          link :rel => 'stylesheet', :href => '/css/hoshi.css'
+        }
+
+        body {
+          h1 "Hello, world!"
+          p "This is a greeting to the world."
+        }
+      }
+      render
+    end
+  end
+
+  puts Trivial.new.show
+
+You can get a little more complicated:
+
+  require 'hoshi'
+  require 'cgi'
+
+  module Layout
+    def main_page(t)
+      doctype
+      html {
+        head {
+          title t
+          script(:type => 'text/javascript') {
+            raw "alert(\"Hi, I'm some javascript, I suppose.\");"
+          }
+        }
+        
+        body {
+          h1 t, :class => 'page_title'
+
+          yield
+        }
+      }
+    end
+
+    def list_page(t)
+      main_page(t) {
+        ul {
+          yield
+        }
+      }
+    end
+  end
+
+
+  class Fibonacci < Hoshi::View :xhtml1
+    include Layout
+
+    def list_page(n)
+      super("Fibonacci: f(0)..f(#{n})") {
+        fib_upto(n).map { |i| li i.to_s }
+      }
+      CGI.pretty(render)
+    end
+
+    private
+
+    def fib_upto n
+      a = Array.new(n) 
+      
+      0.upto(n) { |i|
+        a[i] = 
+          if i < 2
+            1
+          else
+            a[i - 1] + a[i - 2]
+          end
+      }
+
+      a
+    end
+  end
+
+  puts Fibonacci.new.list_page(n)
+
+=== Block-based
+
+For simpler cases where you only intend to produce markup, perhaps for use as a templating engine.
+
+  require 'hoshi'
+
+  str = Hoshi::View::HTML5.build {
+    doctype
+    html {
+      head {
+        title "Hello, world!"
+        link :rel => 'stylesheet', :href => '/css/hoshi.css'
+      }
+
+      body {
+        h1 "Hello, world!"
+        p "This is a greeting to the world."
+      }
+    }
+  }
+
+  puts str
+
+== Bugs
+
+There needs to be some work done on correcting the tags; I suspect I'm
+missing or miscategorizing some of them.
+
+I'd like to perhaps add a layer for serializing objects in the standard
+HTML5 method (i.e., the Schema.org/microdata stuff).  That's very
+speculative at the moment.
+
+There are some requirements that were expedient at the time (requiring
+metaid and hpricot, embedding the gemspec in the Rakefile, etc.) that
+could use cleanup.  Hash is monkey-patched, and using the new Ruby 2
+refinements feature would be nicer.
+
+== Credits
+
+Author:
+Pete Elmore -- (pete(a)debu.gs)
+
+Pretty heavily indebted to:
+_why the lucky stiff's Markaby library
+
+Initial design discussion:
+Dan Yoder
+
+Simple block version:
+Nolan Darilek -- (nolan(a)thewordnerd.info)
+
+Homie that be lookin' out for my broken deps:
+Lars Lethonen
+
+The guys that paid me to do the initial version:
+AT&T Interactive.
+
+Also, I guess I should credit Attractive Eighties Women
+(http://attractiveeightieswomen.com/), since I was blasting them the
+whole time I was developing this.  Like, over and over.  I couldn't stop
+listening.  My friends and family are becoming concerned.  I don't feel
+that I am yet ready to take the first step by admitting there is a
+problem.  Intervention may be required.  This paragraph should probably
+be considered a cry for help.
+
+== Home page
+
+http://debu.gs/hoshi

data/Rakefile

@@ -8,7 +8,7 @@ spec = Gem::Specification.new { |s|
 	s.email = "pete@debu.gs"
 	s.files = Dir["{lib,doc,bin,ext}/**/*"].delete_if {|f| 
 		/\/rdoc(\/|$)/i.match f
-	} + %w(Rakefile)
+	} + %w(Rakefile README)
 	s.require_path = 'lib'
 	s.has_rdoc = true
 	s.extra_rdoc_files = Dir['doc/*'].select(&File.method(:file?))
@@ -20,7 +20,7 @@ spec = Gem::Specification.new { |s|
 	s.summary = "Nice, object-oriented, first-class views."
 	s.homepage = "http://debu.gs/#{s.name}"
 	%w(metaid hpricot).each &s.method(:add_dependency)
-	s.version = '1.0.0'
+	s.version = '1.0.1'
 }
 
 Gem::PackageTask.new(spec) { |pkg|

data/doc/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2008,2013 Peter Elmore (pete at debu.gs)
+Copyright (c) 2008,2013 Pete Elmore (pete at debu.gs)
 
 Permission is hereby granted, free of charge, to any person obtaining a
 copy of this software and associated documentation files (the "Software"),

data/lib/hoshi/monkey_patches.rb

@@ -1,9 +1,15 @@
 class Hash
 	# Makes this hash fit to be put into a tag.
-	# { :a => 1, :b => "two" }.to_html_options # => 'a="one" b="two"'
+	# { :a => 1, :b => "two", :c => true }.to_html_options # => 'a="one" b="two" c'
 	def to_html_options double_quotes = true
 		qchar = double_quotes ? '"' : "'"
-		map { |k,v| "#{k}=#{qchar}#{v}#{qchar}" }.join(' ')
+		map { |k,v|
+			if v == true
+				k.to_s
+			else
+				"#{k}=#{qchar}#{v}#{qchar}"
+			end
+		}.join(' ')
 	end
 end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hoshi
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Pete Elmore
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-09-18 00:00:00.000000000 Z
+date: 2013-09-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: metaid
@@ -77,6 +77,7 @@ files:
 - doc/TODO
 - bin/html2hoshi
 - Rakefile
+- README
 homepage: http://debu.gs/hoshi
 licenses: []
 metadata: {}