easy_find 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 34706a5eae21c71599a96aeaa255b0a4786ef62f
+  data.tar.gz: 296fdd954886859914373ea8239e683f9591e5ef
+SHA512:
+  metadata.gz: 66d1def379718a2a36c225b73d9c6c06cd7625a9092bab4ebb14c702d177e53e976b285bb9a75dfbf5f7a4265d1881728922ac1fba90ecbd7756f5dfcdfc674e
+  data.tar.gz: 408b52bcf13b16e6f5f42f08265a4d952556f84cc90e417d1478c3715f0c0dcb89bf64d3349a56b2da60fc7875c3a1bb121863ac94d3675b009bd31ecd030592

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Yi Wei
+
+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.md

@@ -0,0 +1,53 @@
+EasyFind
+=============
+
+EasyFind is a thin wrapper of \*nix find command.
+It enables users to specify find command line. The syntax of
+EasyFind is quite simple, and you may easily replace current syntax
+with your perferred syntax.
+
+Specify find command in STDIN string
+_________________
+
+Run *easy_find*, and you may specify intended find command in the STDIN string as follows:
+```ruby
+EasyFind::Finder.find do
+  in_folder { [".", "~", "/usr/bin"] }
+  where do
+    type "f"
+    size :greater_than, 1000
+    grouping do
+      atime :greater_than, 7
+      or_else
+      mtime :less_than, 10
+    end
+  end
+  with_actions { print }
+end
+
+```
+The script will print generated find command line in the last line.
+
+Specify find command in a .rb file
+_____________________
+
+You may save the above contents in a .rb file, say demo.rb.
+Then run "*easy_find* demo.rb", and copy&paste generated printed find command line.
+
+API calls
+_____________________
+
+```ruby
+require 'easy_find'
+
+find_command = EasyFind::Finder.find do
+  in_folder { "/usr/bin" }
+  where do
+    ...
+  end
+  with_actions do
+    ...
+  end
+end
+```
+

data/Rakefile

@@ -0,0 +1,30 @@
+require "bundler"
+Bundler.setup
+
+require "rake"
+require "rspec/core/rake_task"
+
+$LOAD_PATH.unshift File.expand_path("../lib", __FILE__)
+require "easy_find/version"
+
+task :gem => :build
+task :build do
+  system "gem build easy_find.gemspec"
+end
+
+task :install => :build do
+  system "sudo gem install easy_find-#{EasyFind::VERSION}.gem"
+end
+
+task :release => :build do
+  system "git tag -a v#{EasyFind::VERSION} -m 'Tagging #{EasyFind::VERSION}'"
+  system "git push --tags"
+  system "gem push EasyFind-#{EasyFind::VERSION}.gem"
+  system "rm EasyFind-#{EasyFind::VERSION}.gem"
+end
+
+RSpec::Core::RakeTask.new("spec") do |spec|
+  spec.pattern = "spec/**/*_spec.rb"
+end
+
+task :default => :spec

data/bin/easy_find

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+require 'easy_find'
+
+if ARGV.length == 0
+  str = ''
+  while $stdin.gets
+    str << $_
+  end
+  puts eval str
+elsif ARGV.length == 1
+  contents = open(ARGV[0]).read
+  puts eval contents
+else
+  puts "Wrong number of arguments"
+end
+

data/lib/easy_find/default_command_maker.rb

@@ -0,0 +1,141 @@
+module EasyFind
+  class DefaultCommandMaker
+    SEPARATOR = ' '
+
+    def initialize
+      @folder_clause = ''
+      @where_clause = ''
+      @action_clause = ''
+    end
+
+    def make_folder_name(&block)
+      folder = block.call
+      if folder.is_a?(Array)
+        @folder_clause = SEPARATOR + folder.join(" ")
+      else
+        @folder_clause = folder.nil? ? "" : (SEPARATOR + folder)
+      end
+    end
+
+    def make_where_str(&block)
+      instance_eval &block
+      @where_clause
+    end
+
+    def make_actions_str(&block)
+      instance_eval &block
+      @action_clause
+    end
+
+    private
+
+      def name(n)
+        build_quoted_where_segment("-name", n)
+      end
+
+      def size(*xs)
+        build_modified_action_str("-size", *xs)
+      end
+    
+      def atime(*xs)
+        build_modified_action_str("-atime", *xs)
+      end
+
+      def mtime(*xs)
+        build_modified_action_str("-mtime", *xs)
+      end
+        
+        def build_modified_action_str(action_str, *xs)
+          modified_param = modify(xs)
+          build_unquoted_where_segment(action_str, modified_param)
+        end
+
+          def modify(xs)
+            if xs.length == 1
+              xs[0]
+            elsif xs.length == 2
+              prefix_with_sign_symbol(xs)
+            end
+          end
+
+            def prefix_with_sign_symbol(xs)
+              if xs[0] == :greater_than
+                "+#{xs[1]}"
+              elsif xs[0] == :less_than
+                "-#{xs[1]}"
+              end
+            end
+ 
+      def type(n)
+        build_quoted_where_segment("-type", n)
+      end
+
+      def fstype(n)
+        build_quoted_where_segment("-fstype", n)
+      end
+
+      def user(n)
+        build_quoted_where_segment("-user", n)
+      end
+
+      def group(n)
+        build_quoted_where_segment("-group", n)
+      end
+
+      def perm(n)
+        build_unquoted_where_segment("-perm", n)
+      end
+
+        def build_quoted_where_segment(criteria, value)
+          quoted = '"' + value.to_s + '"'
+          build_where_segment(criteria, quoted)
+        end
+        
+        def build_unquoted_where_segment(criteria, value)
+          build_where_segment(criteria, value)
+        end
+
+        def build_where_segment(criteria, value)
+          @where_clause += SEPARATOR + criteria + SEPARATOR + value.to_s
+        end
+
+      def grouping(&block)
+        in_group_statement = instance_eval &block
+        str = in_group_statement.nil? ? '' : in_group_statement
+        @where_clause = SEPARATOR + "\\(" + @where_clause + SEPARATOR + "\\)"
+      end
+
+      def or_else
+        @where_clause += SEPARATOR + "-o"
+      end
+
+      def print
+        build_action_str "-print"
+      end
+
+      def exec(cmd)
+        build_action_str "-exec #{cmd} \\;"
+      end
+
+      def ok(cmd)
+        build_action_str "-ok #{cmd} \\;"
+      end
+
+      def mount
+        build_action_str "-mount"
+      end
+
+      def xdev
+        build_action_str "-xdev"
+      end
+
+      def prune
+        build_action_str "-prune"
+      end
+      
+        def build_action_str(cmd)
+          @action_clause += SEPARATOR + cmd.to_s
+        end
+  end
+end
+

data/lib/easy_find/version.rb

@@ -0,0 +1,4 @@
+module EasyFind
+  VERSION = "0.0.1"
+end
+

data/lib/easy_find.rb

@@ -0,0 +1,42 @@
+require 'easy_find/default_command_maker'
+
+module EasyFind
+
+  class Finder
+    BASE_FIND = "find"
+    SEPARATOR = ' '
+
+    def self.find(&block)
+      self.new.find(&block)
+    end
+
+    def initialize(command_maker = DefaultCommandMaker)
+      @folder_clause = ''
+      @where_clause = ''
+      @action_clause = ''
+      @command_maker = DefaultCommandMaker.new
+    end
+
+    def find(&block)
+      command = instance_eval &block
+      if command.nil?
+        BASE_FIND
+      else
+        BASE_FIND + @folder_clause + @where_clause + @action_clause
+      end
+    end
+
+    def in_folder(&block)
+      @folder_clause += @command_maker.instance_eval { make_folder_name(&block) }
+    end
+
+    def where(&block)
+      @where_clause += @command_maker.instance_eval { make_where_str(&block) }
+    end
+
+    def with_actions(&block)
+      @action_clause += @command_maker.instance_eval { make_actions_str(&block) }
+    end
+  end
+end
+

metadata

@@ -0,0 +1,51 @@
+--- !ruby/object:Gem::Specification
+name: easy_find
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Yi Wei
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-06-17 00:00:00.000000000 Z
+dependencies: []
+description: A thin wrapper of *nix find command
+email:
+- yiwei.in.cyber@gmail.com
+executables:
+- easy_find
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/easy_find/default_command_maker.rb
+- lib/easy_find/version.rb
+- lib/easy_find.rb
+- README.md
+- LICENSE
+- Rakefile
+- bin/easy_find
+homepage: 
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.6
+signing_key: 
+specification_version: 4
+summary: A thin wrapper of *nix find command
+test_files: []