pollock 0.1.2

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Gavin Montague
+
+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/README.markdown

@@ -0,0 +1,3 @@
+# Pollock
+
+For now, see index.html in public, or visit [http://www.leftbrained.co.uk/pollock/](http://www.leftbrained.co.uk/pollock/)

data/Rakefile

@@ -0,0 +1,61 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "pollock"
+    gem.summary = %Q{Generate placeholders for html wireframing without going near Photoshop}
+    gem.description = %Q{A little Sinatra and RMagick to generate placeholder images via an http call.  Heavily inspired by http://placehold.it}
+    gem.email = "gavin@leftbrained.co.uk"
+    gem.homepage = "http://github.com/govan/pollock"
+    gem.authors = ["Gavin Montague"]
+    
+    gem.add_development_dependency "thoughtbot-shoulda", ">= 0"
+    gem.add_dependency "rmagick", ">= 0"
+    gem.add_dependency "sinatra", ">= 0"
+    
+    gem.executables = "pollockserver"
+    
+    gem.files =  FileList["[A-Z]*", "{bin,lib,public,test}/**/*", 'lib/jeweler/templates/.gitignore']
+    
+    
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "pollock #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.2

data/bin/pollockserver

@@ -0,0 +1,36 @@
+#!/usr/bin/env ruby
+ 
+$:.unshift File.dirname(__FILE__) + "/../lib/pollock"
+ 
+require 'optparse'
+require 'rubygems'
+require 'sinatra'
+require 'image'
+
+# Argument defaults
+options = { :port => 1912}
+ 
+# Get arguments
+opts = OptionParser.new do |o|
+  o.banner = "usage: pollockserver [options]" 
+  #
+  o.on("--port", "change the port from pollock's default of 1912") do
+    options[:port] = 1912
+  end
+  #
+  o.on_tail("-h", "--help", "show this message") do
+    puts opts
+    exit
+  end
+  
+  # Version
+  # o.on_tail("-v", "--version", "show version") do
+  #   # TODO
+  #   exit
+  # end
+end
+ 
+opts.parse! # Parse arguments into `options` hash
+
+require 'webapp' # and start it rolling...
+Sinatra::Application.run!

data/lib/pollock/image.rb

@@ -0,0 +1,90 @@
+require 'RMagick'
+module Pollock
+  class Image
+    
+    DEFAULT_COLOUR = "#CCCCCC"
+    FONT = "georgia"
+    
+    attr_accessor :height, :width, :text, :colour, :format
+    def initialize(args={})
+      args = build_args_from_string(args) if args.is_a? String
+      raise ArgumentError.new("Image requires at least a size :height=>300") unless (args[:height]||args[:width]).to_i >0
+      self.height = (args[:height]||args[:width]).to_i
+      self.width = (args[:width]||args[:height]).to_i
+      self.text = args[:text]
+      self.colour = args[:colour]
+      self.format = args[:format]||'jpg'
+    end
+    
+    def format=(new_format)
+      raise ArgumentError.new("Unknown image format") unless %w(jpg jpeg gif png).include? new_format
+      @format=new_format
+    end
+    
+    def text
+      @text.to_s.empty? ? default_text : @text
+    end
+    
+    def text=(new_text)
+      @text = new_text.to_s.gsub('_', ' ') unless new_text.nil?
+    end
+    
+    def colour=(new_colour)
+      @colour = ("#"+new_colour.to_s).gsub("##", '#') if new_colour =~ /^#?[0-9a-f]{6}$/i
+    end
+    
+    def colour
+      @colour||DEFAULT_COLOUR
+    end
+    
+    def text_colour
+      "#CC0000"
+    end
+    
+    def file_name
+      parts = [default_text]
+      parts << ((text == default_text) ? '' : text.downcase.gsub(/[^a-z]/, '_'))
+      parts << ((colour == DEFAULT_COLOUR) ? '' : colour.gsub("#", ''))
+      parts.join('-').gsub(/-+$/, '')+"."+format
+    end
+
+    def save(dir)
+      path = File.join(dir, file_name)
+      image.write(path)
+      path
+    end
+    
+    private
+      def build_args_from_string(str)
+        str, format = str.split(".")
+        bits = str.split('-')
+        height, width = bits.shift.to_s.split('x')
+        width = height if width.nil?
+        text = bits.shift
+        colour = bits.shift
+        {:colour=>colour, :text=>text, :height=>height, :width=>width, :format=>format}
+      end
+      
+      def default_text
+        "#{height}x#{width}"
+      end
+      
+      def image
+        the_colour = colour
+        the_text_colour = text_colour
+        img = Magick::Image.new(height, width) do 
+          self.background_color = the_colour
+        end
+        
+        image_text = Magick::Draw.new
+        image_text.font_family = FONT
+        image_text.pointsize = 20
+        image_text.gravity = Magick::CenterGravity
+        image_text.annotate(img, 0,0,0,0, self.text)
+        image_text.fill = self.text_colour
+        img
+      end
+  end
+end
+
+

data/lib/pollock/webapp.rb

@@ -0,0 +1,20 @@
+#
+# Sinatra app to server images.  If the image exists serve it, if it doesn't 
+# generate and cache it.
+# 
+
+PUBLIC_DIR = File.join(File.dirname(File.dirname(File.dirname(__FILE__))), 'public')
+POLLOCK_PORT = 1912
+
+set :port, POLLOCK_PORT
+set :public, PUBLIC_DIR
+set :environment, :production
+
+get "/" do
+  File.open(File.join(PUBLIC_DIR, 'index.html'))
+end
+
+get %r{/placeholders/(.*)} do |image_params|
+  image = Pollock::Image.new(image_params)
+  File.open(image.save(File.join(PUBLIC_DIR, 'placeholders')))
+end

data/public/index.html

@@ -0,0 +1,70 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"
+   "http://www.w3.org/TR/html4/strict.dtd">
+
+<html lang="en">
+<head>
+	<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+	<title>Pollock - Hassle free placeholder images.</title>
+	<link rel="stylesheet" href="stylesheets/screen.css" type="text/css" media="screen" title="no title" charset="utf-8">
+</head>
+<body>
+	<div id="wrapper">
+		<h1><a href="/">POLLOCK</a></h1>
+			<p>Generate placeholders for html wireframing without going near Photoshop.</p>
+
+		<h2>Usage</h2>
+		<p>Before you install the gem, you'll need <a href="http://www.imagemagick.org">ImageMagick</a>. After that, it's just</p>
+<pre>
+$ sudo gem install pollock
+</pre>	
+
+		<p>You'll now have access to the web-app:</p>
+<pre>
+$ pollockserver
+</pre>	
+	
+		<p>You're ready to start generating placeholders!</p>
+		
+<h2>Syntax</h2>
+
+<pre>
+/placeholders/width[xheight][-some_label_text][-color].format
+</pre>
+		
+<p>Only a width is required to generate a square image.  A label can be supplied to override the default behaviour of printing the image dimensions, and finally a #RRGGBB colour can be given to change the background.</p>
+
+<p>The parameters are separated by '-' and any spaces in the label should be substitued with '_', sorry no non-alphanumeric characters yet.</p>
+
+<p>You can supply any format extension ImageMagick is capable of generating.</p>
+
+<pre>
+http://localhost:1912/placeholders/100x100.jpg
+http://localhost:1912/placeholders/200x100-with_some_text.jpg
+http://localhost:1912/placeholders/305x100-with_a_colour-FF0000.png
+http://localhost:1912/placeholders/305x100--00CC00.gif
+</pre>	
+	
+<img src="./placeholders/100x100.jpg" />
+<img src="./placeholders/200x100-with_some_text.jpg" /><br>
+<img src="./placeholders/305x100-with_a_colour-FF0000.png" /><br>
+<img src="./placeholders/305x100--00CC00.gif" /><br>
+
+<h2>ToDo</h2>
+<ul>
+	<li>Options for pollockserver - port, debugging info, etc.</li>
+	<li>A less noisy server.</li>
+	<li>Moar image options!</li>
+</ul>
+
+		<h2>Credits</h2>
+			<ul>
+				<li>Pollock is very, very, very heavily inspired by <a href="http://placehold.it/">Placehold.it</a>, and if it wasn't for
+					the fact that I like to work offline I'd probably just use that.</li>
+				<li>All the work is being done by <a href="http://sinatrarb.com/">Sinatra</a> and <a href="http://www.imagemagick.org">ImageMagick</a></li>
+			
+				<li>The bits were glued together by <a href="http://www.leftbrained.co.uk">Gavin Montague</a> because the hotel TV only had terrestrial channels and Sky Sports.</li>
+			</ul>
+
+	</div>
+</body>
+</html>

data/public/stylesheets/screen.css

@@ -0,0 +1,34 @@
+* {
+	color:#575757;
+}
+h1, h2 {
+	font-family: "HeadlineA", Helvetica, Arial, sans-serif;
+	font-weight:bold;
+	color:#121212;
+	margin-bottom:5px;
+}
+html {
+	background:url(../images/faux-pollock.jpg) top left no-repeat;
+}
+#wrapper {
+	width:600px;
+	margin-left:320px;
+}
+pre {
+	background:#EAEAEA;
+	padding:4px 10px;
+	border-right:solid 1px #DADADA;
+	border-bottom:solid 1px #DADADA;
+}
+p, li {
+	font-size:15px;
+	line-height:20px;
+	font-family:Georgia;
+}
+a {
+	color:#000000;
+	font-weight:bold;
+}
+a:hover {
+	color:#999999;
+}

data/test/helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib', 'pollock'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'image'
+
+class Test::Unit::TestCase
+end

data/test/test_image.rb

@@ -0,0 +1,194 @@
+require 'helper'
+
+class TestPollock < Test::Unit::TestCase
+  def setup
+    @height = 200
+    @width = 300
+    @output_dir = File.join(File.dirname(__FILE__), 'tmp')
+  end
+  
+  should 'Image should complain if it receives no arguments' do
+    assert_raise ArgumentError do 
+      Pollock::Image.new
+    end
+  end
+  
+  context "The String Constructor" do
+    should "accept an explicit format" do
+      image = Pollock::Image.new("200.png")
+      assert_equal 'png', image.format
+    end
+
+    should "understand the a single argument constructor" do
+      image = Pollock::Image.new("200.jpg")
+      assert_equal 200, image.height
+      assert_equal 200, image.width
+    end
+    
+    should "understand different height and widths" do
+      image = Pollock::Image.new("200x300.jpg")
+      assert_equal 200, image.height
+      assert_equal 300, image.width
+    end
+    
+    should 'understand labels' do
+      image = Pollock::Image.new("200-a_sample_label.jpg")
+      assert_equal 'a sample label', image.text
+      image = Pollock::Image.new("200.jpg")
+      assert_equal '200x200', image.text
+    end
+    
+    should "understand colours" do
+      image = Pollock::Image.new("200--FF0000.jpg")
+      assert_equal '#FF0000', image.colour
+    end
+    
+    should "understand this" do
+      image = Pollock::Image.new('305x100--FF0000.jpg')
+      assert_equal 305, image.height
+      assert_equal 100, image.width
+      assert_equal '305x100', image.text
+      assert_equal '#FF0000', image.colour
+    end
+    
+  end
+  
+  context "Given an Image that only has a height" do
+    setup {
+      @image = Pollock::Image.new(:height=>@height)
+    }
+    
+    should "set height to 200px" do
+      assert_equal @height, @image.height
+    end
+    
+    should "set width to the same as the height" do
+      assert_equal @height, @image.width
+    end
+    
+    should "set the text to '200x200'" do 
+      assert_equal "#{@height}x#{@height}", @image.text
+    end
+    
+    should "set the format to 'jpg'" do 
+      assert_equal "jpg", @image.format
+    end
+    
+    should "use the default background colour" do
+      assert_equal "#CCCCCC", @image.colour
+    end
+    
+    should "use the default text colour" do
+      assert_equal "#CC0000", @image.text_colour
+    end
+    
+    should "set the file_name" do
+      assert_equal "#{@height}x#{@height}.jpg", @image.file_name
+    end
+    
+    should "write out an image" do
+      @image.save(@output_dir)
+    end
+  end
+  
+  context "Given an Image with a height and width" do
+    setup {
+      @image = Pollock::Image.new(:height=>@height, :width=>@width)
+    }
+    should "set height to 200px" do
+      assert_equal @height, @image.height
+    end
+    
+    should "set width to 200px" do
+      assert_equal @width, @image.width
+    end
+    
+    should "set the text to '200x300'" do 
+      assert_equal '200x300', @image.text
+    end
+    
+    should "set the filename correctly" do
+      assert_equal "#{@height}x#{@width}.jpg", @image.file_name
+    end
+    
+    should "write out an image" do
+      @image.save(@output_dir)
+    end
+  end
+  
+  context "Given an Image with an explicit label" do
+    setup {
+      @text = "Wow! I'm a label"
+      @image = Pollock::Image.new(:height=>@height, :text=>@text)
+    }
+    should "set the text to that value" do 
+      assert_equal @text, @image.text
+    end
+    
+    should "set the filename correctly" do
+      assert_equal '200x200-wow__i_m_a_label.jpg', @image.file_name
+    end
+    
+    should "write out an image" do
+      @image.save(@output_dir)
+    end
+  end
+  
+  context "Given an explicit colour" do
+    should "set the colour to that value" do
+      colour = "#999AAA"
+      image = Pollock::Image.new(:height=>@height, :colour=>colour)
+      assert_equal colour, image.colour
+    end
+
+    should "accept a colour without a hash" do 
+      colour = "999AAA"
+      image = Pollock::Image.new(:height=>@height, :colour=>colour)
+      assert_equal '#'+colour, image.colour
+    end
+
+    
+    should "Ignore a colour that's invalid and keep the default" do
+      image = Pollock::Image.new(:height=>@height, :colour=>"An invalid colour")
+      assert_equal image.colour, Pollock::Image.new(:height=>100).colour
+    end
+    
+    should "set the filename correctly" do
+      colour = "999AAA"
+      image = Pollock::Image.new(:height=>@height, :colour=>colour)
+      assert_equal "200x200--999AAA.jpg", image.file_name
+    end
+    
+  end
+  
+  context "Given an Image with an explicit format" do
+    setup {
+      @format = "png"
+      @image = Pollock::Image.new(:height=>@height, :format=>@format)
+    }
+    should "set the text to that value" do 
+      assert_equal @format, @image.format
+    end
+    
+    should "set the file_name" do
+      assert_equal "#{@height}x#{@height}.#{@format}", @image.file_name
+    end
+    
+    should "Raise an exception for an unknown format" do
+      assert_raise ArgumentError do
+        Pollock::Image.new(:height=>@height, :format=>'bad_format')
+      end
+    end
+    
+    
+    should "set the filename correctly" do
+      assert_equal "200x200.png", @image.file_name
+    end
+    
+    should "write out an image" do
+      @image.save(@output_dir)
+    end
+    
+  end
+  
+end

metadata

@@ -0,0 +1,130 @@
+--- !ruby/object:Gem::Specification 
+name: pollock
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 2
+  version: 0.1.2
+platform: ruby
+authors: 
+- Gavin Montague
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-03-26 00:00:00 +00:00
+default_executable: pollockserver
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: thoughtbot-shoulda
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rmagick
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: sinatra
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+description: A little Sinatra and RMagick to generate placeholder images via an http call.  Heavily inspired by http://placehold.it
+email: gavin@leftbrained.co.uk
+executables: 
+- pollockserver
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.markdown
+files: 
+- LICENSE
+- README.markdown
+- Rakefile
+- VERSION
+- bin/pollockserver
+- lib/pollock/image.rb
+- lib/pollock/webapp.rb
+- public/images/faux-pollock.jpg
+- public/index.html
+- public/placeholders/100x100.jpg
+- public/placeholders/200x100-with_some_text.jpg
+- public/placeholders/305x100--00CC00.gif
+- public/placeholders/305x100-with_a_colour-FF0000.png
+- public/stylesheets/screen.css
+- test/helper.rb
+- test/test_image.rb
+- test/tmp/200x200-200x200-#CCCCCC.jpg
+- test/tmp/200x200-200x200-#CCCCCC.png
+- test/tmp/200x200-Wow! I'm a label-#CCCCCC.jpg
+- test/tmp/200x200-false-#CCCCCC.jpg
+- test/tmp/200x200-false-true.jpg
+- test/tmp/200x200-true-#CCCCCC.jpg
+- test/tmp/200x200-true-#CCCCCC.png
+- test/tmp/200x200-true-true.jpg
+- test/tmp/200x200-true-true.png
+- test/tmp/200x200-wow__i_m_a_label.jpg
+- test/tmp/200x200.jpg
+- test/tmp/200x200.png
+- test/tmp/200x300-200x300-#CCCCCC.jpg
+- test/tmp/200x300-true-#CCCCCC.jpg
+- test/tmp/200x300-true-true.jpg
+- test/tmp/200x300.jpg
+has_rdoc: true
+homepage: http://github.com/govan/pollock
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Generate placeholders for html wireframing without going near Photoshop
+test_files: 
+- test/helper.rb
+- test/test_image.rb