elliottcable-jello 2

data/.manifest

@@ -0,0 +1,13 @@
+bin/jello
+lib/jello/core_ext/kernel.rb
+lib/jello/logger.rb
+lib/jello/mould.rb
+lib/jello/pasteboard.rb
+lib/jello.rb
+moulds/grabup.rb
+moulds/say.rb
+moulds/shorten.rb
+Rakefile.rb
+README.markdown
+spec/jello_spec.rb
+.manifest

data/README.markdown

@@ -0,0 +1,73 @@
+Jello
+=====
+
+Because everybody likes "paste & jello" sandwiches, right? I know I did when I
+was a kid.
+
+Jello is a simple library to watch the OS X pasteboard and do something on
+every paste.
+
+    require 'jello'
+
+    Jello::Mould.new do |paste|
+      system "say 'You pasted #{paste}'"
+    end
+    
+    Jello.start!
+
+For example, to watch for URLs copied, and then shorten the URL and replace
+the long URL with the shortened one, write a short mould like the following:
+    
+    require 'open-uri'
+    require 'jello'
+    
+    Jello::Mould.new do |paste|
+    
+      if paste =~ %r{}^http://.*}
+        uri = $&
+        uri.gsub! /#/, '%23'
+        unless uri =~ %r{^http://bit.ly}
+          shortener = 'http://bit.ly/api?url=' + uri
+          open(shortener).gets.chomp
+        else
+          nil
+        end
+      end
+      
+    end
+    
+    Jello.start! :verbose => true
+    
+Moulds can even be stacked:
+    
+    require 'jello'
+    
+    Jello::Mould.new do |paste|
+      paste += '123'
+    end
+    
+    Jello::Mould.new do |paste|
+      paste += '456'
+    end
+    
+    Jello.start! :verbose => true
+    
+Jello also provides a binary - if you have some moulds you use often, you can
+throw them in your `~/.jello/` folder (as .rb files), and then run jello with
+them:
+    
+    # Assuming ~/.jello/ contains foo.rb, bar.rb, and gaz/{one,two}.rb
+    $ jello foo bar gaz
+    # Now foo.rb, bar.rb, one.rb, and two.rb would be executed on incoming
+    # pastes
+    
+Finally, you can use pasteboards other than the general one (see `man pbcopy`
+for more information about this):
+    
+    require 'jello'
+    
+    Jello::Mould.new do Jello::Pasteboard::Find |paste|
+      paste.gsub! /abc/, 'def'
+    end
+    
+    Jello.start!

data/Rakefile.rb

@@ -0,0 +1,138 @@
+($:.unshift File.expand_path(File.join( File.dirname(__FILE__), 'lib' ))).uniq!
+require 'jello'
+
+require 'fileutils'
+
+# =======================
+# = Gem packaging tasks =
+# =======================
+begin
+  require 'echoe'
+  
+  task :package => :'package:install'
+  task :manifest => :'package:manifest'
+  namespace :package do
+    Echoe.new('jello', Jello::Version) do |g|
+      g.project = 'jello'
+      g.author = ['elliottcable']
+      g.email = ['Jello@elliottcable.com']
+      g.summary = 'A library to watch the OS X pasteboard, and process/modify incoming pastes.'
+      g.url = 'http://github.com/elliottcable/jello'
+      g.development_dependencies = ['echoe >=3.0.1', 'rspec', 'rcov', 'yard', 'stringray']
+      g.manifest_name = '.manifest'
+      g.ignore_pattern = /^\.git\/|^meta\/|\.gemspec/
+    end
+  
+    desc 'tests packaged files to ensure they are all present'
+    task :verify => :package do
+      # An error message will be displayed if files are missing
+      if system %(ruby -e "require 'rubygems'; require 'pkg/jello-#{Jello::Version}/lib/jello'")
+        puts "\nThe library files are present"
+      end
+    end
+
+    task :copy_gemspec => [:package] do
+      pkg = Dir['pkg/*'].select {|dir| File.directory? dir}.last
+      mv File.join(pkg, pkg.gsub(/^pkg\//,'').gsub(/\-\d+$/,'.gemspec')), './'
+    end
+
+    desc 'builds a gemspec as GitHub wants it'
+    task :gemspec => [:package, :copy_gemspec, :clobber_package]
+  end
+  
+rescue LoadError
+  desc 'You need the `echoe` gem to package Jello'
+  task :package
+end
+
+# =======================
+# = Spec/Coverage tasks =
+# =======================
+begin
+  require 'spec'
+  require 'rcov'
+  require 'spec/rake/spectask'
+  
+  task :default => :'coverage:run'
+  task :coverage => :'coverage:run'
+  namespace :coverage do
+    Spec::Rake::SpecTask.new(:run) do |t|
+      t.spec_opts = ["--format", "specdoc"]
+      t.spec_opts << "--colour" unless ENV['CI']
+      t.spec_files = Dir['spec/**/*_spec.rb'].sort
+      t.libs = ['lib']
+      t.rcov = true
+      t.rcov_opts = [ '--include-file', '"^lib"', '--exclude-only', '".*"']
+      t.rcov_dir = File.join('meta', 'coverage')
+    end
+    
+    begin
+      require 'spec/rake/verify_rcov'
+      # For the moment, this is the only way I know of to fix RCov. I may
+      # release the fix as it's own gem at some point in the near future.
+      require 'stringray/core_ext/spec/rake/verify_rcov'
+      RCov::VerifyTask.new(:verify) do |t|
+        t.threshold = 65.0
+        t.index_html = File.join('meta', 'coverage', 'index.html')
+        t.require_exact_threshold = false
+      end
+    rescue LoadError
+      desc 'You need the `stringray` gem to verify coverage'
+      task :verify
+    end
+    
+    task :open do
+      system 'open ' + File.join('meta', 'coverage', 'index.html') if PLATFORM['darwin']
+    end
+  end
+  
+rescue LoadError
+  desc 'You need the `rcov` and `rspec` gems to run specs/coverage'
+  task :coverage
+end
+
+# =======================
+# = Documentation tasks =
+# =======================
+begin
+  require 'yard'
+  require 'yard/rake/yardoc_task'
+  
+  task :documentation => :'documentation:generate'
+  namespace :documentation do
+    YARD::Rake::YardocTask.new :generate do |t|
+      t.files   = ['lib/**/*.rb']
+      t.options = ['--output-dir', File.join('meta', 'documentation'),
+                   '--readme', 'README.markdown']
+    end
+    
+    YARD::Rake::YardocTask.new :dotyardoc do |t|
+      t.files   = ['lib/**/*.rb']
+      t.options = ['--no-output',
+                   '--readme', 'README.markdown']
+    end
+    
+    task :open do
+      system 'open ' + File.join('meta', 'documentation', 'index.html') if PLATFORM['darwin']
+    end
+  end
+  
+rescue LoadError
+  desc 'You need the `yard` gem to generate documentation'
+  task :documentation
+end
+
+# =========
+# = Other =
+# =========
+desc 'Removes all meta producs'
+task :clobber do
+  `rm -rf #{File.expand_path(File.join( File.dirname(__FILE__), 'meta' ))}`
+end
+
+desc 'Check everything over before commiting'
+task :aok => [:'documentation:generate', :'documentation:open',
+              :'package:manifest',
+              :'coverage:run', :'coverage:verify', :'coverage:open']
+
+task :ci => [:'documentation:generate', :'coverage:run', :'coverage:verify']

data/bin/jello

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby -Ku
+($:.unshift File.expand_path(File.join( File.dirname(__FILE__), '..', 'lib' ))).uniq!
+%w[jello rubygems optparse].each {|dep| require dep }
+
+options = Hash.new
+OptionParser.new do |opts|
+  opts.banner = "Usage: jello [options] <mould> (<mould> …)"
+  
+  opts.on("-v", "--[no-]verbose", "Run verbosely") do |v|
+    options[:verbose] = v
+  end
+end.parse!
+
+ARGV.each do |mould|
+  require Jello::Mould.find(mould)
+end
+
+Jello.start! options

data/jello.gemspec

@@ -0,0 +1,128 @@
+
+# Gem::Specification for Jello-2
+# Originally generated by Echoe
+
+--- !ruby/object:Gem::Specification 
+name: jello
+version: !ruby/object:Gem::Version 
+  version: "2"
+platform: ruby
+authors: 
+- elliottcable
+autorequire: 
+bindir: bin
+
+date: 2008-09-29 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: echoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 3.0.1
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rcov
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: yard
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: stringray
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: A library to watch the OS X pasteboard, and process/modify incoming pastes.
+email: 
+- Jello@elliottcable.com
+executables: 
+- jello
+extensions: []
+
+extra_rdoc_files: 
+- bin/jello
+- lib/jello/core_ext/kernel.rb
+- lib/jello/logger.rb
+- lib/jello/mould.rb
+- lib/jello/pasteboard.rb
+- lib/jello.rb
+- README.markdown
+files: 
+- bin/jello
+- lib/jello/core_ext/kernel.rb
+- lib/jello/logger.rb
+- lib/jello/mould.rb
+- lib/jello/pasteboard.rb
+- lib/jello.rb
+- moulds/grabup.rb
+- moulds/say.rb
+- moulds/shorten.rb
+- Rakefile.rb
+- README.markdown
+- spec/jello_spec.rb
+- .manifest
+- jello.gemspec
+has_rdoc: true
+homepage: http://github.com/elliottcable/jello
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Jello
+- --main
+- README.markdown
+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: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: jello
+rubygems_version: 1.3.0
+specification_version: 2
+summary: A library to watch the OS X pasteboard, and process/modify incoming pastes.
+test_files: []

data/lib/jello/core_ext/kernel.rb

@@ -0,0 +1,24 @@
+module Kernel
+  def forever &block
+    __forever__(&block ||= lambda {})
+  end
+  
+  def __forever__
+    begin
+      while true
+        yield
+      end
+    rescue Interrupt
+      exit
+    end
+  end
+  
+  # Execute some code without any warnings
+  def silently
+    old_verbose, $VERBOSE = $VERBOSE, nil
+    yield
+  ensure
+    $VERBOSE = old_verbose
+  end
+  
+end

data/lib/jello/logger.rb

@@ -0,0 +1,5 @@
+class Logger
+  include Singleton
+  
+  # TODO
+end

data/lib/jello/mould.rb

@@ -0,0 +1,77 @@
+module Jello
+  
+  ##
+  # A hash of each pasteboard and the moulds that preform on that pasteboard.
+  Moulds = Pasteboards.inject(Hash.new) {|h,pb| h[pb] = Array.new ; h }
+  
+  class Mould
+    
+    ##
+    # This checks the Jello require paths for a mould by that name. The
+    # following directories are checked, in this order:
+    # 
+    #  - `$HOME/.jello/*.rb`
+    #  - `/etc/jello/*.rb`
+    #  - `$JELLO_SRC/moulds/*.rb`
+    # 
+    # The first one with a file by the correct name will overide any later
+    # ones.
+    def self.find name
+      [File.join(ENV['HOME'], '.jello'),
+      File.join('etc', 'jello'),
+      File.join( File.dirname(__FILE__), '..', '..', 'moulds' )].each do |dir|
+        dir = File.expand_path(dir)
+        
+        if File.directory? dir
+          Dir["#{dir}/**/*.rb"].each do |file|
+            # This should be quite powerful - if you have a directory of
+            # moulds, you can select them all, or you can select all of them
+            # plus a single-file mould of the same name. Or whatever you might
+            # want. Mmmsexy? Mmmsexy.
+            return file if file.gsub(/^#{dir}/, '') =~ /#{name}/
+          end
+        end
+        
+      end
+      
+      return nil
+    end
+    
+    ##
+    # This takes a block that will be executed on every paste received by
+    # Jello.
+    attr_accessor :on_paste
+    
+    ##
+    # Acts as both a getter and a setter for the @on_paste attribute. If
+    # passed a block, it sets that block as the @on_paste hook - else it
+    # returns the current hook block.
+    # 
+    # @see @on_paste
+    def on_paste &block
+      if block_given?
+        @on_paste = block
+      else
+        @on_paste
+      end
+    end
+    
+    ##
+    # Creates a new Mould. Takes a block to be run on every paste.
+    def initialize pasteboard = nil, &block
+      @pasteboard = pasteboard || Pasteboard::General
+      @on_paste = block
+      
+      Moulds[@pasteboard] << self
+    end
+    
+    ##
+    # We pass any missing methods on to the Pasteboard.
+    # 
+    # @see Jello::Pasteboard
+    def method_missing meth, *args
+      @pasteboard.send meth, *args
+    end
+    
+  end
+end

data/lib/jello/pasteboard.rb

@@ -0,0 +1,110 @@
+module Jello
+  Pasteboards = []
+  
+  class Pasteboard
+    
+    ## 
+    # The type of board to connect to. Available are the following:
+    # 
+    #  - :general [default]
+    #  - :ruler
+    #  - :find
+    #  - :font
+    # 
+    # OS X offers various pasteboards for use, depending on what you want to
+    # access. They're synced across the entire system. More information is
+    # available under `man pbpaste`.
+    # 
+    # @see #gets
+    # @see #puts
+    attr_reader :board
+    
+    ##
+    # The type of data to request from the board. Available are the following:
+    # 
+    #  - :ascii [default]
+    #  - :rtf  (Rich Text)
+    #  - :ps (PostScript)
+    # 
+    # You're not guaranteed to receive that type, however - you'll receive it if
+    # it's available, otherwise you'll receive the first in the above list that
+    # is available. More information is available under `man pbpaste`.
+    # 
+    # @see #gets
+    attr_accessor :format
+    
+    ##
+    # The last paste recognized by the pasteboard. If you modify the contents
+    # of the pasteboard, you can save processing time by also updating this
+    # property with said contents, preventing an extra loop.
+    attr_accessor :last
+    
+    attr_accessor :current
+    
+    ##
+    # This creates a new Pasteboard instance, connected to one of the available
+    # Mac OS X pasteboards. You shouldn't use this directly - use one of the
+    # pre-defined constants instead.
+    # 
+    # @see #gets
+    # @see #puts
+    def initialize options = {}
+      @board ||= options[:board] || :general
+      @format ||= options[:format] || :ascii
+    
+      yield self if block_given?
+      
+      @current = ""
+      @last = ""
+    end
+    
+    ##
+    # This method gets the latest paste from the selected pasteboard,
+    # of the selected format (if possible - see `#format`).
+    # 
+    # @see @board
+    # @see @format
+    def gets
+      @last = @current
+      command = 'pbpaste'
+      command << " -pboard #{@board}" if @board
+      @current = %x[#{command}].chomp
+    end
+    
+    ##
+    # This method puts a new entry into the selected pasteboard. Format is
+    # automatically deduced from the headers of your string (see `man pbpaste`
+    # for more info.)
+    # 
+    # @see @board
+    def puts something
+      command = 'pbcopy'
+      command << " -pboard #{@board}" if @board
+      command << " -Prefer #{@format}" if @format
+      out = IO::popen command, 'w+'
+      out.print something
+      out.close
+      something
+    end
+    
+    
+    ##
+    # A pasteboard that stores general text
+    General = new :board => :general
+    
+    ##
+    # Unknown
+    Ruler = new :board => :ruler
+    
+    ##
+    # A pasteboard that stores the text used in find dialogues
+    Find = new :board => :find
+    
+    ##
+    # Unknown
+    Font = new :board => :font
+    
+    [General, Ruler, Find, Font].each {|pb| Pasteboards << pb }
+    
+  end
+end

data/lib/jello.rb

@@ -0,0 +1,37 @@
+require 'jello/core_ext/kernel'
+require 'jello/pasteboard'
+require 'jello/mould'
+
+module Jello
+  Version = 2
+  
+  def self.start! options = {}
+    options = {:verbose => false, :period => 0.5}.merge(options)
+    
+    forever do
+      
+      Moulds.each do |pasteboard, moulds|
+        if (paste = pasteboard.gets) != pasteboard.last
+          initial_paste = paste.dup
+          
+          puts "#{pasteboard.board} received: [#{initial_paste}]" if options[:verbose]
+          moulds.each do |mould|
+            paste = mould.on_paste[paste]
+          end
+          
+          if paste.is_a?(String) and paste != initial_paste
+            puts " --> [#{paste}]" if options[:verbose]
+            pasteboard.puts paste 
+          end
+        end
+      end
+      
+      sleep options[:period]
+    end
+  end
+  
+  def self.stop!
+    raise Interrupt # …
+  end
+  
+end

data/moulds/grabup.rb

@@ -0,0 +1,8 @@
+require 'open-uri'
+
+Jello::Mould.new do |paste|
+  if paste =~ %r{^http://www\.grabup\.com/uploads/[0-9a-z]{32}\.png$}
+    paste.gsub!(%r{^http://www\.}, 'http://')
+    paste += '?direct'
+  end
+end

data/moulds/say.rb

@@ -0,0 +1,3 @@
+Jello::Mould.new do |paste|
+  system "say 'You pasted #{paste}'"
+end

data/moulds/shorten.rb

@@ -0,0 +1,19 @@
+require 'rubygems'
+require 'JSON'
+
+Jello::Mould.new do |paste, board|
+  
+  if paste =~ %r{^http://.*}
+    uri = $&
+    unless paste =~ %r{^http://tr.im}
+      uri.gsub! /#/, '%23' # Fix anchors
+      
+      shortener = 'http://tr.im/api/trim_url.json?url=' + uri
+      
+      reply = open(shortener).read
+      short = JSON.parse reply
+      short['url']
+    end
+  end
+  
+end

data/spec/jello_spec.rb

@@ -0,0 +1,2 @@
+($:.unshift File.expand_path(File.join( File.dirname(__FILE__), '..', 'lib' ))).uniq!
+require 'jello'

metadata

@@ -0,0 +1,126 @@
+--- !ruby/object:Gem::Specification 
+name: elliottcable-jello
+version: !ruby/object:Gem::Version 
+  version: "2"
+platform: ruby
+authors: 
+- elliottcable
+autorequire: 
+bindir: bin
+cert_chain: 
+date: 2008-09-29 01:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: echoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 3.0.1
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rcov
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: yard
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: stringray
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: A library to watch the OS X pasteboard, and process/modify incoming pastes.
+email: 
+- Jello@elliottcable.com
+executables: 
+- jello
+extensions: []
+
+extra_rdoc_files: 
+- bin/jello
+- lib/jello/core_ext/kernel.rb
+- lib/jello/logger.rb
+- lib/jello/mould.rb
+- lib/jello/pasteboard.rb
+- lib/jello.rb
+- README.markdown
+files: 
+- bin/jello
+- lib/jello/core_ext/kernel.rb
+- lib/jello/logger.rb
+- lib/jello/mould.rb
+- lib/jello/pasteboard.rb
+- lib/jello.rb
+- moulds/grabup.rb
+- moulds/say.rb
+- moulds/shorten.rb
+- Rakefile.rb
+- README.markdown
+- spec/jello_spec.rb
+- .manifest
+- jello.gemspec
+has_rdoc: true
+homepage: http://github.com/elliottcable/jello
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Jello
+- --main
+- README.markdown
+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: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: jello
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: A library to watch the OS X pasteboard, and process/modify incoming pastes.
+test_files: []
+