kaboom 0.3.1

data/CHANGELOG.markdown

@@ -0,0 +1,107 @@
+# boom changes
+## head
+- [@Dlom](https://github.com/Dlom) fixed some troubles in #49.
+- Some additional test coverage added by
+  [@nickhammond](https://github.com/nickhammond).
+
+## 0.2.3
+- [@culvr](https://github.com/culvr) added `boom random <list>` that lets you
+  quickly pull a random item.
+- Fixed so that opening a specific item (`boom open urls github`) will only
+  open that item.
+- [@culvr](https://github.com/culvr) fixed STDIN list+item creation.
+- HTTParty should only be a soft dependency. (#46)
+
+## 0.2.2 (July 29, 2011)
+- [@jimmycuadra](https://github.com/jimmycuadra) went to town on this beast and
+  hooked up a Gist backend to boom. Killer.
+- Small Windows fix.
+
+## 0.2.1 (July 16, 2011)
+- boom displays colors thanks to [@dandorman](https://github.com/dandorman).
+- Windows support, brah. [@tombell](https://github.com/tombell).
+- boom accepts piped-in data (like `cat admins.txt | boom groups admins`).
+  Thanks [@brettbuddin](https://github.com/brettbuddin) and
+  [@antonlindstrom](https://github.com/antonlindstrom). Tag-team action.
+- `boom <newlist> <item> <value>` will actually create the list and item now.
+  [@jmazzi](https://github.com/jmazzi).
+
+## 0.2.0 (April 12, 2011)
+- Add Keychain storage to store Boom data securely in OS X's Keychain.app.
+  Thanks, [@davidtrogers](https://github.com/davidtrogers)!
+- Switch from yajl-ruby because [OS X isn't for
+  developers](http://zachholman.com/2011/03/osx-isnt-for-developers/). Thanks
+  for finishing it up, [@antonlindstrom](https://github.com/antonlindstrom).
+- Move dependencies to Bundler, because it's the One True Way™ at this point.
+- Some README updates.
+- `boom -v`.
+
+## 0.1.2
+- Copy to clipboard doesn't hang anymore. Sweet. Thanks,
+  [mcollina](https://github.com/mcollina).
+- Holy hell, [brettbuddin](https://github.com/brettbuddin) added completion for
+  zsh. Pretty awesome too.
+- [antonlindstrom](https://github.com/antonlindstrom) fixed up the MongoDB
+  backend.
+
+## 0.1.1
+- Don't force Redis on everyone.
+
+## 0.1.0
+- boom has been rewritten to use multiple backends. Use `boom switch <backend>`
+  to switch from the default JSON backend. Currently only Redis is supported.
+  Pull Requests are welcome.
+
+## 0.0.10
+- `boom open` will open the Item's URL in a browser, or it'll open all the URLs
+  in a List for you. Thanks [lwe](https://github.com/lwe).
+- Values for item creation can have spaces, and then they get concat'ed as one
+  value. Thanks [lwe](https://github.com/lwe).
+- Replacing an item no longer dupes the item; it'll just replace the value.
+  Thank god, finally. Thanks [thbishop](https://github.com/thbishop).
+- Also started `completion/`, a place to drop in scripts to set up completion
+  support for boom. Starting out with [thbishop](https://github.com/thbishop)'s
+  bash script, but if anyone has something for zsh I'd kiss them a bit.
+- `boom echo` (and `boom e`) just echos the value; great for command-line
+  scripts and junk! Thanks [bschaeffer](https://github.com/bschaeffer).
+
+## 0.0.9
+- Backport `Symbol#to_proc` for 1.8.6 support (thanks 
+  [kastner](https://github.com/kastner) and 
+  [DeMarko](https://github.com/DeMarko)).
+
+## 0.0.8
+- Support for Ruby 1.9 (thanks [jimmycuadra](https://github.com/jimmycuadra)).
+
+## 0.0.7
+- Reverts item creation from stdin, since it broke regular item creation.
+
+## 0.0.6
+- Searching for an item that doesn't exist doesn't murder puppies anymore
+  (thanks [jimmycuadra](https://github.com/jimmycuadra)).
+- Output is a bit cleaner with a constrained `name` column.
+- Adds items from stdin (thanks
+  [MichaelXavier](https://github.com/MichaelXavier)). 
+
+## 0.0.5
+- Item deletes are now scoped by list rather than GLOBAL DESTRUCTION! (thanks
+  [natebean](https://github.com/natebean)).
+- Command line options, like `boop --help` are translated into `boom help`. In
+  the future we play around with options a bit more.
+- Non-Mac-based platforms get clipboard support with `xclip`. If it's
+  problematic (which it almost certainly is; I'm breaking this more or less on
+  purpose), please patch it and send me a pull request for your particular
+  platform.
+
+## 0.0.4
+- Adds `boom help`. You know, for help.
+
+## 0.0.3
+- `boom edit` to edit your stuff in a friendly $EDITOR.
+- Class-level accessors in List for ActiveRecordesque actions.
+
+## 0.0.2
+- Fix for list selection (thanks [bgkittrell](https://github.com/bgkittrell)).
+
+## 0.0.1
+- BOOM!

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,24 @@
+PATH
+  remote: .
+  specs:
+    kaboom (0.3.1)
+      json_pure (~> 1.5.3)
+      multi_json (~> 1.0.3)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    json_pure (1.5.4)
+      spruz (~> 0.2.8)
+    mocha (0.9.12)
+    multi_json (1.0.4)
+    rake (0.9.2)
+    spruz (0.2.13)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  kaboom!
+  mocha (~> 0.9.9)
+  rake (~> 0.9.2)

data/LICENSE.markdown

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) Zach Holman, http://zachholman.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.markdown

@@ -0,0 +1,74 @@
+# K A B O O M
+
+## About
+
+boom manages your text snippets. On the command line. I just blew your mind.
+kaboom adds sharing snippets. On the command line.
+
+For more details about what boom is and how it works, check out
+[boom's website](http://holman.github.com/boom). For full usage details
+(including a complete list of commands), check out
+[boom's wiki](https://github.com/holman/boom/wiki).
+
+## Install
+
+    gem install kaboom
+
+## Quick and Dirty
+
+    $ boom gifs
+    Boom! Created a new list called "gifs".
+
+    $ boom gifs melissa http://cl.ly/3pAn/animated.gif
+    Boom! "melissa" in "gifs" is "http://cl.ly/3pAn/animated.gif". Got it.
+
+    $ boom melissa
+    Boom! Just copied http://cl.ly/3pAn/animated.gif to your clipboard.
+
+And that's just a taste! I know, you're salivating, I can hear you from here.
+(Why your saliva is noisy is beyond me.) Check out the [full list of
+commands](https://github.com/holman/boom/wiki/Commands).
+
+## boom remote (or kaboom)
+You can even have a remote boom using config in ~/.boom.remote.conf
+
+    $ boom remote "a sandwich" cheese "mighty fine"
+    Boom! cheese in a sandwich is mighty fine. Got it.
+
+e.g. have a shared redis instance in the office for pinging around snippets to
+each others command lines
+
+    # me:
+    $ kaboom config ackrc < ~/.ackrc
+
+    # you:
+    $ kaboom config ackrc > ~/.ackrc
+
+## Distributed sharing of snippets with boom and kaboom
+    # me:
+    $ kaboom shared_links pivotal <  boom links pivotal
+
+    $ you:
+    $ kaboom shared_links pivotal >  boom links pivotal
+
+## Contribute
+
+Want to join the [Pantheon of
+Boom'ers](https://github.com/holman/boom/contributors)? I'd love to include
+your contributions, friend.
+
+Clone this repository, then run `bundle install`. That'll install all the gem
+dependencies. Make sure your methods are [TomDoc](http://tomdoc.org)'d
+properly, that existing tests pass (`rake`), and that any new functionality
+includes appropriate tests. Bonus points if you're not updating the gemspec or
+bumping boom's version.
+
+All good? Cool! Then [send me a pull request](https://github.com/holman/boom/pull/new/master)!
+
+## I love you
+
+[Zach Holman](http://zachholman.com) made this. Ping me on Twitter —
+[@holman](http://twitter.com/holman) — if you're having issues, want me to
+merge in your pull request, or are using boom in a cool way. I'm kind of hoping
+this is generic enough that people do some fun things with it. First one to use
+`boom` to calculate their tax liability wins.

data/Rakefile

@@ -0,0 +1,150 @@
+require 'rubygems'
+require 'rake'
+require 'date'
+
+#############################################################################
+#
+# Helper functions
+#
+#############################################################################
+
+def name
+  @name ||= Dir['*.gemspec'].first.split('.').first
+end
+
+def version
+  line = File.read("lib/#{name}.rb")[/^\s*VERSION\s*=\s*.*/]
+  line.match(/.*VERSION\s*=\s*['"](.*)['"]/)[1]
+end
+
+def date
+  Date.today.to_s
+end
+
+def rubyforge_project
+  name
+end
+
+def gemspec_file
+  "#{name}.gemspec"
+end
+
+def gem_file
+  "#{name}-#{version}.gem"
+end
+
+def replace_header(head, header_name)
+  head.sub!(/(\.#{header_name}\s*= ').*'/) { "#{$1}#{send(header_name)}'"}
+end
+
+#############################################################################
+#
+# Standard tasks
+#
+#############################################################################
+
+task :default => :test
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+desc "Generate RCov test coverage and open in your browser"
+task :coverage do
+  require 'rcov'
+  sh "rm -fr coverage"
+  sh "rcov test/test_*.rb"
+  sh "open coverage/index.html"
+end
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "#{name} #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+desc "Open an irb session preloaded with this library"
+task :console do
+  sh "irb -rubygems -r ./lib/#{name}.rb"
+end
+
+#############################################################################
+#
+# Custom tasks (add your own tasks here)
+#
+#############################################################################
+
+
+
+#############################################################################
+#
+# Packaging tasks
+#
+#############################################################################
+
+desc "Create tag v#{version} and build and push #{gem_file} to Rubygems"
+task :release => :build do
+  unless `git branch` =~ /^\* master$/
+    puts "You must be on the master branch to release!"
+    exit!
+  end
+  sh "git commit --allow-empty -a -m 'Release #{version}'"
+  sh "git tag v#{version}"
+  sh "git push origin master"
+  sh "git push origin v#{version}"
+  sh "gem push pkg/#{name}-#{version}.gem"
+end
+
+desc "Build #{gem_file} into the pkg directory"
+task :build => :gemspec do
+  sh "mkdir -p pkg"
+  sh "gem build #{gemspec_file}"
+  sh "mv #{gem_file} pkg"
+end
+
+desc "Generate #{gemspec_file}"
+task :gemspec => :validate do
+  # read spec file and split out manifest section
+  spec = File.read(gemspec_file)
+  head, manifest, tail = spec.split("  # = MANIFEST =\n")
+
+  # replace name version and date
+  replace_header(head, :name)
+  replace_header(head, :version)
+  replace_header(head, :date)
+  #comment this out if your rubyforge_project has a different name
+  #replace_header(head, :rubyforge_project)
+
+  # determine file list from git ls-files
+  files = `git ls-files`.
+    split("\n").
+    sort.
+    reject { |file| file =~ /^\./ }.
+    reject { |file| file =~ /^(rdoc|pkg)/ }.
+    map { |file| "    #{file}" }.
+    join("\n")
+
+  # piece file back together and write
+  manifest = "  s.files = %w[\n#{files}\n  ]\n"
+  spec = [head, manifest, tail].join("  # = MANIFEST =\n")
+  File.open(gemspec_file, 'w') { |io| io.write(spec) }
+  puts "Updated #{gemspec_file}"
+end
+
+desc "Validate #{gemspec_file}"
+task :validate do
+  libfiles = Dir['lib/*'] - ["lib/#{name}.rb", "lib/#{name}"]
+  unless libfiles.empty?
+    puts "Directory `lib` should only contain a `#{name}.rb` file and `#{name}` dir."
+    exit!
+  end
+  unless Dir['VERSION*'].empty?
+    puts "A `VERSION` file at root level violates Gem best practices."
+    exit!
+  end
+end

data/bin/boom

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+# coding: utf-8
+
+$:.unshift File.join(File.dirname(__FILE__), *%w[.. lib])
+
+require 'boom'
+
+Boom::Command.execute(*ARGV)

data/bin/kaboom

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+# coding: utf-8
+
+$:.unshift File.join(File.dirname(__FILE__), *%w[.. lib])
+
+require 'boom'
+args = %w{remote} + ARGV
+Boom::Command.execute(*args)

data/completion/README.md

@@ -0,0 +1,7 @@
+# boom completion
+
+To add autocompletion to your shell, look in this directory and grab the script
+that matches your corresponding shell.
+
+I use the Z shell, so hey, I picked `boom.zsh`. And trust me: after a couple minutes of
+playing with it, you'll never look back. NEVER!

data/completion/boom.bash

@@ -0,0 +1,17 @@
+_boom_complete() {
+    local cur prev lists curr_list items
+    COMPREPLY=()
+    cur="${COMP_WORDS[COMP_CWORD]}"
+    prev="${COMP_WORDS[COMP_CWORD-1]}"
+    curr_list=`eval echo "$prev"`
+    local IFS=$'\n'
+
+    if [ $COMP_CWORD -eq 1 ]; then
+        lists=`boom | sed 's/^  \(.*\) ([0-9]\+)$/\1/'`
+        COMPREPLY=( $( compgen -W '${lists}' -- ${cur} ) )
+    elif [ $COMP_CWORD -eq 2 ]; then
+        items=`boom $curr_list | sed 's/^    \(.\{0,16\}\):.*$/\1/'`
+        COMPREPLY=( $( compgen -W '${items}' -- ${cur} ) )
+    fi
+}
+complete -o filenames -F _boom_complete boom

data/completion/boom.zsh

@@ -0,0 +1,29 @@
+#compdef boom
+
+local state line cmds ret=1
+
+_arguments -C '1: :->cmds' '*: :->args'
+
+case $state in
+  cmds)
+    local -a cmds
+    cmds=(
+      'all:show all items in all lists'
+      'edit:edit the boom JSON file in $EDITOR'
+      'help:help text'
+    )
+    _describe -t commands 'boom command' cmds && ret=0
+    _values 'lists' $(boom | awk '{print $1}')
+    ;;
+  args)
+    case $line[1] in
+      (boom|all|edit|help)
+        ;;
+      *)
+        _values 'items' `boom $line[1] | awk '{print $1}' | sed -e 's/://'` 2>/dev/null && ret=0
+        ;;
+    esac
+    ;;
+esac
+
+return ret