placeimg 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: bf5806a31cc34b808b94ecc38469e02e96f68eb7
+  data.tar.gz: 24eaa12ccf4ffda80c377eaecec98916d4acbb80
+SHA512:
+  metadata.gz: 8fb196afaeb45247823f9e8596a30c25d0208aa9a17f254b600fbdd308fd5b88c94e016a627be145f02979f84a6c8495ccf11aa51c9b594bc301b29f6fb8c479
+  data.tar.gz: 2473f0be51197b15db467956ae0f98d15845e2a90f9d4e31a0385d3eb8529a45560141da7934c1b1c952a62c61c4e68df3cce65e862299b375dbae4283a7eae1

data/.gitignore

@@ -0,0 +1,4 @@
+.DS_Store
+placeimg-*.gem
+vendor
+.bundle

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/lib/placeimg.rb

@@ -0,0 +1,7 @@
+module Placeimg
+  require "placeimg/view_helpers"
+  require "placeimg/version"
+  require 'placeimg/rails/railtie'
+end
+
+

data/lib/placeimg/rails/railtie.rb

@@ -0,0 +1,8 @@
+require 'placeimg'
+require "rails"
+
+class Railtie < Rails::Railtie
+  initializer "placeimg.helper" do |app|
+    ActionView::Base.send :include, Placeimg::ViewHelpers
+  end
+end

data/lib/placeimg/version.rb

@@ -0,0 +1,3 @@
+module Placeimg
+  VERSION = "0.0.1"
+end

data/lib/placeimg/view_helpers.rb

@@ -0,0 +1,45 @@
+module Placeimg
+  module ViewHelpers
+
+    require 'base64' unless defined?(Base64)
+    require 'RMagick' unless defined?(Magick)
+    include Magick
+
+    def placeholder(details = nil)
+      details         ||= {}
+      details[:bg]    ||= '#ccc'
+      details[:fg]    ||= '#777'
+      details[:h]     ||= 250
+      details[:w]     ||= 250
+      details[:class] ||= ""
+      details[:id]    ||= ""
+
+      details[:h] = details[:h].to_i
+      details[:w] = details[:w].to_i
+
+      img = Image.new(details[:w], details[:h]) {
+        self.background_color = details[:bg]
+        self.format = "PNG"
+      }
+
+      if details[:h] > details[:w]
+        font_size = (details[:w] / 5).ceil
+      else
+        font_size = (details[:h] / 5).ceil
+      end
+
+      txt = Draw.new
+
+      img.annotate(txt, 0,0,0,0, "#{details[:w].to_s}x#{details[:h].to_s}") {
+        txt.gravity = Magick::CenterGravity
+        txt.pointsize = font_size
+        txt.fill = details[:fg]
+      }
+
+      data_uri = Base64.encode64(img.to_blob).gsub(/\n/, "")
+      output = '<img width="%s" height="%s" alt="placeholder" src="data:image/png;base64,%s" class="%s" id="%s">' % [details[:w].to_s, details[:h].to_s, data_uri, details[:class], details[:id]]
+      raw output
+    end
+
+  end
+end

data/placeimg.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "placeimg/version"
+
+Gem::Specification.new do |s|
+  s.name        = "placeimg"
+  s.version     = Placeimg::VERSION
+  s.authors     = ["Kelli Shaver"]
+  s.email       = ["kelli@kellishaver.com"]
+  s.homepage    = "https://github.com/kellishaver/placeimg"
+  s.summary     = %q{Easily add placeholder images to your HTML.}
+  s.description = %q{PlaceImg lets you easily add placeholder images to your HTML by generating images with RMagick and serving them as data URLs via an easy to use helper method.}
+  s.license     = "MIT"
+
+  s.rubyforge_project = "placeimg"
+
+  s.files         = `git ls-files`.split("\n")
+  s.require_paths = ["lib"]
+
+  s.add_dependency "rails", ">= 3.0"
+  s.add_dependency "rmagick"
+
+end

data/readme.md

@@ -0,0 +1,74 @@
+PlaceImg
+====
+
+PlaceImg is a simple gem that allows you to quickly and easily generate placeholder images via an easy to use view helper.
+
+Placeholder images are generated via ImageMagick and are embedded in your views dynamically as data URLs. This means you won't need to clutter up image directories with junk files and you won't need to rely on an external source for placeholder iamges.
+
+Installation
+----
+
+Installing PlaceImg is as easy as running:
+
+    gem install placeimg
+
+###Requirements
+
+PlaceImg requires you have the following on your system:
+
+* ImageMagick
+* Ghostscript
+
+###Gem Dependancies
+
+PlaceImg has the following gem dependencies:
+
+* Rails v3.0 or greater
+* RMagick
+
+Usage
+----
+
+Using PlaceImg is simple. Just call the `placeholder` helper method anywhere inside your view files that you'd like to put a placeholder image.
+
+The default placeholder is a 250x250px greyscale image.
+
+    <%= placeholder %>
+
+###Customizing the Placeholder
+
+You can also customize your placeholder image by passing a variety of options to it:
+
+* `h` - The height of the image in pixels
+* `w` - The width of the image in pixels
+* `bg` - The background color of the image, as a word (e.g. "red") or a hex code (e.g. '#f00' or '#ff0000')
+* `fg` - The foreground (text) color of the image, as a word (e.g. "white") or a hex code (e.g. '#fff' or '#ffffff')
+* `class` - A string of one or more class names to apply to the generated image tag
+* `id` - An ID to apply to the generated image tag
+
+For Example:
+
+    <%=
+      placeholder({
+        h: 90,
+        w: 760,
+        bg: '#777',
+        fg: '#fff',
+        class: 'banner',
+        id: 'top-sponsor'
+      })
+    %>
+
+You can pass some, all, or no options to the helper. Below are the defaults:
+
+* bg = #ccc
+* fg = #777
+* h = 250
+* w = 250
+* class = *empty string*
+* id = *empty string*
+
+ToDo
+----
+
+* Tests - PlaceImg should be pretty fool-proof, but it could use a test or two.

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification
+name: placeimg
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Kelli Shaver
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-11-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rmagick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: PlaceImg lets you easily add placeholder images to your HTML by generating
+  images with RMagick and serving them as data URLs via an easy to use helper method.
+email:
+- kelli@kellishaver.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- lib/placeimg.rb
+- lib/placeimg/rails/railtie.rb
+- lib/placeimg/version.rb
+- lib/placeimg/view_helpers.rb
+- placeimg.gemspec
+- readme.md
+homepage: https://github.com/kellishaver/placeimg
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: placeimg
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Easily add placeholder images to your HTML.
+test_files: []