findr 0.0.4 → 0.0.7

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 264462a154498bd31f1314af9efa5dad2361ec1b
+  data.tar.gz: 160cc1ac2b4cbad3fa14d973566f516f57be7dac
+SHA512:
+  metadata.gz: 7066b9fe2a434f04eaa5e5f591b33b30d9ca1c758ab54ca1297df406ba3eeeb1239cb16f2cb5040a5f20d9cd52d2404e627d80bc31a6041a337334c3daf78b05
+  data.tar.gz: 3cee5b2a3acb9242ab1895e02f4a9b73ecb17ea64ec1c73bb0b3d3ec60b00a164af9765c440df4c261a91bff102297f94c7921a5216cebe1972176d4a30a45ab

data/README.md

@@ -1,3 +1,73 @@
-*findr* is a ruby find and replace tool for batch editing text files.
+*findr* is a ruby find and replace tool for mass editing of text files using (advanced) regular expressions.
 
 [![Build Status](https://travis-ci.org/mstrauss/findr.svg)](https://travis-ci.org/mstrauss/findr)
+
+Usage
+-----
+
+    Usage: findr [options] <search regex> [<replacement string>]
+        -g, --glob FILE SEARCH GLOB      e.g. "*.{rb,erb}"; glob relative to the current directory
+        -G, --global-glob GLOB           e.g. "/**/*.{rb,erb}"; glob may escape the current directory
+        -i, --ignore-case                do a case-insensitive search
+        -n, --number-of-context LINES    number of lines in context to print
+        -x, --execute                    actually execute the replacement
+        -c, --coding FILE CODING SYSTEM  e.g. "iso-8859-1"
+        -s, --save                       saves your options to .findr-config for future use
+        -C, --codings-list               list available encodings
+        -v, --verbose                    verbose output
+    
+*findr* recursively searches for the given [regular expression](http://rubular.com) in all files matching the given [glob](http://www.ruby-doc.org/core-2.5.1/Dir.html#method-c-glob), **starting from the current subdirectory**.
+
+
+Basic Examples
+--------------
+
+* To **search the term** 123.456 in all `txt`-files:
+
+        findr -g '*.txt' 123\\.456
+
+    The `*.txt` must be escaped (from the shell) by using apostrophes, otherwise the shell might expand it to the names of `txt` files in the current directory.
+
+    The dot must be escaped (from the regexp parser), otherwise is would stand for *any* character.  To escape the dot---on most shells---you could either write two backslashes to feed one backslash into the program, or put the command under single apostrophes, like
+
+        findr '123\.456'
+
+
+* To **replace the term** 123.456 by 33.0:
+
+        findr '123\.456' 33.0
+
+    The previous command shows a preview of what would happen. Adding `-x` executes the change and irreversibly alters your files:
+
+        findr 123\.456 33.0 -x
+
+
+* To do a **case-insensitive search** for `word` use
+
+        findr '(?i:word)'
+
+
+Advanced Examples
+-----------------
+
+* A more complicated example:  *findr* allows to **use matches** in the replacement string and also allows the use of advanced regular expression features like **lazy matching**.  Consider the following input file `example.txt`:
+
+        a = 99
+        b=123;
+        var  = 44
+        d = 55 ;
+        x=
+
+    Say, you want to normalize it in a way that there is exactly one space before and after the equal sign and each line should end with an semicolon.  One way to do it:
+
+        findr -g example.txt '(.*?)\s*=\s*(.*?)[\s;]*$' '\1 = \2;' -x
+
+    `\s` stands for any whitespace character.  `.*?` lazily matches any character, until the following expression (here `[\s;]*$`) matches.  The `$` sign is necessary to make the second lazy matcher `.*?` not *too* lazy.  The lazy matcher gives the *minimal* string possible to fulfill the regular expression--even when this means aborting prematurely. So, we need to take the line end matcher `$` into the regexp.
+
+    This changes `example.txt` to:
+
+        a = 99;
+        b = 123;
+        var = 44;
+        d = 55;
+        x = ;

data/Rakefile

@@ -1,5 +1,8 @@
-task :default => [:test]
+require 'bundler/gem_tasks'
+require 'rake/rspec'
+
+task :default => [:test, :spec]
 
 task :test do
-  exit system "bin/findr -g '*.rb' VERSION"
+  fail("Command failed.") unless system("bin/findr -g '*.rb' VERSION")
 end

data/findr.gemspec

@@ -6,33 +6,30 @@ require "findr/version"
 Gem::Specification.new do |s|
   s.name     = "findr"
   s.version  = Findr::VERSION.dup
-  s.date     = "2014-11-20"
-  s.summary  = "A ruby find and replace tool for batch editing text files."
+  s.licenses = ['MIT']
+  s.date     = "2018-10-15"
+  s.summary  = "A ruby find and replace tool for mass editing text files."
   s.email    = "Markus@ITstrauss.eu"
   s.homepage = "https://github.com/mstrauss/findr"
   s.authors  = ['Markus Strauss']
 
   s.description = <<-EOF
-A ruby find and replace tool for batch editing text files.
+A ruby find and replace tool for mass editing of text files.
 EOF
 
   dependencies = [
-    [:test, 'rake']
-    # Examples:
-    # [:runtime,     "rack",  "~> 1.1"],
-    # [:development, "rspec", "~> 2.1"],
+    [:development, 'rake', '~> 10.0'],
+    [:development, 'rspec', "~> 3.1"],
+    [:development, 'rake-rspec', "~> 0.0.2"],
+    [:development, 'bundler', "~>1.10"]
   ]
 
-  s.files         = Dir['**/*']
+  s.files         = Dir['**/*']-Dir['*.lock','*.txt','*.gem']
   s.test_files    = Dir['test/**/*'] + Dir['spec/**/*']
   s.executables   = Dir['bin/*'].map { |f| File.basename(f) }
   s.require_paths = ["lib"]
 
-
-  ## Make sure you can build the gem on older versions of RubyGems too:
-  s.rubygems_version = "1.8.11"
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.specification_version = 3 if s.respond_to? :specification_version
+  s.required_ruby_version = '>= 1.8.7'
 
   dependencies.each do |type, name, version|
     if s.respond_to?("add_#{type}_dependency")

data/lib/findr.rb

@@ -1,2 +1,15 @@
 $:.unshift(File.dirname(__FILE__)) unless
   $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+module Findr
+  FIRST_RUBY_WITHOUT_ICONV = '1.9'
+end
+
+require 'iconv' if RUBY_VERSION < Findr::FIRST_RUBY_WITHOUT_ICONV
+
+require 'findr/version'
+require 'findr/error'
+require 'findr/strategy_proxy'
+require 'findr/encoder/iconv'
+require 'findr/encoder/string'
+require 'findr/encoder'

data/lib/findr/cli.rb

@@ -5,9 +5,6 @@ require 'optparse'
 require 'yaml'
 require 'pp'
 
-require 'findr/version'
-require 'findr/encoder'
-
 module Findr
 
   class CLI
@@ -22,10 +19,14 @@ module Findr
     def green(text); colorize(text, 32); end
     def yellow(text); colorize(text, 33); end
     def blue(text); colorize(text, 34); end
+    def gray(text); colorize(text, 2); end
+    def bold(text); colorize(text, '1;30'); end
+    def bold_yellow(text); colorize(text, '1;33'); end
+    def blue_bold(text); colorize(text, '1;34'); end
 
     def banner
       red( "FINDR VERSION #{Findr::VERSION}. THIS PROGRAM COMES WITH NO WARRANTY WHATSOEVER. MAKE BACKUPS!") + $/ +
-      "Usage: #{Pathname($0).basename} [options] <search regex> [<replacement string>]"
+      bold( "Usage: #{Pathname($0).basename} [options] <search regex> [<replacement string>]" )
     end
 
     def show_usage
@@ -34,26 +35,32 @@ module Findr
     end
 
     def execute(stdout, arguments=[])
+
+      @stdout = stdout
+
       # unless arguments[0]
       # end
 
       # default options
       options = {}
-      options[:glob] = '*'
       options[:coding] = 'utf-8'
-
-      # options from file, if present
-      if File.exists?( CONFIGFILE )
-        file_options = YAML.load_file(CONFIGFILE)
-        file_options.delete(:save)
-        options.merge!( file_options )
-        stdout.puts green "Using #{CONFIGFILE}."
-      end
+      @context_lines = 0
 
       # parse command line
       @option_parser = OptionParser.new do |opts|
-        opts.on('-g', '--glob FILE SEARCH GLOB', 'e.g. "*.{rb,erb}"') do |glob|
+        opts.on('-g', '--glob FILE SEARCH GLOB', 'e.g. "*.{rb,erb}"; glob relative to the current directory') do |glob|
           options[:glob] = glob
+          fail "-g option cannot be combined with -G" if options[:gglob]
+        end
+        opts.on('-G', '--global-glob GLOB', 'e.g. "/**/*.{rb,erb}"; glob may escape the current directory') do |glob|
+          options[:gglob] = glob
+          fail "-G option cannot be combined with -g" if options[:glob]
+        end
+        opts.on('-i', '--ignore-case', 'do a case-insensitive search') do
+          options[:re_opt_i] = true
+        end
+        opts.on('-n', '--number-of-context LINES', 'number of lines in context to print') do |lines|
+          @context_lines = lines.to_i
         end
         opts.on('-x', '--execute', 'actually execute the replacement') do
           options[:force] = true
@@ -68,10 +75,18 @@ module Findr
           pp Encoder.list
           exit
         end
+        opts.on('-v', '--verbose', "verbose output") do
+          @verbose = true
+        end
       end
       @option_parser.banner = self.banner
       @option_parser.parse!( arguments )
 
+      # default (local) glob
+      if !options[:glob] && !options[:gglob]
+        options[:glob] = '*'
+      end
+
       # optionally save the configuration to file
       if options[:save]
         options.delete(:save)
@@ -79,12 +94,23 @@ module Findr
         File.open( CONFIGFILE, 'w' ) { |file| YAML::dump( options, file ) }
         stdout.puts green "Saved options to file #{CONFIGFILE}."
         exit
+      else
+        # options from file, if present
+        if File.exists?( CONFIGFILE )
+          file_options = YAML.load_file(CONFIGFILE)
+          file_options.delete(:save)
+          options.merge!( file_options )
+          stdout.puts green "Using #{CONFIGFILE}."
+        end
       end
 
+      # build default global glob from local glob, if necessary
+      options[:gglob] = '**/' + options[:glob] unless options[:gglob]
+
       show_usage if arguments.size == 0
       arguments.clone.each do |arg|
         if !options[:find]
-          options[:find] = Regexp.compile( arg )
+          options[:find] = Regexp.compile( arg, options[:re_opt_i] )
           arguments.delete_at(0)
         elsif !options[:replace]
           options[:replace] = arg
@@ -95,7 +121,7 @@ module Findr
       end
 
       show_usage if arguments.size != 0
-      stdout.puts green "File inclusion glob: " + options[:glob]
+      stdout.puts green "File inclusion glob: " + options[:gglob]
       stdout.puts green "Searching for regex " + options[:find].to_s
 
       # some statistics
@@ -107,19 +133,27 @@ module Findr
 
       coder = Encoder.new( options[:coding] )
 
-      Pathname.glob("**/#{options[:glob]}").each do |current_file|
+      verbose "Building file tree..."
+      files = Pathname.glob("#{options[:gglob]}")
+      verbose ['  ', files.count, ' files found.']
+      files.each do |current_file|
         next unless current_file.file?
+        verbose ["Reading file ", current_file]
         stats[:total_files] += 1
         stats[:local_hits] = 0
         firstmatch = true
         linenumber = 0
-        tempfile = Tempfile.new( 'current_file.basename' ) if options[:replace] && options[:force]
+        tempfile = Tempfile.new( 'current_file.basename' ) and verbose(['  Create tempfile ',tempfile.path]) if options[:replace] && options[:force]
+        clear_context(); print_post_context = 0
         current_file.each_line do |l|
           begin
-            l = coder.decode(l)
+            l, coding = coder.decode(l)
           rescue Encoder::Error
             stdout.puts "Skipping file #{current_file} because of error on line #{linenumber}: #{$!.original.class} #{$!.original.message}"
-            tempfile.unlink if tempfile
+            if tempfile
+              tempfile_path = tempfile.path
+              tempfile.unlink and verbose(['  Delete tempfile ', tempfile_path])
+            end
             break
           end
           linenumber += 1
@@ -128,24 +162,40 @@ module Findr
             if firstmatch
               stdout.puts red("#{current_file.cleanpath}:")
             end
-            stdout.write( yellow( "%6d:" % [linenumber, l] ) )
-            stdout.puts l
+            if @context_lines > 0
+              pop_context.map do |linenumber, l|
+                print_line( linenumber, l, coding, false )
+              end
+              print_post_context = @context_lines
+            end
+            print_line( linenumber, l.gsub( /(#{options[:find]})/, bold('\1') ), coding, :bold )
             firstmatch = false
             if options[:replace]
-              stdout.write( blue( "%6d:" % [linenumber, l] ) )
               l_repl = l.gsub( options[:find], options[:replace] )
-              tempfile.puts coder.encode(l_repl) if tempfile
-              stdout.puts blue l_repl
+              tempfile.puts coder.encode(l_repl, coding) if tempfile
               replacement_done = true
+              print_line( linenumber, l_repl, coding, :blue )
+            end
+          else
+            if tempfile
+              tempfile.puts coder.encode(l, coding)
+            end
+            if print_post_context > 0
+              print_post_context -= 1
+              print_line( linenumber, l, coding )
+            else
+              push_context([linenumber, l])
             end
-          elsif tempfile
-            tempfile.puts coder.encode(l)
           end
         end
         if tempfile
           tempfile.close
-          FileUtils.cp( tempfile.path, current_file ) if stats[:local_hits] > 0
-          tempfile.unlink
+          if stats[:local_hits] > 0
+            FileUtils.cp( tempfile.path, current_file )
+            verbose(['  Copy tempfile ', tempfile.path, ' to ', current_file])
+          end
+          tempfile_path = tempfile.path
+          tempfile.unlink and verbose(['  Delete tempfile ', tempfile_path])
         end
 
         if stats[:local_hits] > 0
@@ -159,6 +209,44 @@ module Findr
       stdout.puts green( "#{stats[:total_hits]} occurences (lines) in #{stats[:hit_files]} of #{stats[:total_files]} files found." )
     end
 
+    def print_line( linenumber, line, coding, color = nil )
+      case color
+      when :bold
+        @stdout.write( bold_yellow( "%6d: " % [linenumber] ) )
+        @stdout.write gray("(coding: #{coding}) ")
+        @stdout.puts line
+      when :blue
+        @stdout.write( blue( "%6d: " % [linenumber] ) )
+        @stdout.write gray("(coding: #{coding}) ")
+        @stdout.puts blue line
+      else
+        @stdout.write( yellow( "%6d: " % [linenumber] ) )
+        @stdout.write gray("(coding: #{coding}) ")
+        @stdout.puts line
+      end
+    end
+
+    def clear_context
+      @context = []
+    end
+
+    def push_context(line)
+      @context.shift if @context.length >= @context_lines
+      @context.push(line)
+    end
+
+    def pop_context
+      return [] unless @context_lines > 0
+      c = @context
+      clear_context()
+      return c
+    end
+
+    def verbose(text_or_arry)
+      @stdout.puts( gray( Array(text_or_arry).join ) ) if @verbose
+    end
+
+
   end
 
 end

data/lib/findr/encoder.rb

@@ -1,57 +1,21 @@
-FIRST_RUBY_WITHOUT_ICONV = '1.9'
-require 'iconv' if RUBY_VERSION < FIRST_RUBY_WITHOUT_ICONV
-
 module Findr
 
-  # Class for wrapping original exceptions, which could be from Iconv (Ruby 1.8)
-  # or String (Ruby >=1.9).
-  # ()
-  class Error < ::StandardError
-    attr_reader :original
-    def initialize(msg, original=$!)
-      super(msg)
-      @original = original;
-    end
-  end
-
   # Wrapper class for String#encode (Ruby >=1.9) and Iconv#iconv (Ruby 1.8).
   class Encoder
 
     class Error < Findr::Error; end
 
-    class <<self
-      def list
-        return Iconv.list if RUBY_VERSION < FIRST_RUBY_WITHOUT_ICONV
-        return Encoding.list.map(&:to_s)
-      end
-    end
+    include StrategyProxy
+    @@strategy = RUBY_VERSION < Findr::FIRST_RUBY_WITHOUT_ICONV ? Encoder::Iconv : Encoder::String
 
-    def initialize( other_coding )
-      if RUBY_VERSION < FIRST_RUBY_WITHOUT_ICONV
-        @coding_to_utf8 = Iconv.new('UTF-8', other_coding)
-        @utf8_to_coding = Iconv.new(other_coding, 'UTF-8')
-      else
-        @other_coding = Encoding.find(other_coding)
-      end
-    end
+    provides :decode, :string
+    provides :encode, :string, :into_coding
+    singleton_provides :list
 
-    # Encodes given +string+ from +@other_coding+ to utf8.
-    def decode( string )
-      return @coding_to_utf8.iconv(string) if RUBY_VERSION < FIRST_RUBY_WITHOUT_ICONV
-      string.force_encoding(@other_coding)
-      fail Error.new("Encoding '#{@other_coding}' is invalid.") unless string.valid_encoding?
-      return string.encode('UTF-8')
-    rescue
-      raise Error, "Error when decoding from '#{@other_coding}' into 'UTF-8'."
+    def initialize( other_codings )
+      @strategy = @@strategy.new(other_codings)
     end
 
-    # Encodes given utf8 +string+ into +@other_coding+.
-    def encode( string )
-      return @utf8_to_coding.iconv(string) if RUBY_VERSION < FIRST_RUBY_WITHOUT_ICONV
-      return string.encode(@other_coding)
-    rescue
-      raise Error, "Error when encoding from 'UTF-8' into '#{@other_coding}'."
-    end
   end
 
 end

data/lib/findr/encoder/iconv.rb

@@ -0,0 +1,43 @@
+class Findr::Encoder
+
+  class Iconv
+    def initialize( other_coding )
+      @other_coding = other_coding.split(',')
+    end
+
+    # Encodes given +string+ from +@other_coding+ to utf8.
+    def decode( string )
+      coding = nil
+      coded_string = nil
+      have_valid_coding = @other_coding.any? do |c|
+        begin
+          coded_string = ::Iconv.conv('UTF-8', c, string)
+          coding = c
+          true
+        rescue
+          false
+        end
+      end
+      fail Error.new("No valid coding given.") unless have_valid_coding
+      return [coded_string, coding.to_s.upcase]
+    rescue
+      raise Error, "Error when decoding from '#{@other_coding}' into 'UTF-8': #{$!}"
+      return
+    end
+
+    # Encodes given utf8 +string+ into +coding+.
+    def encode( string, coding )
+      return ::Iconv.conv(coding, 'UTF-8', string)
+    rescue
+      raise Error, "Error when encoding from 'UTF-8' into '#{coding}'."
+    end
+
+    # Returns a list of valid encodings
+    def self.list
+      return ::Iconv.list
+    rescue
+      fail Error, "Iconv.list not supported on Ruby #{RUBY_VERSION}. Try 'iconv -l' on the command line."
+    end
+  end
+
+end

data/lib/findr/encoder/string.rb

@@ -0,0 +1,35 @@
+class Findr::Encoder
+
+  class String
+    def initialize( other_coding )
+      @other_coding = other_coding.split(',').map {|coding| Encoding.find(coding)}
+    end
+
+    # Encodes given +string+ from +@other_coding+ to utf8.
+    def decode( string )
+      coding = nil
+      have_valid_coding = @other_coding.any? do |c|
+        string.force_encoding(c)
+        coding = c
+        string.valid_encoding?
+      end
+      fail Error.new("No valid coding given.") unless have_valid_coding
+      return [string.encode('UTF-8'), coding.to_s]
+    rescue
+      raise Error, "Error when decoding from '#{@other_coding}' into 'UTF-8': #{$!}"
+    end
+
+    # Encodes given utf8 +string+ into +coding+.
+    def encode( string, coding )
+      return string.encode(coding)
+    rescue
+      raise Error, "Error when encoding from 'UTF-8' into '#{coding}'."
+    end
+
+    # Returns a list of valid encodings
+    def self.list
+      return Encoding.list.map(&:to_s)
+    end
+  end
+
+end

data/lib/findr/error.rb

@@ -0,0 +1,14 @@
+module Findr
+
+  # Class for wrapping original exceptions, which could be from Iconv (Ruby 1.8)
+  # or String (Ruby >=1.9).
+  # ()
+  class Error < ::StandardError
+    attr_reader :original
+    def initialize(msg, original=$!)
+      super(msg)
+      @original = original;
+    end
+  end
+
+end

data/lib/findr/strategy_proxy.rb

@@ -0,0 +1,53 @@
+module Findr
+  # +StrategyProxy+
+  # based on [AbstractInterface by Mark Bates](http://metabates.com/2011/02/07/building-interfaces-and-abstract-classes-in-ruby/)
+  # and on [Contractual by Joseph Weissman](https://rubygems.org/gems/contractual)
+  #
+  # +include StrategyProxy+ to declare a class to be a +StrategyProxy+.
+  # Also you need to define +@strategy+ in the initializer of your class and +@@strategy++ if you want to use +singleton_provides+.
+  module StrategyProxy
+
+    class MethodNotImplementedError < NoMethodError; end
+
+    def self.included(klass)
+      klass.send(:include, StrategyProxy::Methods)
+      klass.send(:extend,  StrategyProxy::Methods)
+      klass.send(:extend,  StrategyProxy::ClassMethods)
+    end
+
+    module Methods
+      def does_not_implement_method(klass, method_name = nil)
+        klass_name = klass.kind_of?(Class) ? klass.name : klass.class.name
+        raise MethodNotImplementedError.new("#{klass_name} needs to implement '#{method_name}' for StrategyProxy #{self.class.name}!")
+      end
+    end
+
+    module ClassMethods
+      def provides(method_name, *argument_names)
+        arglist = argument_names.map(&:to_sym).join(',')
+        method_string = <<-END_METHOD
+          def #{method_name}(#{arglist})
+            @strategy.#{method_name}(#{arglist})
+          rescue NoMethodError
+            does_not_implement_method(@strategy, '#{method_name}')
+          end
+        END_METHOD
+        class_eval method_string
+      end
+
+      # before using +singleton_provides+ you must define +@@strategy+ BEFORE FIRST USE of the defined singleton methods
+      def singleton_provides(method_name, *argument_names)
+        arglist = argument_names.map(&:to_sym).join(',')
+        method_string = <<-END_METHOD
+          def self.#{method_name}(#{arglist})
+            @@strategy.#{method_name}(#{arglist})
+          rescue NoMethodError
+            does_not_implement_method(@@strategy, 'self.#{method_name}')
+          end
+        END_METHOD
+        class_eval method_string
+      end
+    end
+
+  end
+end

data/lib/findr/version.rb

@@ -1,3 +1,3 @@
 module Findr
-  VERSION = '0.0.4'
+  VERSION = '0.0.7'
 end

data/spec/findr/encoder_spec.rb

@@ -0,0 +1,71 @@
+# encoding: utf-8
+require 'spec_helper'
+
+def skip_new_ruby
+  skip "Incorrect Ruby version." if RUBY_VERSION > '1.9'
+end
+
+def skip_old_ruby
+  skip "Incorrect Ruby version." if RUBY_VERSION < '1.9'
+end
+
+
+module Findr
+
+  RSpec.describe Encoder do
+
+    let(:utf8_string)   {'123ö'}
+    let(:latin1_string) {"123\xF6"}
+    let(:cp850_string)  {"123\x94"}
+
+    describe '.list' do
+      subject {Encoder.list}
+
+      it 'fails on ruby 1.8' do
+        skip_new_ruby
+        expect{subject}.to raise_error(Encoder::Error) do |error|
+          expect(error.message).to include('Iconv.list not supported')
+          expect(error.original).to be_kind_of(NoMethodError)
+          expect(error.original.message).to eq("undefined method `list' for Iconv:Class")
+        end
+
+      end
+
+      it 'returns a list of supported encodings' do
+        skip_old_ruby
+        expect(subject).to include('UTF-8')
+        expect(subject).to include('ISO-8859-1')
+      end
+    end
+
+    describe 'decode' do
+
+      it 'should accept single codings' do
+        expect(Encoder.new('utf-8').decode(utf8_string)).to eq([utf8_string, 'UTF-8'])
+        expect(Encoder.new('iso-8859-1').decode(latin1_string)).to eq([utf8_string, 'ISO-8859-1'])
+        expect(Encoder.new('us-ascii').decode('123')).to eq(['123', 'US-ASCII'])
+      end
+
+      it 'should accept multiple encodings' do
+        expect(Encoder.new('ascii,cp850').decode(cp850_string)).to eq([utf8_string, 'CP850'])
+      end
+
+      it 'should fail if no valid coding can be found' do
+        expect{Encoder.new('ascii').decode("123\x94")}.to \
+          raise_error(Encoder::Error) do |error|
+            expect(error.original).to be_kind_of(Encoder::Error)
+            expect(error.original.message).to include('No valid coding given')
+          end
+      end
+    end
+
+    describe 'encode' do
+      it 'should accept single codings' do
+        expect(Encoder.new('utf-8').encode(utf8_string, 'utf-8')).to eq(utf8_string)
+      end
+
+    end
+
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,92 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause this
+# file to always be loaded, without a need to explicitly require it in any files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as
+# light-weight as possible. Requiring heavyweight dependencies from this file
+# will add to the boot time of your test suite on EVERY test run, even for an
+# individual file that may not need all of that loaded. Instead, consider making
+# a separate helper file that requires the additional dependencies and performs
+# the additional setup, and require it from the spec files that actually need it.
+#
+# The `.rspec` file also contains a few flags that are not defaults but that
+# users commonly want.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    # be_bigger_than(2).and_smaller_than(4).description
+    #   # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #   # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+# The settings below are suggested to provide a good initial experience
+# with RSpec, but feel free to customize to your heart's content.
+# =begin
+  # These two settings work together to allow you to limit a spec run
+  # to individual examples or groups you care about by tagging them with
+  # `:focus` metadata. When nothing is tagged with `:focus`, all examples
+  # get run.
+  config.filter_run :focus
+  config.run_all_when_everything_filtered = true
+
+  # Limits the available syntax to the non-monkey patched syntax that is recommended.
+  # For more details, see:
+  #   - http://myronmars.to/n/dev-blog/2012/06/rspecs-new-expectation-syntax
+  #   - http://teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   - http://myronmars.to/n/dev-blog/2014/05/notable-changes-in-rspec-3#new__config_option_to_disable_rspeccore_monkey_patching
+  config.disable_monkey_patching!
+
+  # This setting enables warnings. It's recommended, but in some cases may
+  # be too noisy due to issues in dependencies.
+  config.warnings = true
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.default_formatter = 'doc'
+  end
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
+# =end
+end
+
+require './lib/findr'
+require "./lib/findr/cli"

metadata

@@ -1,33 +1,72 @@
 --- !ruby/object:Gem::Specification
 name: findr
 version: !ruby/object:Gem::Version
-  version: 0.0.4
-  prerelease: 
+  version: 0.0.7
 platform: ruby
 authors:
 - Markus Strauss
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-11-20 00:00:00.000000000 Z
+date: 2018-10-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
+        version: '10.0'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-description: ! 'A ruby find and replace tool for batch editing text files.
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: rake-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+description: 'A ruby find and replace tool for mass editing of text files.
 
 '
 email: Markus@ITstrauss.eu
@@ -36,38 +75,46 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- Gemfile
+- README.md
+- Rakefile
 - bin/findr
 - findr.gemspec
-- Gemfile
-- Gemfile.lock
+- lib/findr.rb
 - lib/findr/cli.rb
 - lib/findr/encoder.rb
+- lib/findr/encoder/iconv.rb
+- lib/findr/encoder/string.rb
+- lib/findr/error.rb
+- lib/findr/strategy_proxy.rb
 - lib/findr/version.rb
-- lib/findr.rb
-- Rakefile
-- README.md
+- pkg/findr-0.0.7.gem
+- spec/findr/encoder_spec.rb
+- spec/spec_helper.rb
 homepage: https://github.com/mstrauss/findr
-licenses: []
+licenses:
+- MIT
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.8.7
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.23.2
+rubygems_version: 2.5.2.1
 signing_key: 
-specification_version: 3
-summary: A ruby find and replace tool for batch editing text files.
-test_files: []
+specification_version: 4
+summary: A ruby find and replace tool for mass editing text files.
+test_files:
+- spec/findr/encoder_spec.rb
+- spec/spec_helper.rb

data/Gemfile.lock

@@ -1,16 +0,0 @@
-PATH
-  remote: .
-  specs:
-    findr (0.0.4)
-      rake
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    rake (0.9.2.2)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  findr!