maid 0.1.0 → 0.1.1

data/.gitignore

@@ -1,19 +1,4 @@
-## MAC OS
-.DS_Store
-
-## TEXTMATE
-*.tmproj
-tmtags
-
-## EMACS
-*~
-\#*
-.\#*
-
-## VIM
-*.swp
-
-## PROJECT
-doc/*
 *.gem
 .bundle
+.roboconf.sh
+doc/*

data/.rvmrc

@@ -0,0 +1 @@
+rvm use 1.8.7@maid --create

data/CONTRIBUTING.rdoc

@@ -9,6 +9,7 @@ To make things easier on you, I've compiled some Notes and Guidelines.
 * This is a Ruby Gem, built using Bundler.  For a walkthrough of how that works, see http://railscasts.com/episodes/245-new-gem-with-bundler.
 * `rake install` builds and installs the gem, but you'll probably need to do `sudo rake install`.  This lets you test the `maid` command.
 * Keep in mind that the gemspec only looks at files in the VCS (git).
+* Developing using Ruby 1.9.2?  Use "irb -I lib -r maid" to have access to Maid in irb.
 
 == Guidelines
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    maid (0.1.0)
+    maid (0.1.1)
       thor (~> 0.14.6)
 
 GEM

data/{README.rdoc → README.md}

@@ -1,4 +1,6 @@
-= Maid
+# Maid
+
+[![Flattr this git repo](http://api.flattr.com/button/flattr-badge-large.png)](https://flattr.com/submit/auto?user_id=benjaminoakes&url=https://github.com/benjaminoakes/maid&title=maid&language=en_GB&tags=github&category=software)
 
 Be lazy!  Let Maid clean up after you, based on rules you define.
 
@@ -6,48 +8,69 @@ Maid keeps files from sitting around too long, untouched.  Many of the downloads
 
 Think of it like the email filters you might already have, but for files.  Worried about things happening that you don't expect?  Maid doesn't overwrite files and actions are logged so you can tell what happened.
 
-Maid is inspired by the Mac OS X shareware program Hazel[http://www.noodlesoft.com/hazel.php].  This tool was created on Mac OS X 10.6, but should be generally portable to other systems.  (Some of the more advanced features such as <tt>downloaded_from</tt> require OS X, however.)
+Maid is inspired by the Mac OS X shareware program [Hazel](http://www.noodlesoft.com/hazel.php).  This tool was created on Mac OS X 10.6, but should be generally portable to other systems.  (Some of the more advanced features such as `downloaded_from` require OS X, however.)
 
 Your rules are defined in Ruby, so easy rules are easy and difficult rules are possible.
 
-http://travis-ci.org/benjaminoakes/maid.png ({More info}[http://travis-ci.org/benjaminoakes/maid])
+![Still Maintained?](http://stillmaintained.com/benjaminoakes/maid.png)
+[![Build Status](http://travis-ci.org/benjaminoakes/maid.png)](http://travis-ci.org/benjaminoakes/maid)
+
+## Buzz
+
+* [OneThingWell: Maid](http://onethingwell.org/post/30455088809/maid) (August 29th, 2012)
+
+## Is it any good?
+
+Yes.
+
+## Installation
 
-== Installation
+Maid supports OS X and Ubuntu.  Other Unix-like operating systems may work, but are not officially supported.  (Contributions are welcome, however.)
 
-Maid is currently in beta, but I encourage you to give it a try.  I'm using it on several computers daily.
+### OS X
 
-If you have RubyGems installed (default on Mac OS X and many Ruby installations):
+Open a terminal and run:
 
-    gem install maid --pre
+    gem install maid
 
 If you want to install the executable for all users, you may need to give root access:
 
-    sudo gem install maid --pre
+    sudo gem install maid
 
-=== Ubuntu, et al.
+### Ubuntu
 
-As you might expect, you need Ruby and RubyGems installed to do the above.
+**Want easier installation?** Please make your voice heard in [issue #3](https://github.com/benjaminoakes/maid/issues/3).
+
+You'll need Ruby and RubyGems installed.  Open a terminal and run:
 
     sudo apt-get install ruby
     sudo apt-get install rubygems
 
-You might also need to add the RubyGems <tt>bin</tt> directory to your <tt>$PATH</tt>.  For example, on Ubuntu you might need to add something like this to your <tt>~/.bashrc</tt>:
+You might also need to add the RubyGems `bin` directory to your `$PATH`.  For example, you might need to add something like this to your `~/.bashrc`:
 
     export PATH="/var/lib/gems/1.8/bin:$PATH"
+    
+Then install Maid itself:
+    
+    gem install maid
+
+If you want to install the executable for all users, you may need to give root access:
 
-== Tutorial
+    sudo gem install maid
+
+## Tutorial
 
 Maid rules are defined using Ruby, with some common operations made easier with a small DSL (Domain Specific Language).  Here's a sample:
 
-  Maid.rules do
-    rule 'Old files downloaded while developing/testing' do
-      dir('~/Downloads/*').each do |path|
-        if downloaded_from(path).any? {|u| u.match 'http://localhost'} && 1.week.since?(last_accessed(path))
-          trash(path)
+    Maid.rules do
+      rule 'Old files downloaded while developing/testing' do
+        dir('~/Downloads/*').each do |path|
+          if downloaded_from(path).any? {|u| u.match 'http://localhost'} && 1.week.since?(last_accessed(path))
+            trash(path)
+          end
         end
       end
     end
-  end
 
 Before you start running your rules, you'll likely want to be able to test them.  Here's how:
 
@@ -56,12 +79,12 @@ Before you start running your rules, you'll likely want to be able to test them.
     maid --noop
     maid -n
 
-To run your rules on demand, you can run <tt>maid</tt> manually:
+To run your rules on demand, you can run `maid` manually:
 
     maid                    # Run the rules at ~/.maid/rules.rb, logging to ~/.maid/maid.log
     maid -r some_rules.rb   # Run the rules in the file 'some_rules.rb', logging to ~/.maid/maid.log
 
-So, for example, if this is <tt>some_rules.rb</tt>:
+So, for example, if this is `some_rules.rb`:
 
     Maid.rules do
       rule 'downloaded PDF books' do
@@ -79,31 +102,31 @@ This is the command to test, as well as some sample output:
     mv "/Users/ben/Downloads/issue12.pdf" "/Users/ben/Books/"
     mv "/Users/ben/Downloads/spring2011newsletter.pdf" "/Users/ben/Books/"
 
-For more DSL helper methods, please see the documentation of Maid::Tools.
+For more DSL helper methods, please see the documentation of [Maid::Tools](http://rubydoc.info/gems/maid/0.1.0/Maid/Tools).
 
-=== Automation
+### Automation
 
 Once you get a hang for what you can do with Maid, let it do its stuff automatically throughout the day.  You'll find your computer stays a little tidier with as you teach it how to handle your common files.
 
-To do this, edit your crontab in your tool of choice and have it invoke the <tt>maid</tt> command.  The <tt>--silent</tt> option is provided to keep this from emailing you, if desired.  A log of the actions taken is kept at <tt>~/.maid/maid.log</tt>.
+To do this, edit your crontab in your tool of choice and have it invoke the `maid` command.  The `--silent` option is provided to keep this from emailing you, if desired.  A log of the actions taken is kept at `~/.maid/maid.log`.
 
 Example for every day at 1am:
 
     # minute hour day_of_month month day_of_week command_to_execute
     0 1 * * * /bin/bash -li -c "maid --silent"
 
-Both Mac OS X and Linux support callbacks when folders are changed, and that may be a forthcoming feature in Maid.  That said, I find cron to take care of most of my needs.
+Both Mac OS X and Linux support callbacks when folders are changed, and that may be a forthcoming feature in Maid.  That said, I find `cron` to take care of most of my needs.
 
-== Sample
+## Sample
 
 For a sample rules file, run:
 
     maid sample
 
-== Warranty
+## Warranty
 
 THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
 
-== License
+## License
 
 GPLv2.  See LICENSE for a copy.

data/TODO.rdoc

@@ -4,6 +4,18 @@
 
 Some of these might not happen, but they're being thought about.  Feel free to add your own.
 
+* "Push to S3" method (for backing up, etc)
+* Classifiers and file-content based rules.  Example:
+  * Take bills and bank statements, classify them as the type of document they are, and then rename them based on their content:
+    * ["eStatement.pdf", "eStatement (1).pdf", "eStatement (2).pdf", "statement-1c3f34d.pdf", "statement-2c53ad1.pdf", "document-34d1c3f.pdf", "document-3ad12c5.pdf"] => ['ING', 'ING', 'ING', 'Citi', 'Citi', 'UI', 'UI']
+    * For example, ING statements have a date found with the pattern /Your Savings Summary as of\s+(.*?)$/i, Citi statements have the pattern /Statement Closing Date.*?(\d\d\/\d\d\/\d\d\d\d)/im, etc.  Map using the patterns and rules.
+
+    # (Define classification rules in some format here, naming one 'bank_statements' with the extraction rule 'date')
+
+    dir('~/Downloads/*.pdf').classify(as: 'bank_statements', extract: 'date').each do |original_path, classification, date|
+      move(original_path, "~/Bills/#{classification}/#{date.strftime(...)}.pdf")
+    end
+
 * Daemon mode
 * Menubar/system tray icon
 * Import of rules from other programs

data/configure

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+set -o errexit
+
+curl -so .roboconf.sh https://raw.github.com/benjaminoakes/roboconf/master/roboconf.sh
+source .roboconf.sh
+
+roboconf-bundler '~> 1.0.0'

data/lib/maid/rules.sample.rb

@@ -8,11 +8,12 @@
 #
 #   * Run `maid help`
 #   * Read the README at http://github.com/benjaminoakes/maid
-#   * For more DSL helper methods, please see the documentation of Maid::Tools.
+#   * For more DSL helper methods, please see the documentation of Maid::Tools at http://rubydoc.info/gems/maid/0.1.0/Maid/Tools
 #   * Come up with some cool tools of your own?  Fork, make your changes, and send me a pull request on GitHub!
-#   * Ask me a question over email (hello@benjaminoakes.com) or twitter (@benjaminoakes)
+#   * Ask me a question over email (hello@benjaminoakes.com) or Twitter (@benjaminoakes)
 #
 Maid.rules do
+  # NOTE: Currently, only Mac OS X supports `duration_s`.
   rule 'MP3s likely to be music' do
     dir('~/Downloads/*.mp3').each do |path|
       if duration_s(path) > 30.0
@@ -20,7 +21,8 @@ Maid.rules do
       end
     end
   end
-
+  
+  # NOTE: Currently, only Mac OS X supports `downloaded_from`.
   rule 'Old files downloaded while developing/testing' do
     dir('~/Downloads/*').each do |path|
       if downloaded_from(path).any? {|u| u.match 'http://localhost' || u.match('http://staging.yourcompany.com') } && 1.week.since?(last_accessed(path))

data/lib/maid/tools.rb

@@ -114,6 +114,8 @@ module Maid::Tools
 
   # Pulls and pushes the given git repository.
   #
+  # You might also be interested in SparkleShare (http://sparkleshare.org/), a great git-based file syncronization project.
+  #
   #   git_piston('~/code/projectname')
   def git_piston(path)
     full_path = File.expand_path(path)

data/lib/maid/version.rb

@@ -1,3 +1,3 @@
 module Maid
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: maid
 version: !ruby/object:Gem::Version 
-  hash: 27
+  hash: 25
   prerelease: 
   segments: 
   - 0
   - 1
-  - 0
-  version: 0.1.0
+  - 1
+  version: 0.1.1
 platform: ruby
 authors: 
 - Benjamin Oakes
@@ -15,12 +15,12 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-06-24 00:00:00 Z
+date: 2012-08-31 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
-  name: thor
   prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  name: thor
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
@@ -31,12 +31,12 @@ dependencies:
         - 14
         - 6
         version: 0.14.6
+  requirement: *id001
   type: :runtime
-  version_requirements: *id001
 - !ruby/object:Gem::Dependency 
-  name: rake
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  name: rake
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
@@ -47,12 +47,12 @@ dependencies:
         - 8
         - 7
         version: 0.8.7
+  requirement: *id002
   type: :development
-  version_requirements: *id002
 - !ruby/object:Gem::Dependency 
-  name: rspec
   prerelease: false
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  name: rspec
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
@@ -63,12 +63,12 @@ dependencies:
         - 5
         - 0
         version: 2.5.0
+  requirement: *id003
   type: :development
-  version_requirements: *id003
 - !ruby/object:Gem::Dependency 
-  name: timecop
   prerelease: false
-  requirement: &id004 !ruby/object:Gem::Requirement 
+  name: timecop
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
@@ -79,12 +79,12 @@ dependencies:
         - 3
         - 5
         version: 0.3.5
+  requirement: *id004
   type: :development
-  version_requirements: *id004
 - !ruby/object:Gem::Dependency 
-  name: ZenTest
   prerelease: false
-  requirement: &id005 !ruby/object:Gem::Requirement 
+  name: ZenTest
+  version_requirements: &id005 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
@@ -95,8 +95,8 @@ dependencies:
         - 4
         - 2
         version: 4.4.2
+  requirement: *id005
   type: :development
-  version_requirements: *id005
 description: Be lazy.  Let Maid clean up after you, based on rules you define.
 email: 
 - hello@benjaminoakes.com
@@ -109,16 +109,18 @@ extra_rdoc_files: []
 files: 
 - .gitignore
 - .rspec
+- .rvmrc
 - .travis.yml
 - CONTRIBUTING.rdoc
 - Gemfile
 - Gemfile.lock
 - LICENSE
 - Maidfile
-- README.rdoc
+- README.md
 - Rakefile
 - TODO.rdoc
 - bin/maid
+- configure
 - lib/maid.rb
 - lib/maid/app.rb
 - lib/maid/maid.rb
@@ -165,15 +167,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: maid
-rubygems_version: 1.7.2
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: Be lazy.  Let Maid clean up after you, based on rules you define.
-test_files: 
-- spec/lib/maid/app_spec.rb
-- spec/lib/maid/maid_spec.rb
-- spec/lib/maid/numeric_extensions_spec.rb
-- spec/lib/maid/rule_spec.rb
-- spec/lib/maid/tools_spec.rb
-- spec/lib/maid_spec.rb
-- spec/spec_helper.rb
+test_files: []
+