css_image_embedder 0.1.1

data/CHANGELOG.rdoc

@@ -0,0 +1,5 @@
+= Version 0.1.1
+* Fixed compressed (one line) embeds
+
+= Version 0.1.0
+* Gem existence started

data/Gemfile

@@ -0,0 +1,2 @@
+source "http://rubygems.org"
+gemspec

data/LICENCE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Maciej Mensfeld
+ 
+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/Manifest

@@ -0,0 +1,23 @@
+CHANGELOG.rdoc
+Gemfile
+LICENCE
+README.md
+Rakefile
+init.rb
+lib/css_image_embedder.rb
+lib/css_image_embedder/converter.rb
+lib/css_image_embedder/exception.rb
+lib/css_image_embedder/helper.rb
+spec/css_image_embedder_spec.rb
+spec/files/bg.png
+spec/files/bg_base64.png
+spec/files/big_converted.css
+spec/files/file_sources_invalid.css
+spec/files/oneliner.css
+spec/files/oneliner_converted.css
+spec/files/std.css
+spec/files/std_converted.css
+spec/files/too_big.css
+spec/files/too_big.jpg
+spec/spec_helper.rb
+Manifest

data/README.md

@@ -0,0 +1,57 @@
+# CSS Image Embedder
+
+Css Image Embedder puts your background files directly into corresponding CSS file. Thanks to that - your server needs to handle fewer requests and the page layout renders smoothly (whole stylesheet at once).
+
+## INSTALL
+  
+    gem install css_image_embedder
+
+# USAGE
+
+Add gem to your gemfile:
+
+    gem 'css_image_embedder'
+
+and then you will gain a helper method called `image_embed_stylesheet_link_tag`. Use it instead of `stylesheet_link_tag` (params are the same). This helper method will not destroy (or modify) your original CSS files. It only changes cached CSS file, so if you do not use:
+
+    :cache => "/path/cached_stylesheets.css"
+
+method will act the same way as `stylesheet_link_tag`. Also - you will not see any effect in development environment (except when you turn caching on).
+
+## Disadvantages
+
+Css Image Embedder has one major disadvantage. Files converted into base64 are approximately 30% bigger then normal, so when you embed them into CSS file, the total size of CSS with backgrounds will not be equal to sum of CSS file and backgrounds files. However, if you use gzip compression on your server - it will compress CSS file and the total size will be approximately equal. So just turn gzip compression on :)
+## Example
+
+Suppose we have two backgrounds: `bg1.png` and `bg2.jpg` and two CSS files (each for background declaration): `first.css` and `second.css`. 
+
+The background declarations will be normal. You don't need to do anything special in your CSS files. So lets take `first.css`:
+
+    #first { background: #fff url(/images/bg1.png) no-repeat;}
+
+and second stylesheet:
+
+    #second { background: #fff url(/images/bg2.png) no-repeat;}
+
+Now lets just use them in our layout:
+
+    image_embed_stylesheet_link_tag(
+      "first", "second",
+      :cache => "cached_stylesheet"
+    )
+    
+This will produce nice `cached_stylesheet` with both background images embedded directly into cached CSS file.
+
+
+## Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a future version unintentionally.
+* Commit, do not mess with Rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+## Copyright
+
+Copyright (c) 2011 Maciej Mensfeld. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,12 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new('css_image_embedder', '0.1.1') do |p|
+  p.description    = "Css Image Embedder puts your background files directly into corresponding CSS file. Thanks to that - your server needs to handle fewer requests and the page layout renders smoothly (whole stylesheet at once)."
+  p.url            = "http://github.com/mensfeld/css_image_embedder"
+  p.author         = "Maciej Mensfeld"
+  p.email          = "maciej@mensfeld.pl"
+  p.ignore_pattern = ["tmp/*", "script/*"]
+  p.development_dependencies = ["rspec >=2.0.0", "rails"]
+end

data/css_image_embedder.gemspec

@@ -0,0 +1,37 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{css_image_embedder}
+  s.version = "0.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Maciej Mensfeld"]
+  s.cert_chain = ["/home/mencio/.cert_keys/gem-public_cert.pem"]
+  s.date = %q{2011-04-09}
+  s.description = %q{Css Image Embedder puts your background files directly into corresponding CSS file. Thanks to that - your server needs to handle fewer requests and the page layout renders smoothly (whole stylesheet at once).}
+  s.email = %q{maciej@mensfeld.pl}
+  s.extra_rdoc_files = ["CHANGELOG.rdoc", "README.md", "lib/css_image_embedder.rb", "lib/css_image_embedder/converter.rb", "lib/css_image_embedder/exception.rb", "lib/css_image_embedder/helper.rb"]
+  s.files = ["CHANGELOG.rdoc", "Gemfile", "LICENCE", "README.md", "Rakefile", "init.rb", "lib/css_image_embedder.rb", "lib/css_image_embedder/converter.rb", "lib/css_image_embedder/exception.rb", "lib/css_image_embedder/helper.rb", "spec/css_image_embedder_spec.rb", "spec/files/bg.png", "spec/files/bg_base64.png", "spec/files/big_converted.css", "spec/files/file_sources_invalid.css", "spec/files/oneliner.css", "spec/files/oneliner_converted.css", "spec/files/std.css", "spec/files/std_converted.css", "spec/files/too_big.css", "spec/files/too_big.jpg", "spec/spec_helper.rb", "Manifest", "css_image_embedder.gemspec"]
+  s.homepage = %q{http://github.com/mensfeld/css_image_embedder}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Css_image_embedder", "--main", "README.md"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{css_image_embedder}
+  s.rubygems_version = %q{1.5.2}
+  s.signing_key = %q{/home/mencio/.cert_keys/gem-private_key.pem}
+  s.summary = %q{Css Image Embedder puts your background files directly into corresponding CSS file. Thanks to that - your server needs to handle fewer requests and the page layout renders smoothly (whole stylesheet at once).}
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 2.0.0"])
+      s.add_development_dependency(%q<rails>, [">= 0"])
+    else
+      s.add_dependency(%q<rspec>, [">= 2.0.0"])
+      s.add_dependency(%q<rails>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 2.0.0"])
+    s.add_dependency(%q<rails>, [">= 0"])
+  end
+end

data/init.rb

@@ -0,0 +1 @@
+require 'css_image_embedder'

data/lib/css_image_embedder/converter.rb

@@ -0,0 +1,119 @@
+# coding: utf-8
+
+# Converts CSS files - it will embed any img file attached as background
+# background: url(...)... --> (base64) -->  url(data:image/png;base64,...)
+# Domyślnie osadza w CSSie tylko pliki mniejsze niz 32kb
+
+require 'base64'
+module CssImageEmbedder
+  class Converter
+    # IE does not accept embed files bigger then 32kb
+    DEFAULT_MAX_IMG_SIZE = 32*1024
+
+    attr_reader :result
+
+    def initialize(*sources)
+      options = sources.extract_options!.stringify_keys
+      source  = options.delete("source")
+      @file_path = options.delete("path")
+      @root_path = options.delete("root")
+      @overwrite = options.delete("overwrite") || false
+      @result = nil
+
+      @img_max_size = options.delete("img_max_size") || DEFAULT_MAX_IMG_SIZE
+
+      if @file_path
+        raise CssNotFound unless File.exists?(@file_path)
+        @source = File.open(@file_path, 'r') { |file| file.read }
+      else
+        raise CssStringNotProvided unless source
+        @source = source
+        @overwrite = false
+      end
+
+      raise RootPathNotProvided unless @root_path
+    end
+
+    # Performe converting
+    def convert
+      if elements = pull
+        source = @source
+        elements.each do |el|
+          file_base64 = File.join(@root_path, el[:converted_path])
+          file_ext = el[:converted_path].split('.').last
+          begin
+            next if File.size?(file_base64) > @img_max_size
+            file_base64 = self.class.file_to_base64(file_base64)
+            source.gsub!(el[:original_url], "url(data:image/#{file_ext.downcase};base64,#{file_base64})")
+          rescue
+            next
+          end
+        end
+        @result = source
+      else
+        @result = @source
+      end
+    end
+
+    # Saves converted result to file
+    def save(filename = nil)
+      if @file_path && @overwrite && filename.nil?
+        p = @file_path
+      else
+        p = filename
+      end
+      f = File.new(p, "w")
+      f.write(@result)
+      f.close
+    end
+
+    # Force overwrite
+    def save!(filename = nil)
+      @overwrite = true
+      save(filename)
+    end
+
+    # Convert to base64 without new lines
+    def self.file_to_base64(path)
+      str = File.open(path, 'r') { |file| file.read }
+      Base64.encode64(str).gsub("\n", '')
+    end
+
+    private
+
+    # Pulls out files paths from url(smthng)
+    # Returns an array containing:
+    # - original path  (./images/smthng.png)
+    # - converted path (/images/smthng.png)
+    # - original url   (url(./images/smthng.png))
+    def pull
+      # Whole urls including  stuff around (url('/images/smthng.png') )
+      whole_urls = @source.scan(/url\(.+?\)/i)
+      return nil if whole_urls.count == 0
+
+      img_bg_paths = []
+      whole_urls.each do |url|
+        img_bg_paths << url.scan(/url\(\s*["']?([^"']+)["']?\s*\)/i)[0][0]
+      end
+      img_bg_paths_original = img_bg_paths.clone
+
+      img_bg_paths.collect! do |img|
+        img = img.gsub('./', '/')
+        img = "/#{img}" if img[0] != '/'
+        img
+      end
+
+      result = []
+      img_bg_paths.each_with_index do |el, i|
+        result <<
+          {:original_path =>img_bg_paths_original[i],
+          :converted_path => el,
+          :original_url => whole_urls[i]
+          }
+      end
+      result.uniq!
+      result
+    end
+
+  end
+end

data/lib/css_image_embedder/exception.rb

@@ -0,0 +1,9 @@
+
+# CSS file does not exist
+class CssNotFound < StandardError; end
+
+# CSS string not provided
+class CssStringNotProvided < StandardError; end
+
+# Root path not provided
+class RootPathNotProvided < StandardError; end

data/lib/css_image_embedder/helper.rb

@@ -0,0 +1,45 @@
+# Helper methods for ActionView::Base in Rails
+module CssImageEmbedder
+  
+  module Helper
+
+    # Basicly it's just stylesheet_link_tag with one small difference ;)
+    # Will not test it - Rails guys already did it
+    def image_embed_stylesheet_link_tag(*sources)
+      options = sources.extract_options!.stringify_keys
+      concat  = options.delete("concat")
+      cache   = concat || options.delete("cache")
+      recursive = options.delete("recursive")
+      root = options.delete("root") || File.join(Rails.root, 'public')
+      env = options.delete("env") || Rails.env
+
+      if concat || (config.perform_caching && cache)
+        joined_stylesheet_name = (cache == true ? "all" : cache) + ".css"
+        joined_stylesheet_path = File.join(joined_stylesheet_name[/^#{File::SEPARATOR}/] ? config.assets_dir : config.stylesheets_dir, joined_stylesheet_name)
+
+        unless config.perform_caching && File.exists?(joined_stylesheet_path)
+          write_asset_file_contents(joined_stylesheet_path, compute_stylesheet_paths(sources, recursive))
+          # here's the magic ;)
+          css = CssImageEmbedder::Converter.new(
+            :path => joined_stylesheet_path,
+            :overwrite => true,
+            :root => root)
+          css.convert
+          css.save!
+        end
+        stylesheet_tag(joined_stylesheet_name, options)
+      else
+        sources = expand_stylesheet_sources(sources, recursive)
+        # When we use SASS and test env - will not work - and will raise
+        # exception - that css files does not exist. We make a workaround
+        # by not checking sources in test env
+        ensure_stylesheet_sources!(sources) if cache && env != 'test'
+        sources.collect { |source| stylesheet_tag(source, options) }.join("\n").html_safe
+      end
+    end
+
+  end # Helper
+  
+end # Base64CssEmbedder
+
+ActionView::Base.send :include, CssImageEmbedder::Helper

data/lib/css_image_embedder.rb

@@ -0,0 +1,5 @@
+path = File.expand_path(File.dirname(__FILE__))
+
+require "#{path}/css_image_embedder/exception"
+require "#{path}/css_image_embedder/helper"
+require "#{path}/css_image_embedder/converter"

data/spec/css_image_embedder_spec.rb

@@ -0,0 +1,140 @@
+require 'spec_helper'
+
+ROOT = File.expand_path(File.dirname(__FILE__))
+FILES_ROOT = File.join(ROOT, 'files')
+
+def file_content(f)
+  file = File.new("#{f}", "r")
+  content = ''
+  while (line = file.gets)
+    content+=line
+  end
+  content
+end
+
+def files_equal?(f1, f2)
+  file_content(f1) == file_content(f2)
+end
+
+describe CssImageEmbedder::Converter do
+  subject { CssImageEmbedder::Converter }
+
+  # Should clear all css files created in test
+  after(:all) do
+    FileUtils.rm("#{ROOT}/std.css")
+  end
+
+  context "when we have CSS file without any strange stuff" do
+    it "should convert std css file and embed pictures into it" do
+      converter = subject.new(
+        :path => "#{FILES_ROOT}/std.css",
+        :overwrite => true, 
+        :root => ROOT
+      )
+      converter.convert
+      converter.result.should === file_content("#{FILES_ROOT}/std_converted.css")
+    end
+
+    context "and allow to overwrite" do
+      it "should embed backgrounds and overwrite source file" do
+        # Copy std.css to check if it will be overwritten
+        FileUtils.cp("#{FILES_ROOT}/std.css", "#{ROOT}/std.css")
+        converter = subject.new(
+          :path => "#{ROOT}/std.css",
+          :overwrite => true,
+          :root => ROOT
+        )
+        converter.convert
+        converter.save
+        converter.result.should == file_content("#{ROOT}/std.css")
+        converter.result.should == file_content("#{FILES_ROOT}/std_converted.css")
+      end
+    end
+
+  end
+
+  context "when we provide too big background" do
+    it "should not embed it by default" do
+      converter = subject.new(
+        :path => "#{FILES_ROOT}/too_big.css",
+        :overwrite => true,
+        :root => ROOT
+      )
+      converter.convert
+      converter.result.should === file_content("#{FILES_ROOT}/too_big.css")
+    end
+
+    context "but limit is bigger" do
+      it "should embed it" do
+      converter = subject.new(
+        :path => "#{FILES_ROOT}/too_big.css",
+        :overwrite => true,
+        :root => ROOT,
+        :img_max_size => 100*1024
+      )
+      converter.convert
+      converter.result.should === file_content("#{FILES_ROOT}/big_converted.css")
+      end
+    end
+  end
+
+  context "when we provide css file where paths don't point to valid files" do
+    it "should leave original css file structure" do
+      converter = subject.new(
+        :path => "#{FILES_ROOT}/file_sources_invalid.css",
+        :root => ROOT
+      )
+      converter.convert
+      converter.result.should == file_content("#{FILES_ROOT}/file_sources_invalid.css")
+    end
+  end
+
+  context "when we don't provide root path" do
+    it "should raise RootPathNotProvided" do
+      lambda {
+        subject.new(
+          :path => "#{FILES_ROOT}/std_converted.css"
+        )
+      }.should raise_exception(RootPathNotProvided)
+    end
+  end
+
+  context "when we provide invalid source css file" do
+    it "should raise Exceptions::CssNotFound" do
+      lambda {
+        subject.new(
+          :path => "#{FILES_ROOT}no_file.css"
+        )
+      }.should raise_exception(CssNotFound)
+    end
+
+    context "but we provide string containing css" do
+      it "should convert it from string" do
+        converter = subject.new(
+          :source => file_content("#{FILES_ROOT}/std.css"),
+          :root => ROOT
+        )
+        converter.convert
+        converter.result.should == file_content("#{FILES_ROOT}/std_converted.css")
+      end
+    end
+
+    context "when we try to convert file to base64" do
+      it "should convert it" do
+        subject.file_to_base64("#{FILES_ROOT}/bg.png").should == file_content("#{FILES_ROOT}/bg_base64.png").gsub("\n", '')
+      end
+    end
+
+    context "when we provide huge one liner" do
+      it "should convert it without hesitation" do
+        converter = subject.new(
+          :path => "#{FILES_ROOT}/oneliner.css",
+          :root => ROOT
+        )
+        converter.convert
+        converter.result.should == file_content("#{FILES_ROOT}/oneliner_converted.css")
+      end
+    end
+  end
+  
+end

data/spec/files/bg_base64.png

@@ -0,0 +1 @@
+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