spriteful 0.0.1

data/LICENSE

@@ -0,0 +1,13 @@
+Copyright (c) 2013 Lucas Mazza <lucastmazza@gmail.com>
+
+  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.

data/README.md

@@ -0,0 +1,103 @@
+# Spriteful
+
+Spriteful is a command line sprite generator tool, meant to be used regardless of your programming language, application stack or Web framework.
+
+## Usage
+
+Lets say that you have your images in `images/icons/` and you want to generate a sprite for them.
+
+```bash
+spriteful images/icons
+# create  icons.png
+# create  icons.css
+```
+
+Boom! Spriteful will generate a `icons.png` in your working directory and the respective CSS
+for your sprite in the `icons.css` file.
+
+If you want a bit more of control on where we should place the combined image and the CSS, you
+can use the `s` (for `stylesheets`) and `d` ( for `destination`) flags and Spriteful will place
+your `icons.png` in a specific directory and will save the CSS in the `icons.css` file instead
+of copying it to your clipboard.
+
+```bash
+spriteful images/icons -s stylesheets -d images
+# create  images/icons.png
+# create  stylesheets/icons.css
+```
+
+### The CSS
+
+By default, Spriteful will generate a set of CSS classes based on the images of your sprite. In the
+case of having a `new.png` image in our `icons` sprite, you can use it putting together the `icons`
+and `new` class.
+
+```html
+<a href='/new' class='icons new'>New thing</a>
+```
+
+### SCSS support
+
+Spriteful can generate SCSS-ish code with the `-f` flag. This way the generated code will use
+[Placeholder Selectors](http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#placeholder_selectors_)
+instead of generating a class for each image in your sprite.
+
+```bash
+spriteful images/icons -f scss
+# create  icons.png
+# copy    icons.scss
+```
+
+```scss
+// in your SCSS code...
+.button {
+  @extend %icons-sprite-new;
+}
+```
+
+### Multiple sprites
+
+You can deal with multiple sprites in a single run. If `images/icons` has a set of images for one
+sprite and `images/flags` another set you can generate both `icons.png` and `flags.png` with a single
+execution.
+
+```bash
+spriteful images/icons images/flags -s stylesheets -d images
+# create  images/icons.png
+# create  stylesheets/icons.css
+# create  images/flags.png
+# create  stylesheets/flags.css
+```
+
+### Spriteful and Rails
+
+If you are working on a Ruby on Rails application Spriteful can provide some extra goodies for
+you. If run you the `spriteful` command with the `--rails` flag, all sprites under `app/assets/images/sprites` will be generated with respective stylesheets at `app/assets/stylesheets/sprites`, using the proper `image_url` helper for the format of your choice.
+
+So, given that you have the `icons` and `flags` directories with your images under `app/assets/images`, you might get a similar output when generating these two sprites.
+
+```bash
+spriteful --rails
+# create  app/assets/images/sprites/flags.png
+# create  app/assets/stylesheets/sprites/flags.css.erb
+# create  app/assets/images/sprites/icons.png
+# create  app/assets/stylesheets/sprites/icons.css.erb
+```
+
+## Available options
+
+* `--stylesheets` (`-s`) - Directory to save the generated stylesheet(s), instead of copying them to the clipboard.
+* `--destination` (`-d`) - Directory to save the generated image(s).
+* `--rails` (`-r`) - Forces rails specific settings, see [Spriteful and Rails](#spriteful-and-rails) for more info.
+* `--format` (`-f`) - Format to generate the sprite(s) stylesheet(s). Either "css" or "scss".
+* `--horizontal` - Changes the sprite orientation to horizontal, since all sprites are combined vertically by default.
+* `--save` - Saves the provided arguments for later use.
+* `--spacing` - Add some spacing between the images in the sprite.
+
+You can add a `.spritefulrc` file with default options to your home directory or the current one that they will be picked up whenever you run the `spriteful` command.
+
+### Examples
+
+This repository contains an `examples` folder with some very simple sprites and the output generated
+by Spriteful. Feel free to take a look or try it on your own by cloning this repository and running
+`spriteful` on it.

data/bin/spriteful

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+require 'shellwords'
+
+require 'spriteful'
+require 'spriteful/cli'
+
+unless ARGV.include?('--help') || ARGV.include?('-h')
+  %w(~/.spritefulrc ./.spritefulrc).each do |rcfile|
+    path = File.expand_path(rcfile)
+    if File.exist?(path)
+      ARGV.unshift(*Shellwords.split(File.read(path)))
+    end
+  end
+end
+
+Spriteful::CLI.start

data/lib/spriteful.rb

@@ -0,0 +1,9 @@
+require 'thor/error'
+
+require 'spriteful/image'
+require 'spriteful/sprite'
+require 'spriteful/stylesheet'
+
+module Spriteful
+  class EmptySourceError < Thor::Error; end
+end

data/lib/spriteful/cli.rb

@@ -0,0 +1,124 @@
+require 'shellwords'
+require 'thor/group'
+
+module Spriteful
+  class CLI < Thor::Group
+    include Thor::Actions
+    desc 'Generates image sprites with corresponding stylesheets.'
+
+    argument :sources, type: :array, desc: 'Images to generate the sprites.', default: []
+
+    class_option :format, aliases: '-f', banner: 'FORMAT', type: :string, desc: 'Format to generate the sprite(s) stylesheet(s). Either "css" or "scss".', default: 'css'
+    class_option :stylesheets, aliases: '-s', banner: 'STYLESHEETS_DIR', type: :string, desc: 'Directory to save the generated stylesheet(s), instead of copying them to the clipboard.', default: Dir.pwd
+    class_option :destination, aliases: '-d', banner: 'DESTINATION_DIR', type: :string, desc: 'Destination directory to save the combined image(s).', default: Dir.pwd
+    class_option :root, aliases: '-r', banner: 'ROOT_DIR', type: :string, desc: 'Root folder from where your static files will be served.'
+
+    class_option :rails, type: :boolean, desc: 'Follow default conventions for a Rails application with the Asset Pipeline.'
+    class_option :horizontal, type: :boolean, desc: 'Change the sprite orientation to "horizontal".'
+    class_option :save, type: :boolean, desc: 'Save the supplied arguments to ".spritefulrc".'
+    class_option :spacing, type: :numeric, desc: 'Add spacing between the images in the sprite.'
+
+    # Public: Gets the CLI banner for the Thor help message.
+    #
+    # Returns a String.
+    def self.banner
+      'spriteful sources [options]'
+    end
+
+    # Public: Initializes the CLI object and replaces the frozen
+    # 'options' object with an unfrozen one that we can mutate.
+    def initialize(*)
+      super
+      self.options = options.dup
+    end
+
+    # Public: executes the CLI processing of the sprite sources
+    # into combined images and stylesheets.
+    # Returns nothing.
+    def execute
+      prepare_options!
+      if sources.empty?
+        self.class.help(shell)
+        exit(1)
+      end
+
+      sources.uniq!
+      sources.each do |source|
+        create_sprite(source)
+      end
+
+      save_options
+    end
+
+    private
+    # Internal: create a sprite image and stylesheet from a given source.
+    #
+    # Returns nothing.
+    def create_sprite(source)
+      sprite = Spriteful::Sprite.new(File.expand_path(source), options.destination, sprite_options)
+      stylesheet = Spriteful::Stylesheet.new(sprite, File.expand_path(options.stylesheets), stylesheet_options)
+
+      sprite.combine!
+      create_file sprite.path, sprite.blob
+      create_file stylesheet.path, stylesheet.render
+    end
+
+    # Internal: Saves the existing options on 'ARGV' to the '.spritefulrc'
+    # file if the '--save' flag is present.
+    #
+    # Returns nothing.
+    def save_options
+      if options.save?
+        options.delete(:save)
+        parts = sources + options.map { |key, value| ["--#{key}", value.to_s] }.flatten
+        create_file '.spritefulrc', Shellwords.join(parts) + "\n", force: true
+      end
+    end
+
+    def stylesheet_options
+      {
+        root: options.root,
+        format: options.format,
+        rails: options.rails?
+      }
+    end
+
+    # Internal: Gets the set of options that are specific for the 'Sprite'
+    # class.
+    #
+    # Returns a Hash.
+    def sprite_options
+      {
+        horizontal: options.horizontal?,
+        spacing: options.spacing
+      }
+    end
+
+    # Internal: Change the `options` hash if necessary, based on the
+    # 'rails' flag.
+    #
+    # Returns nothing.
+    def prepare_options!
+      if options.rails?
+        sources.concat(detect_sources)
+        set_rails_defaults
+      end
+    end
+
+    # Internal: Detects possible source directories in Rails applications
+    # that are present inside the 'images/sprites' asset path.
+    #
+    # Returns an Array of directories.
+    def detect_sources
+      Dir['app/assets/images/sprites/*'].select { |dir| File.directory?(dir) }
+    end
+
+    # Internal: Sets Rails specific default options to the 'options' object.
+    #
+    # Returns nothing.
+    def set_rails_defaults
+      options['stylesheets'] = File.expand_path('app/assets/stylesheets/sprites')
+      options['destination'] = File.expand_path('app/assets/images/sprites')
+    end
+  end
+end

data/lib/spriteful/image.rb

@@ -0,0 +1,43 @@
+module Spriteful
+  # Internal: Data structure to represent the images that are part
+  # of a sprite.
+  class Image
+    # Public: returns the path where the Image lives.
+    attr_reader :path
+
+    # Public: returns the filename of the Image.
+    attr_reader :name
+
+    # Public: returns the Image width in pixels.
+    attr_reader :width
+
+    # Public: returns the Image height in pixels.
+    attr_reader :height
+
+    # Public: Gets/sets the top position of the image in a sprite.
+    attr_accessor :top
+
+    # Public: Gets/sets the left position of the image in a sprite.
+    attr_accessor :left
+
+    # Public: Gets the source 'ChunkyPNG::Image'.
+    attr_reader :source
+
+    # Public: Initializes an Image, extracting the image
+    # metadata such as width and path supplied by an 'ChunkyPNG::Image'
+    # object that was initialized from the real image blob.
+    #
+    # chunky_image - an 'ChunkyPNG::Image' object.
+    # path         - the path where the image is present.
+    def initialize(chunky_image, path)
+      @source = chunky_image
+      @path   = path
+      @name   = File.basename(@path)
+      @width  = chunky_image.width
+      @height = chunky_image.height
+
+      @top    = 0
+      @left   = 0
+    end
+  end
+end

data/lib/spriteful/sprite.rb

@@ -0,0 +1,135 @@
+require 'chunky_png'
+
+module Spriteful
+  # Public: the 'Sprite' class is responsible for combining a directory
+  # of images into a single one, and providing the required information
+  # about the related images.
+  class Sprite
+    # Public: returns the path where the sprite will be saved.
+    attr_reader :path
+
+    # Public: Gets the name of the sprite.
+    attr_reader :name
+
+    # Public: Gets the filename of the sprite.
+    attr_reader :filename
+
+    # Public: Gets the the spacing between the images in the sprite.
+    attr_reader :spacing
+
+    # Public: Gets the the binary contents of the combined image.
+    attr_reader :blob
+
+    # Public: Gets the the width of the combined image.
+    attr_reader :width
+
+    # Public: Gets the the height of the combined image.
+    attr_reader :height
+
+    # Public: Gets the flag to check if the sprite is vertical or not.
+    attr_reader :vertical
+    alias :vertical? :vertical
+
+    # Public: Initialize a Sprite.
+    #
+    # source_dir  - the source directory where the sprite images are located.
+    # destination - the destination directory where the sprite should be saved.
+    # options     - additional Hash of options.
+    #               :horizontal - flag to turn the sprite into the horizontal
+    #                             orientation.
+    #               :spacing - spacing in pixels that should be placed between
+    #                          the images in the sprite. Defaults to 0.
+    def initialize(source_dir, destination, options = {})
+      source_pattern = File.join(source_dir, '*.png')
+      sources = Dir[source_pattern].sort
+
+      if sources.size == 0
+        raise EmptySourceError, "No image sources found at '#{source_dir}'."
+      end
+
+      @vertical    = !options[:horizontal]
+      @spacing     = options[:spacing] || 0
+
+      @name     = File.basename(source_dir)
+      @filename = "#{name}.png"
+      @path     = File.expand_path(File.join(destination, @filename))
+      sources     = sources.map { |source| [source, ChunkyPNG::Image.from_file(source)] }
+      @images   = initialize_images(Hash[sources])
+
+      @height, @width = detect_dimensions
+    end
+
+    # Public: combines the source images into a single one,
+    # storing the combined image into the sprite path.
+    #
+    # Returns nothing.
+    def combine!
+      combined = ChunkyPNG::Image.new(width, height, ChunkyPNG::Color::TRANSPARENT)
+      @images.each do |image|
+        combined.compose!(image.source, image.left.abs, image.top.abs)
+      end
+      @blob = combined.to_blob(:best_compression)
+    end
+
+    # Public: exposes the source images found in the 'source'
+    # directory.
+    #
+    # Yields an 'Image' object on each interation.
+    #
+    # Returns an 'Enumerator' if no block is given.
+    def each_image
+      return to_enum(__method__) unless block_given?
+      @images.each { |image| yield image }
+    end
+
+    alias :images :each_image
+
+    private
+    # Internal: detect the expected 'height' and 'width' of the
+    # combined image of this sprite. This should take in account
+    # the sprite orientation and the configured spacing.
+    #
+    # Returns an Array with the 'height' and 'width'.
+    def detect_dimensions
+      total_spacing = (@images.size - 1) * spacing
+
+      if vertical?
+        height   = @images.map { |image| image.height }.inject(:+) + total_spacing
+        width    = @images.map { |image| image.width }.max
+      else
+        height  = @images.map { |image| image.height }.max
+        width   = @images.map { |image| image.width }.inject(:+) + total_spacing
+      end
+
+      [height, width]
+    end
+
+    # Internal: Initializes a collection of 'Image' objects
+    # based on the 'source' images. The images will have
+    # the source images metadata and the required 'top' and
+    # 'left' coordinates that the image will be placed
+    # in the sprite.
+    #
+    # sources - a Hash of source paths and image objects.
+    #
+    # Returns an Array.
+    def initialize_images(sources)
+      sprite_position = 0
+      images = []
+      sources.each_with_index do |(path, chunky_image), index|
+        image = Image.new(chunky_image, path)
+        padding = index * spacing
+
+        if vertical?
+          image.top = sprite_position
+          sprite_position -= image.height + padding
+        else
+          image.left = sprite_position
+          sprite_position -= image.width + padding
+        end
+        images << image
+      end
+      images
+    end
+  end
+end

data/lib/spriteful/stylesheet.rb

@@ -0,0 +1,109 @@
+require 'pathname'
+require 'erb'
+
+module Spriteful
+  # Public: class responsible for putting together the CSS code
+  # to use a specific sprite.
+  class Stylesheet
+    # Public: returns the format used to render the Stylesheet.
+    attr_reader :format
+
+    # Public: returns the 'Sprite' of this Stylesheet.
+    attr_reader :sprite
+
+    # Public: returns the path where the Stylesheet should be stored.
+    attr_reader :path
+
+    # Public: Initialize a Stylesheet
+    #
+    # sprite        - a 'Sprite' object to create the Stylesheet.
+    # destination   - the directory where the Stylesheet will be created.
+    # options       - additional Hash of options.
+    #                 :format - the Stylesheet format.
+    #                 :rails  - A flag to generate Asset Pipeline compatible Stylesheets.
+    def initialize(sprite, destination, options = {})
+      @sprite = sprite
+      @destination = Pathname.new(destination)
+      @root = nil
+      if options[:root]
+        @root = Pathname.new(File.expand_path(options[:root]))
+      end
+      @format = options[:format]
+      @rails = options.fetch(:rails) { false }
+
+      @path = @destination.join(name)
+    end
+
+    # Public: renders the CSS code for this Stylesheet.
+    # An ERB template will be used to process the code, based
+    # on the stylesheet format.
+    #
+    # Returns the CSS code as a 'String'.
+    def render
+      source = File.expand_path("../stylesheets/template.#{format}.erb", __FILE__)
+      ERB.new(File.read(source), nil, '-').result(binding)
+    end
+
+    # Public: returns this Stylesheet name, based
+    # on the Sprite name and the current format.
+    #
+    # Returns a String.
+    def name
+      extension = rails? ? rails_extension : format
+      "#{sprite_name}.#{extension}"
+    end
+
+    protected
+
+    # Internal: returns the 'rails ' flag.
+    def rails?
+      @rails
+    end
+
+    # Internal: defines the file extension to be used with
+    # Rails applications, since we need to account for the ERB
+    # preprocessing of plain CSS files.
+    #
+    # Returns a String.
+    def rails_extension
+      case format
+      when 'css'
+        'css.erb'
+      when 'scss'
+        'scss'
+      end
+    end
+
+    def sprite_name
+      case format
+      when 'css'
+        sprite.name
+      when 'scss'
+        "_#{sprite.name}"
+      end
+    end
+
+    # Internal: sanitizes the 'name' of a given object to
+    # be used as a CSS selector class.
+    #
+    # Returns a 'String'.
+    def class_name_for(object)
+      object.name.split('.').first.downcase.tr('_', '-')
+    end
+
+    # Internal: computes a relative path between the sprite
+    # path and the stylesheet expected location.
+    #
+    # Returns a 'String'.
+    def image_url(sprite)
+      path = Pathname.new(sprite.path)
+      if @rails
+        "sprites/#{sprite.filename}"
+      elsif @root
+        "/#{path.relative_path_from(@root)}"
+      else
+        path.relative_path_from(@destination)
+      end
+    end
+  end
+end

data/lib/spriteful/stylesheets/template.css.erb

@@ -0,0 +1,21 @@
+/*
+ * This Stylesheet was generated by the 'spriteful' gem.
+ * Below there are several CSS classes to use the '<%= sprite.name %>'
+ * sprite on you HTML code, as in:
+ *
+ *  <div class='<%= class_name_for(sprite) %> <%= class_name_for(sprite.images.first) %>'>Your markup here.</div>
+ */
+
+.<%= class_name_for(sprite) %> {
+  <% if rails? -%>
+  background-image: url(<%%= image_url('<%= image_url(sprite) %>') %>);
+  <% else -%>
+  background-image: url(<%= image_url(sprite) %>);
+  <% end -%>
+  background-repeat: no-repeat;
+}
+<% sprite.each_image do |image| %>
+.<%= class_name_for(sprite) %>.<%= class_name_for(image) %> {
+  background-position: <%= image.left %>px <%= image.top %>px;
+}
+<% end %>

data/lib/spriteful/stylesheets/template.scss.erb

@@ -0,0 +1,25 @@
+// ============================================================================
+// This Stylesheet was generated by the 'spriteful' gem.
+// Below there are several [Placeholder Selectors]
+// (http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#placeholder_selectors_)
+// to use the '<%= sprite.name %>' sprite on your SCSS code, as in:
+//
+// .my-thing {
+//   @extend %<%= class_name_for(sprite) %>-sprite-<%= class_name_for(sprite.images.first) %>;
+//   // Your styles here.
+// }
+
+%<%= class_name_for(sprite) %>-sprite {
+  <%- if rails? -%>
+  background-image: image-url('<%= image_url(sprite) %>');
+  <%- else -%>
+  background-image: url(<%= image_url(sprite) %>);
+  <%- end -%>
+  background-repeat: no-repeat;
+}
+<% sprite.each_image do |image| %>
+%<%= class_name_for(sprite) %>-sprite-<%= class_name_for(image) %> {
+  @extend %<%= class_name_for(sprite) %>-sprite;
+  background-position: <%= image.left %>px <%= image.top %>px;
+}
+<% end %>

data/spec/image_spec.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+
+describe Spriteful::Image do
+  let(:path) { 'path/to/image.png' }
+  let(:chunky_image) { double('ChunkyPNG Image', width: 10, height: 5) }
+  subject(:image) { Spriteful::Image.new(chunky_image, path) }
+
+  it { expect(image.name).to eq('image.png') }
+  it { expect(image.path).to eq('path/to/image.png') }
+  it { expect(image.width).to eq(10) }
+  it { expect(image.height).to eq(5) }
+  it { expect(image.source).to eq(chunky_image) }
+end

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+require 'spriteful'
+
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  config.order = 'random'
+end

data/spec/sprite_spec.rb

@@ -0,0 +1,95 @@
+require 'fileutils'
+require 'spec_helper'
+
+describe Spriteful::Sprite do
+  let(:source) { File.expand_path('spec/fixtures/simple') }
+  let(:destination) { File.expand_path('tmp') }
+
+  before { FileUtils.rm(Dir["#{destination}/*.png"]) }
+
+  describe 'initialization' do
+    it 'raises an error if the source directory is empty' do
+      source = File.expand_path('spec/fixtures/missing')
+      expect {
+        Spriteful::Sprite.new(source, destination)
+        }.to raise_error(Spriteful::EmptySourceError)
+    end
+  end
+
+  describe '#width' do
+    it 'returns the whole sprite width' do
+      sprite = Spriteful::Sprite.new(source, destination)
+      expect(sprite.width).to be(10)
+    end
+
+    it 'accounts for the padding information' do
+      sprite = Spriteful::Sprite.new(source, destination, spacing: 10, horizontal: true)
+      expect(sprite.width).to be(30)
+    end
+  end
+
+  describe '#height' do
+    it 'returns the whole sprite height' do
+      sprite = Spriteful::Sprite.new(source, destination)
+      expect(sprite.height).to be(20)
+    end
+
+    it 'accounts for the spacing information' do
+      sprite = Spriteful::Sprite.new(source, destination, spacing: 10)
+      expect(sprite.height).to be(30)
+    end
+  end
+
+  describe '#path' do
+    it 'returns the path where the combined image will be saved' do
+      sprite = Spriteful::Sprite.new(source, destination)
+      expect(sprite.path).to eq(File.expand_path('tmp/simple.png'))
+    end
+  end
+
+  describe '#filename' do
+    it 'returns the filename of the sprite combined image' do
+      sprite = Spriteful::Sprite.new(source, destination)
+      expect(sprite.filename).to eq('simple.png')
+    end
+  end
+
+  describe '#combine!' do
+    it 'sets the sprite blob' do
+      sprite = Spriteful::Sprite.new(source, destination)
+      sprite.combine!
+      expect(sprite.blob).to be
+    end
+
+    it 'combine images vertically by default' do
+      sprite = Spriteful::Sprite.new(source, destination)
+      sprite.combine!
+      image = ChunkyPNG::Image.from_blob(sprite.blob)
+      expect(image.width).to be(10)
+      expect(image.height).to be(20)
+    end
+
+    it 'can combine images horizontally' do
+      sprite = Spriteful::Sprite.new(source, destination, horizontal: true)
+      sprite.combine!
+      image = ChunkyPNG::Image.from_blob(sprite.blob)
+      expect(image.width).to be(20)
+      expect(image.height).to be(10)
+    end
+  end
+
+  describe '#images' do
+    it 'yields an object for each image found in the source directory' do
+      sprite = Spriteful::Sprite.new(source, destination)
+      blue, red = sprite.images.to_a
+
+      expect(blue.name).to eq('blue.png')
+      expect(blue.top).to eq(0)
+      expect(blue.left).to eq(0)
+
+      expect(red.name).to eq('red.png')
+      expect(red.top).to eq(-10)
+      expect(red.left).to eq(0)
+    end
+  end
+end

data/spec/stylesheet_spec.rb

@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+describe Spriteful::Stylesheet do
+  let(:source) { File.expand_path('spec/fixtures/simple') }
+  let(:destination) { File.expand_path('tmp') }
+  let(:sprite) { Spriteful::Sprite.new(source, destination) }
+
+  describe '#render' do
+    it 'renders the CSS for the given sprite' do
+      stylesheet = Spriteful::Stylesheet.new(sprite, destination, format: 'css')
+      output = stylesheet.render
+
+      expect(output).to match(/.simple \{/)
+      expect(output).to match(/.simple.blue \{/)
+      expect(output).to match(/.simple.red \{/)
+    end
+
+    it 'renders the SCSS format' do
+      sprite = Spriteful::Sprite.new(source, destination)
+      stylesheet = Spriteful::Stylesheet.new(sprite, destination, format: 'scss')
+      output = stylesheet.render
+
+      expect(output).to match(/%simple-sprite \{/)
+      expect(output).to match(/%simple-sprite-blue \{/)
+      expect(output).to match(/%simple-sprite-red \{/)
+    end
+  end
+end

metadata

@@ -0,0 +1,155 @@
+--- !ruby/object:Gem::Specification
+name: spriteful
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Lucas Mazza
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-08-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.18.1
+    - - <
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.18.1
+    - - <
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: chunky_png
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.2.8
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.2.8
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.14.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.14.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A sprite generation tool
+email:
+- lucastmazza@gmail.com
+executables:
+- spriteful
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/spriteful/cli.rb
+- lib/spriteful/image.rb
+- lib/spriteful/sprite.rb
+- lib/spriteful/stylesheet.rb
+- lib/spriteful/stylesheets/template.css.erb
+- lib/spriteful/stylesheets/template.scss.erb
+- lib/spriteful.rb
+- spec/fixtures/simple/blue.png
+- spec/fixtures/simple/red.png
+- spec/image_spec.rb
+- spec/spec_helper.rb
+- spec/sprite_spec.rb
+- spec/stylesheet_spec.rb
+- bin/spriteful
+homepage: https://github.com/lucasmazza/spriteful
+licenses:
+- Apache 2.0
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: ''
+test_files:
+- spec/fixtures/simple/blue.png
+- spec/fixtures/simple/red.png
+- spec/image_spec.rb
+- spec/spec_helper.rb
+- spec/sprite_spec.rb
+- spec/stylesheet_spec.rb