mattpuchlerz-liquid_premailer 0.0.2

data/CHANGELOG

@@ -0,0 +1,4 @@
+= Liquid Premailer CHANGELOG
+
+== Version 0.0.1
+ * First try

data/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2009 Matt Puchlerz, The Killswitch Collective
+http://killswitchcollective.com
+ 
+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.rdoc

@@ -0,0 +1,84 @@
+= Liquid Premailer
+
+<em>Developed by Matt Puchlerz, The Killswitch Collective (http://killswitchcollective.com) 02.10.2009</em>
+
+As awesome as the Premailer gem is, it didn't help with making Liquid templates any easier. My idea was to create a simple, consistent method by which you could write your markup, style it, premailer-it, and have the associated Liquid calls right there as well.
+
+Using liquid_premailer on the command line will convert your source HTML file, filled with dummy data and commented-out Liquid calls, into ready-to-go Liquid email templates.
+
+== Examples 
+
+=== Using the liquid_premailer Command
+
+  $ liquid_premailer myfile.html
+  
+...will output myfile_liquid.html. That's it!
+
+=== Dummy Data and Hidden Liquid Output
+
+  <style type="text/css">
+    h1 {
+      font-family: verdana, sans-serif;
+      font-size: 20px;
+    }
+  </style>
+
+  <h1><!---->Here is a Fake Headline<!--{{ email.headline }}--></h1>
+  
+...will become...
+
+  <h1 style="font-family: verdana, sans-serif; font-size: 20px;">{{ email.headline }}</h1>
+  
+=== Hidden Liquid Tags
+
+  <!--{% if email.is_a_pain %}-->
+  <p>Man, HTML emails are a pain to work with.</p>
+  <!--{% endif %}-->
+  
+...will become...
+
+  {% if email.is_a_pain %}
+  <p>Man, HTML emails are a pain to work with.</p>
+  {% endif %}
+  
+=== Complex Example
+
+  <style type="text/css">
+    p {
+      font-family: verdana, sans-serif;
+      font-size: 12px;
+    }
+    span.phone {
+      color: red;
+    }
+  </style>
+
+  <p>
+    <!--{% if sender.phone != blank %}-->
+    <span class="phone"><!---->123-456-7890<!--{{ sender.phone }}--></span><br />
+    <!--{% endif %}-->
+    <!--{% if sender.mobile_phone != blank %}-->
+    <span class="mobile"><!---->098-765-4321<!--{{ sender.mobile_phone }}--> (mobile)</span>
+    <!--{% endif %}-->
+  </p>
+
+...will become...
+
+  <p style="font-family: verdana, sans-serif; font-size: 12px;">
+    {% if sender.phone != blank %}
+    <span>{{ sender.phone }}</span><br />
+    {% endif %}
+    {% if sender.mobile_phone != blank %}
+    <span style="color: red;">{{ sender.mobile_phone }} (mobile)</span>
+    {% endif %}
+  </p>
+
+== Requirements, installation and use
+
+First, download and install the Premailer gem from http://code.dunae.ca/premailer.web/local.html.
+
+Then install the liquid_premailer gem:
+
+  $ sudo gem install mattpuchlerz-liquid_premailer
+
+liquid_premailer should now be available in your path.

data/bin/liquid_premailer

@@ -0,0 +1,106 @@
+#!/usr/bin/env ruby
+
+require 'optparse'
+require 'optparse/time'
+require 'ostruct'
+require 'fileutils'
+
+def exit_with_error(opts, msg = '')
+  puts msg + "\n\n" unless msg.empty?
+  puts opts
+  exit
+end
+
+################################################################################
+
+options = OpenStruct.new
+options.plaintext = false
+options.querystring = ''
+options.baseurl = ''
+options.warnings = false
+ 
+opts = OptionParser.new do |opts|
+  opts.banner = "Usage: liquid_premailer inputfile outputfile [options]\n Examples:\n"
+  opts.banner << "  liquid_premailer myfile.html\n"
+  opts.banner << "  liquid_premailer http://example.com/myfile.html myliquidfile.html -w -q src=email"
+  opts.separator ""
+  opts.separator "Specific options:"
+
+  opts.on("-t", "--plaintext", "Create plain-text version") do |t|
+    options.plaintext = t
+  end
+
+  opts.on("-q", "--querystring [STRING]", "Query string to append to links") do |qs|
+    options.querystring = qs || ''
+    options.querystring.gsub!(/^\?/, '')
+  end
+
+  opts.on("-b", "--baseurl [STRING]", "Base URL; only applies to local files") do |bs|
+    options.baseurl = bs
+  end
+
+  opts.on("-w", "--warnings", "Generate CSS/HTML warnings") do |w|
+    options.warnings = w
+  end
+
+  opts.on_tail("-h", "--help", "Show this message") do
+    puts opts
+    exit
+  end
+end
+opts.parse!(ARGV)
+
+src_url = ARGV[0]
+exit_with_error(opts, "You must specify a file to parse") if src_url.nil?
+
+outfile = ARGV[1] || src_url
+outfile = "#{outfile.sub('.html', '')}_liquid"
+exit_with_error(opts, "You must specify an output file") if outfile.nil?
+
+outdir = File.dirname(outfile)
+
+unless File.exists?(outdir) and File.directory?(outdir)
+  FileUtils.mkdir_p outdir
+end
+
+################################################################################
+
+puts "Parsing #{src_url}"
+puts " - plaintext: #{options.plaintext}"
+puts " - querystring: #{options.querystring}"
+
+unless src_url =~ /^(http|https|ftp)\:\/\//i
+  raise "Could not find #{src_url}" unless File.exists?(src_url)
+end
+
+premailer_cmd = "premailer #{src_url} #{outfile}"
+premailer_cmd << " -t" if options.plaintext
+premailer_cmd << " -q" unless options.querystring.empty?
+premailer_cmd << " -b" unless options.baseurl.empty?
+premailer_cmd << " -w" if options.warnings
+`#{premailer_cmd}`
+
+outfile << ".html"
+
+################################################################################
+
+html = File.new(outfile).read
+liquid_file = File.new(outfile, 'w')
+
+html.gsub!('%7B', '{')
+html.gsub!('%7D', '}')
+html.gsub!('%20', ' ')
+
+html.gsub!(/ id=\".+?\"/, '')
+html.gsub!(/ class=\"editable\"/, ' temp_editable')
+html.gsub!(/ class=\".+?\"/, '')
+html.gsub!(' temp_editable', ' class="editable"')
+
+html.gsub!(/<!---->.+?<!--(.+?)-->/m, '\1')
+html.gsub!(/<!--\s*\{\%/, '{%')
+html.gsub!(/\%\}\s*-->/, '%}')
+
+liquid_file.write(html)
+liquid_file.close
+
+puts "Finished premailer-ing and dummy-data-stripping and liquid-ing #{outfile}"

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification 
+name: mattpuchlerz-liquid_premailer
+version: !ruby/object:Gem::Version 
+  version: 0.0.2
+platform: ruby
+authors: 
+- Matt Puchlerz
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-02-05 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: premailer
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.5.0
+    version: 
+description: 
+email: matt@killswitchcollective.com
+executables: 
+- liquid_premailer
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.rdoc
+- CHANGELOG
+- LICENSE
+- bin/liquid_premailer
+has_rdoc: false
+homepage: http://killswitchcollective.com
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Takes an HTML file, premailer-izes it, and then strips out any dummy data you have in place of Liquid calls.
+test_files: []
+