spread 0.5

data/CHANGELOG

@@ -0,0 +1 @@
+10/22/08 - Initial version [Matthew Bass]

data/MIT-LICENSE

@@ -0,0 +1,16 @@
+Copyright (c) 2007-2008 Matthew Bass (http://matthewbass.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

@@ -0,0 +1,43 @@
+= spread
+
+Makes it easy to add tell-a-friend functionality to any Rails app.
+
+
+== Installation
+
+Install the gem directly:
+
+  sudo gem install pelargir-spread --source=http://gems.github.com
+  
+Or install the gem in your Rails project as a plugin:
+  
+  script/plugin install git://github.com/pelargir/spread.git
+
+Or clone the project:
+
+  git clone git://github.com/pelargir/spread.git
+
+
+== Usage
+
+Use spread's view helper to embed a link on the page you want to share:
+
+  <%= spread :something %>
+
+Let your controller know you're using spread:
+
+  class SomeController < ActionController::Base
+    spread :something
+  end
+
+That's all there is to it! (Spread's templates are currently static.
+I'm working on making them overrideable so expect that soon.)
+
+
+== Resources
+
+Repository: http://github.com/pelargir/spread
+Blog: http://matthewbass.com
+Author: Matthew Bass
+
+Extraction work sponsored by Terralien

data/Rakefile

@@ -0,0 +1,22 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the spread plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the spread plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'spread'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/deleted_files

@@ -0,0 +1,14 @@
+# Generated by the asset_copier plugin
+# http://github.com/pelargir/asset_copier
+#
+# Files that have been removed from the plugin and should also be removed from
+# any Rails projects that use the plugin should be listed here, one entry
+# per line. For example:
+#
+#   public/javascripts/foo.js
+#   app/views/foo/bar.erb.html
+#
+# Adding the paths above to this file would ensure that foo.js and bar.erb.html
+# both get removed from the target Rails project the next time the plugin's
+# files are copied over.
+

data/init.rb

@@ -0,0 +1,9 @@
+require 'spread'
+require 'spread/controller'
+require 'spread/asset_copier'
+
+if RAILS_ENV == "development"
+  Spread::AssetCopier.copy "spread"
+else
+  Spread::AssetCopier.warn "spread"
+end

data/install.rb

@@ -0,0 +1,20 @@
+# Generated by the asset_copier plugin
+# http://github.com/pelargir/asset_copier
+
+require 'rake'
+ 
+begin
+  puts "============================================================="
+  puts "Attempting to install required files into your application..."
+  puts "============================================================="
+  RAKE_FILE = File.expand_path(File.join(File.dirname(__FILE__), 'tasks', 'asset_copier.rake'))
+  load RAKE_FILE
+  
+  Rake::Task['spread:install'].invoke
+  puts "=========================================================="
+  puts "Success!"
+  puts "=========================================================="
+rescue Exception => ex
+  puts "FAILED TO INSTALL REQUIRED FILES.  PLEASE RUN rake spread:install."
+  puts "EXCEPTION: #{ex}"
+end

data/lib/spread.rb

@@ -0,0 +1,9 @@
+module Spread
+  def spread(action)
+    html = image_tag "spread/email.png", :alt => "Share with a friend", :size => "16x16", :valign => "middle"
+    html += link_to "Share with a friend", :action => action, :url => request.url
+    content_tag :div, html
+  end
+end
+
+ActionView::Base.send :include, Spread

data/lib/spread/asset_copier.rb

@@ -0,0 +1,90 @@
+# Generated by the asset_copier plugin
+# http://github.com/pelargir/asset_copier
+
+require 'find'
+require 'digest/md5'
+
+module Spread
+  class AssetCopier
+    @source = File.expand_path(File.join(File.dirname(__FILE__), '..', '..', 'files'))
+    @destination = RAILS_ROOT
+    @deleted_files = File.expand_path(File.join(File.dirname(__FILE__), '..', '..', 'deleted_files'))
+    class << self
+      attr_accessor :source, :destination, :deleted_files
+    end
+  
+    def self.copy(plugin_name)
+      begin
+        each_path do |path, dest_path, short_path| 
+          if File.directory?(path)
+            unless File.exists?(dest_path)
+              FileUtils.mkdir_p(dest_path)
+              log "Creating directory #{short_path} for #{plugin_name}"
+            end
+          elsif !compare(path, dest_path)
+            FileUtils.cp(path, dest_path)
+            log "Copying #{short_path} from #{plugin_name}"
+          end
+        end
+      rescue Exception => e
+        log "Error trying to copy files: #{e.inspect}"
+        raise e
+      end
+      print_deletion_warnings(plugin_name)
+    end
+  
+    def self.warn(plugin_name)
+      each_path do |path, dest_path, short_path|
+        next if File.directory?(path)
+        reinstall = false
+        if File.exists?(dest_path)
+          unless compare(path, dest_path)
+            log "WARNING: #{short_path} is out of date and needs to be reinstalled"
+            reinstall = true
+          end
+        else
+          reinstall = true
+          log "WARNING: #{short_path} is missing and needs to be installed"
+        end
+        log "WARNING: Please run rake #{plugin_name}:install" if reinstall
+      end
+      print_deletion_warnings(plugin_name)
+    end
+  
+    def self.compare(file1, file2)
+      File.exists?(file1) && File.exists?(file2) &&
+        Digest::MD5.hexdigest(File.read(file1)) == Digest::MD5.hexdigest(File.read(file2))
+    end
+  
+    def self.print_deletion_warnings(plugin_name)
+      File.open(deleted_files, "r") do |f|
+        f.readlines.reject { |l| l =~ /^#/ || l.strip.blank? }.each do |l|
+          log "WARNING: #{l} is no longer required by the #{plugin_name} plugin " <<
+              "and can can be safely removed" if File.exists?(l)
+        end
+      end
+    end
+  
+    def self.paths
+      returning [] do |paths|
+        Find.find(source) do |path|
+          Find.prune if path =~ /\/\..+/
+          Find.prune if path =~ /(CVS|.svn|.git)/
+          paths << path
+        end
+      end
+    end
+  
+    def self.each_path
+      paths.each do |path|
+        dest_path = path.gsub(source, destination)
+        short_path = dest_path.gsub("#{destination}/", "")
+        yield path, dest_path, short_path
+      end
+    end
+    
+    def self.log(msg)
+      puts msg
+    end
+  end
+end

data/lib/spread/controller.rb

@@ -0,0 +1,44 @@
+module Spread
+  module Controller
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+    
+    module ClassMethods
+      
+      def spread(action)
+        mailer = construct_mailer
+        construct_action(action, mailer)
+      end
+      
+      def construct_mailer
+        mailer = Class.new(ActionMailer::Base) do
+          def email(email, url)
+            recipients email
+            body :url => url
+          end
+        end
+        mailer.template_root = "#{RAILS_ROOT}/vendor/plugins/spread/templates/"
+        mailer
+      end
+      
+      def construct_action(action, mailer)
+        define_method action do
+          if request.post?
+            if params[:email].blank?
+              flash[:error] = "Email cannot be blank"
+            else
+              mailer.deliver_email(params[:email], params[:url])
+              flash[:notice] = "An email has been sent to #{params[:email]}"
+              redirect_to params[:url] || "/" and return
+            end
+          end
+          render :file => "#{RAILS_ROOT}/vendor/plugins/spread/templates/form.html.erb"
+        end
+      end
+      
+    end
+  end
+end
+
+ActionController::Base.send :include, Spread::Controller

data/spread.gemspec

@@ -0,0 +1,30 @@
+Gem::Specification.new do |s|
+  s.name     = "spread"
+  s.version  = "0.5"
+  s.date     = "2008-10-22"
+  s.summary  = "Makes it easy to add tell-a-friend functionality to any Rails app."
+  s.email    = "pelargir@gmail.com"
+  s.homepage = "http://github.com/pelargir/spread"
+  s.description = "Makes it easy to add tell-a-friend functionality to any Rails app."
+  s.has_rdoc = true
+  s.authors  = ["Matthew Bass"]
+  s.files    = [
+    "CHANGELOG",
+    "deleted_files",
+    "files/public/images/spread/email.png",
+    "init.rb",
+    "install.rb",
+		"lib/spread.rb",
+		"lib/spread/asset_copier.rb",
+		"lib/spread/controller.rb",
+    "MIT-LICENSE",
+    "Rakefile",
+		"README",
+		"spread.gemspec",
+		"tasks/asset_copier.rake",
+		"templates/email.html.erb",
+		"templates/form.html.erb"
+		]
+  s.rdoc_options = ["--main", "README"]
+  s.extra_rdoc_files = ["README"]
+end

data/tasks/asset_copier.rake

@@ -0,0 +1,11 @@
+# Generated by the asset_copier plugin
+# http://github.com/pelargir/asset_copier
+
+require File.expand_path(File.dirname(__FILE__) + '/../lib/spread/asset_copier')
+
+namespace :spread do
+  desc "Install files required by spread"
+  task :install do  
+    Spread::AssetCopier.copy "spread"
+  end
+end

data/templates/email.html.erb

@@ -0,0 +1,3 @@
+I found something interesting on this web site. Check it out:
+
+<%= @url %>

data/templates/form.html.erb

@@ -0,0 +1,9 @@
+<%= flash[:error] %>
+<% form_tag do -%>
+  <%= hidden_field_tag :url, params[:url] %>
+  <%= label_tag :email %>
+  <%= text_field_tag :email %>
+  <br/>
+  <%= submit_tag "Share" %> or
+  <%= link_to "cancel", params[:url] %>
+<% end -%>

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification 
+name: spread
+version: !ruby/object:Gem::Version 
+  version: "0.5"
+platform: ruby
+authors: 
+- Matthew Bass
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-10-22 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: Makes it easy to add tell-a-friend functionality to any Rails app.
+email: pelargir@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- CHANGELOG
+- deleted_files
+- files/public/images/spread/email.png
+- init.rb
+- install.rb
+- lib/spread.rb
+- lib/spread/asset_copier.rb
+- lib/spread/controller.rb
+- MIT-LICENSE
+- Rakefile
+- README
+- spread.gemspec
+- tasks/asset_copier.rake
+- templates/email.html.erb
+- templates/form.html.erb
+has_rdoc: true
+homepage: http://github.com/pelargir/spread
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README
+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.3.4
+signing_key: 
+specification_version: 3
+summary: Makes it easy to add tell-a-friend functionality to any Rails app.
+test_files: []
+