pennyworth 0.1.0

data/CHANGELOG.rdoc

@@ -0,0 +1,3 @@
+= v0.1.0
+
+* Initial version.

data/LICENSE.rdoc

@@ -0,0 +1,20 @@
+Copyright (c) 2012 {Red Alchemist}[http://www.redalchemist.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,101 @@
+= Overview
+
+{<img src="https://secure.travis-ci.org/bkuhlmann/pennyworth.png" />}[http://travis-ci.org/bkuhlmann/pennyworth]
+
+Enhances and extends Alfred by providing a Ruby command line interface (CLI) via Alfred Extensions. Each Alfred Extension,
+packaged as part of this gem, references back to the Ruby CLI. Output is provided via Growl.
+
+= Features
+
+* Adds Ruby support to Alfred.
+* Adds the launch_browsers file extension.
+* Adds the apple_say script extension.
+* Adds the directory_size script extension.
+* Adds the edit_bash_file script extension.
+* Adds the edit_dotfile script extension.
+* Adds the edit_file script extension.
+* Adds the mac_serial script extension.
+* Adds the mem_purge script extension.
+* Adds the open_url_in_chrome script extension.
+* Adds the open_url_in_opera script extension.
+* Adds the open_url_in_safari script extension.
+* Adds the restart_rails script extension.
+* Adds the string_capitalize script extension.
+* Adds the string_downcase script extension.
+* Adds the string_length script extension.
+* Adds the string_upcase script extension.
+
+= Requirements
+
+1. {Mac OS X}[http://www.apple.com/macosx]
+2. Alfred[http://www.alfredapp.com]
+3. {Alfred Powerpack}[http://www.alfredapp.com/purchase].
+4. Growl[http://growl.info].
+5. rbenv[https://github.com/sstephenson/rbenv].
+6. {Ruby 1.9.x}[http://www.ruby-lang.org].
+
+= Setup
+
+Type the following from the command line to install:
+
+  gem install pennyworth
+
+You can configure common settings for future gem builds by creating the following file:
+
+  ~/.pennyworth/settings.yml
+
+...using the following settings (for example):
+
+  --- 
+  :alfred_settings_root: "/Users/brooke/Dropbox/Cache/Alfred"
+
+= Usage
+
+From the command line, type: pennyworth
+
+  pennyworth -e, [edit]     # Edit gem settings in default editor (assumes $EDITOR environment variable).
+  pennyworth -h, [help]     # Show this message.
+  pennyworth -i, [install]  # Install Alfred Extensions.
+  pennyworth -s, [string]   # Manipulate strings.
+  pennyworth -v, [version]  # Show version.
+
+For string options, type: pennyworth help string
+
+  -d, [--downcase=one two three]    # Downcase a string.
+  -u, [--upcase=one two three]      # Upcase a string.
+  -c, [--capitalize=one two three]  # Capitalize words in a string.
+  -l, [--length=one two three]      # Answer the length of a string.
+
+While the command line options are nice, the real power comes from running the following command:
+
+  pennyworth -i
+
+...which installs the Alfred Extensions packaged as part of this gem. You can then use the Alfred commands
+provided by each extension rather than use the CLI. Check the documentation of each installed extension (as listed
+in the features list above) for further usage.
+
+= Tests
+
+To test, do the following:
+
+1. cd to the gem root.
+2. bundle install
+3. bundle exec rspec spec
+
+= Contributions
+
+Please log all feedback/issues via {GitHub Issues}[https://github.com/bkuhlmann/pennyworth/issues] for the project. Thanks.
+
+= Credits
+
+Developed by {Brooke Kuhlmann}[http://www.redalchemist.com] at {Red Alchemist}[http://www.redalchemist.com]
+
+= License
+
+Copyright (c) 2012 {Red Alchemist}[http://www.redalchemist.com].
+Read the LICENSE for details.
+
+= History
+
+Read the CHANGELOG for details.
+Built with Gemsmith[https://github.com/bkuhlmann/gemsmith].

data/bin/pennyworth

@@ -0,0 +1,6 @@
+#!/usr/bin/ruby
+# encoding: UTF-8
+
+require "pennyworth"
+require "pennyworth/cli"
+Pennyworth::CLI.start

data/lib/pennyworth/cli.rb

@@ -0,0 +1,89 @@
+require "yaml"
+require "thor"
+require "thor/actions"
+require "thor_plus/actions"
+
+module Pennyworth
+  class CLI < Thor
+  	include Thor::Actions
+  	include ThorPlus::Actions
+
+    # Overwrites the Thor template source root.
+    def self.source_root
+      File.expand_path File.join(File.dirname(__FILE__), "templates")
+    end
+
+    # Initialize.
+    def initialize args = [], options = {}, config = {}
+      super args, options, config
+      @settings_file = File.join ENV["HOME"], ".pennyworth", "settings.yml"
+      @settings = load_yaml @settings_file
+    end
+
+    desc "-s, [string]", "Manipulate strings."
+    map "-s" => :string
+    method_option :downcase, aliases: "-d", desc: "Downcase a string.", type: :array
+    method_option :upcase, aliases: "-u", desc: "Upcase a string.", type: :array
+    method_option :capitalize, aliases: "-c", desc: "Capitalize words in a string.", type: :array
+    method_option :length, aliases: "-l", desc: "Answer the length of a string.", type: :array
+    def string
+      case
+      when options[:downcase] then
+        string = Pennyworth::Kit.array_to_string options[:downcase]
+        puts Pennyworth::Kit.clip(string.downcase)
+      when options[:upcase] then
+        string = Pennyworth::Kit.array_to_string options[:upcase]
+        puts Pennyworth::Kit.clip(string.upcase)
+      when options[:capitalize] then
+        words = options[:capitalize].map {|word| word.capitalize}
+        words = Pennyworth::Kit.array_to_string words
+        puts Pennyworth::Kit.clip(words)
+      when options[:length] then
+        string = Pennyworth::Kit.array_to_string options[:length]
+        Pennyworth::Kit.clip(string)
+        puts string.length
+      else say("Type 'pennyworth help string' for usage.")
+      end
+    end
+
+    desc "-i, [install]", "Install Alfred Extensions."
+    map "-i" => :install
+    def install
+      say
+      
+      if valid_file?(@settings[:alfred_settings_root], "Invalid directory for Alfred settings root")
+        if yes? "Installing Alfred Extensions will destroy exiting extensions of the same name. Continue (y/n)?"
+          info "Installing Alfred Extensions..."
+          info "Alfred settings root: #{@settings[:alfred_settings_root]}"
+          %w(files scripts).each do |folder|
+            directory File.join("alfred", "extensions", folder), File.join(@settings[:alfred_settings_root], "extensions", folder)
+          end
+          info "Alfred Extensions installed."
+        else
+          info "Alfred Extenions installation cancelled."
+        end
+      else
+        error "Invalid directory for Alfred settings root: #{@settings[:alfred_settings_root]}"
+      end
+
+      say
+    end
+
+    desc "-e, [edit]", "Edit gem settings in default editor (assumes $EDITOR environment variable)."
+    map "-e" => :edit
+    def edit
+      `$EDITOR #{@settings_file}`
+    end
+
+    desc "-v, [version]", "Show version."
+    map "-v" => :version
+    def version
+    	say "Pennyworth " + VERSION
+    end
+    
+    desc "-h, [help]", "Show this message."
+    def help task = nil
+      say and super
+    end
+  end
+end

data/lib/pennyworth/kit.rb

@@ -0,0 +1,20 @@
+module Pennyworth
+  # Provides supplementary utility methods.
+  class Kit
+    # Builds a string from an array.
+    # ==== Parameters
+    # * +array+ - Required. The array to build a string from.
+    # * +delimiter+ - Optional. The delimiter used to join each array element. Default: ' ' 
+    def self.array_to_string array, delimiter = ' '
+      array * delimiter
+    end
+
+    # Sends text to the Mac OS clipboard.
+    # ==== Parameters
+    # * +text+ - Required. The text to send to the clipboard.
+    def self.clip text
+      IO.popen("pbcopy", 'w').print text
+      text
+    end
+  end
+end

data/lib/pennyworth/templates/alfred/extensions/files/launch_browsers/info.plist

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>category</key>
+	<string>FILES</string>
+	<key>files</key>
+	<array>
+		<string>/Applications/Firefox.app</string>
+		<string>/Applications/Google Chrome.app</string>
+		<string>/Applications/Opera.app</string>
+		<string>/Applications/Safari.app</string>
+	</array>
+	<key>keyword</key>
+	<string>browse</string>
+	<key>subtitle</key>
+	<string>Launches all web browsers.</string>
+	<key>title</key>
+	<string>Launch Browsers</string>
+</dict>
+</plist>

data/lib/pennyworth/templates/alfred/extensions/files/launch_browsers/kudos.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>creator</key>
+	<string>Brooke Kuhlmann</string>
+	<key>website</key>
+	<string>http://www.redalchemist.com</string>
+</dict>
+</plist>

data/lib/pennyworth/templates/alfred/extensions/scripts/apple_say/info.plist

@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>action</key>
+	<false/>
+	<key>category</key>
+	<string>SCRIPTS</string>
+	<key>command</key>
+	<string>say {query}</string>
+	<key>disabled</key>
+	<false/>
+	<key>escapequery</key>
+	<false/>
+	<key>escapequerybackquotes</key>
+	<false/>
+	<key>escapequerybrackets</key>
+	<false/>
+	<key>escapequeryquotes</key>
+	<true/>
+	<key>escapequerysemicolons</key>
+	<false/>
+	<key>growloutput</key>
+	<false/>
+	<key>growloutputsticky</key>
+	<false/>
+	<key>keyword</key>
+	<string>say</string>
+	<key>logging</key>
+	<false/>
+	<key>parameter</key>
+	<integer>0</integer>
+	<key>silent</key>
+	<true/>
+	<key>subtitle</key>
+	<string>Say text using Apple's text-to-speach program.</string>
+	<key>title</key>
+	<string>Apple Say</string>
+</dict>
+</plist>

data/lib/pennyworth/templates/alfred/extensions/scripts/apple_say/kudos.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>creator</key>
+	<string>Brooke Kuhlmann</string>
+	<key>website</key>
+	<string>http://www.redalchemist.com</string>
+</dict>
+</plist>

data/lib/pennyworth/templates/alfred/extensions/scripts/directory_size/info.plist

@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>action</key>
+	<false/>
+	<key>category</key>
+	<string>SCRIPTS</string>
+	<key>command</key>
+	<string>du -sm {query}/* | sort -nr
+</string>
+	<key>escapequery</key>
+	<true/>
+	<key>escapequerybackquotes</key>
+	<true/>
+	<key>escapequerybrackets</key>
+	<true/>
+	<key>escapequeryquotes</key>
+	<true/>
+	<key>escapequerysemicolons</key>
+	<true/>
+	<key>growloutput</key>
+	<true/>
+	<key>growloutputsticky</key>
+	<false/>
+	<key>keyword</key>
+	<string>dsize</string>
+	<key>logging</key>
+	<false/>
+	<key>silent</key>
+	<true/>
+	<key>subtitle</key>
+	<string>Displays directories sizes (sorted by size).</string>
+	<key>title</key>
+	<string>Directory Size</string>
+</dict>
+</plist>

data/lib/pennyworth/templates/alfred/extensions/scripts/directory_size/kudos.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>creator</key>
+	<string>Brooke Kuhlmann</string>
+	<key>website</key>
+	<string>http://www.redalchemist.com</string>
+</dict>
+</plist>

data/lib/pennyworth/templates/alfred/extensions/scripts/edit_bash_file/info.plist

@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>action</key>
+	<false/>
+	<key>category</key>
+	<string>SCRIPTS</string>
+	<key>command</key>
+	<string>mate ~/.bashrc</string>
+	<key>disabled</key>
+	<false/>
+	<key>escapequery</key>
+	<true/>
+	<key>escapequerybackquotes</key>
+	<true/>
+	<key>escapequerybrackets</key>
+	<true/>
+	<key>escapequeryquotes</key>
+	<true/>
+	<key>escapequerysemicolons</key>
+	<true/>
+	<key>growloutput</key>
+	<false/>
+	<key>growloutputsticky</key>
+	<false/>
+	<key>keyword</key>
+	<string>ebash</string>
+	<key>logging</key>
+	<false/>
+	<key>parameter</key>
+	<integer>0</integer>
+	<key>silent</key>
+	<true/>
+	<key>subtitle</key>
+	<string>Edit Bash file in TextMate.</string>
+	<key>title</key>
+	<string>Edit Bash File</string>
+</dict>
+</plist>

data/lib/pennyworth/templates/alfred/extensions/scripts/edit_bash_file/kudos.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>creator</key>
+	<string>Brooke Kuhlmann</string>
+	<key>website</key>
+	<string>http://www.redalchemist.com</string>
+</dict>
+</plist>

data/lib/pennyworth/templates/alfred/extensions/scripts/edit_dotfile/info.plist

@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>action</key>
+	<false/>
+	<key>category</key>
+	<string>SCRIPTS</string>
+	<key>command</key>
+	<string>mate ~/.{query}</string>
+	<key>disabled</key>
+	<false/>
+	<key>escapequery</key>
+	<true/>
+	<key>escapequerybackquotes</key>
+	<true/>
+	<key>escapequerybrackets</key>
+	<true/>
+	<key>escapequeryquotes</key>
+	<true/>
+	<key>escapequerysemicolons</key>
+	<true/>
+	<key>growloutput</key>
+	<false/>
+	<key>growloutputsticky</key>
+	<false/>
+	<key>keyword</key>
+	<string>edot</string>
+	<key>logging</key>
+	<false/>
+	<key>parameter</key>
+	<integer>0</integer>
+	<key>silent</key>
+	<true/>
+	<key>subtitle</key>
+	<string>Edit a Dotfile in TextMate.</string>
+	<key>title</key>
+	<string>Edit Dotfile</string>
+</dict>
+</plist>

data/lib/pennyworth/templates/alfred/extensions/scripts/edit_dotfile/kudos.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>creator</key>
+	<string>Brooke Kuhlmann</string>
+	<key>website</key>
+	<string>http://www.redalchemist.com</string>
+</dict>
+</plist>

data/lib/pennyworth/templates/alfred/extensions/scripts/edit_file/info.plist

@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>action</key>
+	<false/>
+	<key>category</key>
+	<string>SCRIPTS</string>
+	<key>command</key>
+	<string>mate {query}</string>
+	<key>disabled</key>
+	<false/>
+	<key>escapequery</key>
+	<true/>
+	<key>escapequerybackquotes</key>
+	<true/>
+	<key>escapequerybrackets</key>
+	<true/>
+	<key>escapequeryquotes</key>
+	<true/>
+	<key>escapequerysemicolons</key>
+	<true/>
+	<key>growloutput</key>
+	<false/>
+	<key>growloutputsticky</key>
+	<false/>
+	<key>keyword</key>
+	<string>e</string>
+	<key>logging</key>
+	<false/>
+	<key>parameter</key>
+	<integer>0</integer>
+	<key>silent</key>
+	<true/>
+	<key>subtitle</key>
+	<string>Edit a file in TextMate</string>
+	<key>title</key>
+	<string>Edit File</string>
+</dict>
+</plist>

data/lib/pennyworth/templates/alfred/extensions/scripts/edit_file/kudos.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>creator</key>
+	<string>Brooke Kuhlmann</string>
+	<key>website</key>
+	<string>http://www.redalchemist.com</string>
+</dict>
+</plist>

data/lib/pennyworth/templates/alfred/extensions/scripts/mac_serial/info.plist

@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>action</key>
+	<false/>
+	<key>category</key>
+	<string>SCRIPTS</string>
+	<key>command</key>
+	<string>ioreg -l | grep IOPlatformSerialNumber</string>
+	<key>escapequery</key>
+	<true/>
+	<key>escapequerybackquotes</key>
+	<true/>
+	<key>escapequerybrackets</key>
+	<true/>
+	<key>escapequeryquotes</key>
+	<true/>
+	<key>escapequerysemicolons</key>
+	<true/>
+	<key>growloutput</key>
+	<true/>
+	<key>growloutputsticky</key>
+	<false/>
+	<key>keyword</key>
+	<string>serial</string>
+	<key>logging</key>
+	<false/>
+	<key>silent</key>
+	<true/>
+	<key>subtitle</key>
+	<string>Displays the Mac serial number</string>
+	<key>title</key>
+	<string>Mac Serial</string>
+</dict>
+</plist>

data/lib/pennyworth/templates/alfred/extensions/scripts/mac_serial/kudos.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>creator</key>
+	<string>Brooke Kuhlmann</string>
+	<key>website</key>
+	<string>http://www.redalchemist.com</string>
+</dict>
+</plist>

data/lib/pennyworth/templates/alfred/extensions/scripts/mem_purge/info.plist

@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>action</key>
+	<false/>
+	<key>category</key>
+	<string>SCRIPTS</string>
+	<key>command</key>
+	<string>purge
+echo "Memory Purged"</string>
+	<key>disabled</key>
+	<false/>
+	<key>escapequery</key>
+	<true/>
+	<key>escapequerybackquotes</key>
+	<true/>
+	<key>escapequerybrackets</key>
+	<true/>
+	<key>escapequeryquotes</key>
+	<true/>
+	<key>escapequerysemicolons</key>
+	<true/>
+	<key>growloutput</key>
+	<true/>
+	<key>growloutputsticky</key>
+	<false/>
+	<key>keyword</key>
+	<string>memp</string>
+	<key>logging</key>
+	<false/>
+	<key>parameter</key>
+	<integer>0</integer>
+	<key>silent</key>
+	<true/>
+	<key>subtitle</key>
+	<string>Cleans up inactive memory, turning it into free memory.</string>
+	<key>title</key>
+	<string>Memory Purge</string>
+</dict>
+</plist>

data/lib/pennyworth/templates/alfred/extensions/scripts/mem_purge/kudos.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>creator</key>
+	<string>Brooke Kuhlmann</string>
+	<key>website</key>
+	<string>http://www.redalchemist.com</string>
+</dict>
+</plist>