osx-trash 1.0.0

data/COPYING

@@ -0,0 +1,21 @@
+Copyright (c) 2008 Dave Dribin
+
+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,44 @@
+= Overview
+
+osx-trash is a command line program called trash[link:files/bin/trash.html]
+to manipulate the trash on Mac OS X. It uses AppleScript via Scripting Bridge
+on top of RubyCocoa to manipulate the trash, just like the Finder does. Here's
+a simple example:
+
+  % touch foo bar baz
+  % trash -l
+  % trash foo ba*
+  % trash -l
+  /Users/dave/.Trash/foo
+  /Users/dave/.Trash/bar
+  /Users/dave/.Trash/baz
+  % trash -e
+  % trash -l
+
+Using Finder's AppleScript has a number of benefits compared to shell scripts
+that just move files to ~/.Trash. First, it creates unique names when there
+are collisions:
+
+  % touch foo
+  % trash foo
+  % touch foo
+  % trash foo
+  % trash -l
+  /Users/dave/.Trash/foo
+  /Users/dave/.Trash/foo 20-38-20
+
+It also handles trashes on different volumes properly:
+
+  % touch foo
+  % trash foo
+  % touch /Volumes/DiskImage/bar
+  % trash /Volumes/DiskImage/bar
+  % trash -l
+  /Users/dave/.Trash/foo
+  /Volumes/DiskImage/.Trashes/501/bar
+
+= Links
+
+* Project page: http://www.dribin.org/dave/osx-trash/
+* RubyForge project: http://rubyforge.org/projects/osx-trash/
+* Online documentation: http://osx-trash.rubyforge.org/api/

data/Rakefile

@@ -0,0 +1,60 @@
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/gempackagetask'
+
+$LOAD_PATH.unshift 'lib'
+require 'osxtrash/version'
+
+$KCODE = "UTF-8"
+
+task :default => [:test_units]
+
+desc "Run basic tests"
+Rake::TestTask.new("test_units") do |t|
+  t.pattern = 'test/*_test.rb'
+  t.verbose = false
+  t.warning = true
+end
+
+PKG_NAME = 'osx-trash'
+PKG_VERSION = OSXTrash::VERSION
+PKG_FILES = FileList[
+  '[A-Z]*', 
+  'bin/**/*',
+  'lib/**/*.rb',
+]
+
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = "#{PKG_NAME} -- Mac OS X Trash Manipulation"
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('bin/*')
+end
+
+spec = Gem::Specification.new do |s|
+  s.platform = Gem::Platform::RUBY
+  s.summary = "Mac OS X Trash Manipulation"
+  s.name = PKG_NAME
+  s.version = PKG_VERSION
+  s.requirements << 'Mac OS X 10.5'
+  s.requirements << 'RubyCocoa'
+  s.require_path = 'lib'
+  s.files = PKG_FILES
+  s.has_rdoc = true
+  s.bindir = 'bin'
+  s.executables = ['trash']
+  s.description = <<-EOF
+  Manipulate the Mac OS X Finder's Trash using Scripting Bridge and RubyCocoa.
+  EOF
+  
+  s.author = "Dave Dribin"
+  s.homepage = "http://www.dribin.org/dave/osx-trash/"
+  s.rubyforge_project = 'osx-trash'
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.need_zip = true
+  pkg.need_tar = true
+end

data/bin/trash

@@ -0,0 +1,147 @@
+#!/usr/bin/ruby
+
+# == Synopsis
+#
+# Manipulate the Mac OS X trash
+#
+# == Usage
+#
+#   trash [OPTIONS] <file> [<file> ...]
+#   trash [OPTIONS] [-e | --empty]
+#   trash [OPTIONS] [-l | --list]
+#
+# == Options
+#  
+# -e, --empty:: Empty the trash.
+#
+# -l, --list:: List items in the trash.
+#
+# -h, --help:: Prints a help message and exits.
+#
+# -v, --version:: Prints the version and exits.
+#
+# == Author
+# Dave Dribin
+#
+# == Copyright
+# Copyright (c)  2008 Dave Dribin
+# Licensed under the MIT license.
+
+require 'pathname'
+require 'optparse'
+require 'ostruct'
+require 'osxtrash/version'
+
+require 'osx/cocoa'
+include OSX
+OSX.require_framework 'ScriptingBridge'
+
+class OSXTrashApp
+  COMMAND = File.basename($0)
+  USAGE =<<EOF
+Usage: #{COMMAND} [OPTIONS] <file> [<file> ...]
+       #{COMMAND} [-e | --empty]
+       #{COMMAND} [-l | --list]
+EOF
+
+  def initialize
+    @options = OpenStruct.new
+    @options.empty = false
+    @options.list = false
+  end
+  
+  def create_finder
+    stderr = $stderr.clone           # save current STDERR IO instance
+    $stderr.reopen('/dev/null', 'w') # send STDERR to /dev/null
+    finder = SBApplication.applicationWithBundleIdentifier("com.apple.Finder")
+    $stderr.reopen(stderr)           # revert to default behavior
+    return finder
+  end
+
+  def run(argv)
+    exit_code = 0
+    begin
+      if parse_options(argv)
+        exit_code = main(argv)
+      end
+    rescue
+      STDERR.puts "#{COMMAND}: " + $!
+      exit_code = 1
+    end
+    return exit_code
+  end
+  
+  def parse_options(argv)
+    opts = OptionParser.new do |opts|
+      opts.banner = USAGE
+      opts.separator ""
+      opts.separator "Specific options:"
+
+      opts.on("-e", "--empty", "Empty the trash") do
+        @options.empty = true
+      end
+
+      opts.on("-l", "--list", "List items in the trash") do
+        @options.list = true
+      end
+
+      opts.on_tail("-h", "--help", "Show this message") do
+        puts opts
+        puts
+        puts "Manipulate to the Finder's trash."
+        return false
+      end
+
+      opts.on_tail("-v", "--version", "Show version") do
+        puts "#{COMMAND} #{OSXTrash::VERSION}"
+        return false  
+      end
+    end
+    
+    opts.parse!(argv)
+    return true
+  end
+
+  def main(argv)
+    if (@options.empty)
+      finder = create_finder
+      trash = finder.trash
+      trash.warnsBeforeEmptying = false
+      trash.emptySecurity(false)
+      return 0
+    end
+
+    if (@options.list)
+      finder = create_finder
+      trash = finder.trash
+      trash.items.each do |item|
+        file_url = NSURL.URLWithString(item.URL)
+        Pathname item_path = Pathname.new(file_url.path)
+        puts item_path
+      end
+      return 0
+    end
+
+    files = ARGV
+    if (files.length == 0)
+      $stderr.puts USAGE
+      $stderr.puts "Try `#{COMMAND} --help' for more information."
+      return 1
+    end
+
+    finder = create_finder
+    files.each do |file|
+      path = Pathname.new(file)
+      url = NSURL.fileURLWithPath(path.realpath.to_s)
+      item = finder.items.objectAtLocation(url)
+      item.delete
+    end
+    return 0
+  end
+end
+
+app = OSXTrashApp.new
+rc = app.run(ARGV)
+exit rc
+
+

data/lib/osxtrash/version.rb

@@ -0,0 +1,3 @@
+module OSXTrash
+  VERSION = "1.0.0"
+end

metadata

@@ -0,0 +1,58 @@
+--- !ruby/object:Gem::Specification 
+name: osx-trash
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Dave Dribin
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-05-24 00:00:00 -05:00
+default_executable: 
+dependencies: []
+
+description: Manipulate the Mac OS X Finder's Trash using Scripting Bridge and RubyCocoa.
+email: 
+executables: 
+- trash
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- COPYING
+- Rakefile
+- README
+- bin/trash
+- lib/osxtrash/version.rb
+has_rdoc: true
+homepage: http://www.dribin.org/dave/osx-trash/
+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: 
+- Mac OS X 10.5
+- RubyCocoa
+rubyforge_project: osx-trash
+rubygems_version: 1.0.1
+signing_key: 
+specification_version: 2
+summary: Mac OS X Trash Manipulation
+test_files: []
+