Dahistory 0.1.0

data/.gitignore

@@ -0,0 +1,8 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+
+coverage
+rdoc
+.yardoc

data/Dahistory.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+
+$:.push File.expand_path("../lib", __FILE__)
+require "Dahistory/version"
+
+Gem::Specification.new do |s|
+  s.name        = "Dahistory"
+  s.version     = Dahistory::VERSION
+  s.authors     = ["da99"]
+  s.email       = ["i-hate-spam-45671204@mailinator.com"]
+  s.homepage    = "https://github.com/da99/Dahistory"
+  s.summary     = %q{Compare file to previous history and backup.}
+  s.description = %q{Compares file to other files in specified dir(s) and backups if it does not exist.}
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency "bacon"
+  s.add_development_dependency "rake"
+  s.add_development_dependency 'Bacon_Colored'
+  s.add_development_dependency 'pry'
+  
+  # s.rubyforge_project = "Dahistory"
+  # specify any dependencies here; for example:
+  # s.add_runtime_dependency "rest-client"
+end

data/Gemfile

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in Bob.gemspec
+gemspec

data/README.md

@@ -0,0 +1,39 @@
+
+Dahistory
+=========
+
+Short for: da99's gem for file history.
+
+It helps you compare files and decide if the file should be backed up.
+It is mainly to help you keep backups of files you overwrite on servers you administer.
+
+**Example:** You use Chef or Puppet to write a config file, but you want to be sure you
+are overwriting a file you have encountered before.
+
+Useage
+------
+
+    require "Dahistory"
+
+    path = "some/file.txt"
+    Dahistory_File( path )
+    # Checks your ./history directory.
+    # If not found there, saves copy of file in ./pending dir and
+    #  raises Dahistory::Pending_File, "pending/HOSTNAME,path,some,file.txt.TIMESTAMP"
+
+    # You review the file,
+    #   move the file from the pending directory, and 
+    #   re-do your last command (Capistrano, Chef, Puppet, etc.)
+
+Override the default settings:
+
+    Dahistory.check { |o|
+    
+      o.file        "file/path.txt"
+      o.dirs        [ "dir1", "dir2" ]
+      o.backup_dir  "./history"
+      o.pending_dir "pending_dir_path"
+      o.backup_file "#{`hostname`}.backup.path.txt"
+      
+    }
+

data/Rakefile

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+
+require "bundler/gem_tasks"

data/lib/Dahistory/version.rb

@@ -0,0 +1,3 @@
+class Dahistory
+  VERSION = "0.1.0"
+end

data/lib/Dahistory.rb

@@ -0,0 +1,108 @@
+require 'Dahistory/version'
+
+
+class Dahistory
+ 
+  Pending = Class.new(RuntimeError)
+  
+  module Class_Methods
+
+    def check file = nil
+      da = Dahistory.new { |o| 
+        o.file(file) if file
+        yield(o)     if block_given?
+      }
+      
+      da.save
+    end
+
+  end # === module
+
+  extend Class_Methods
+
+  def initialize file_path = nil
+    @file = nil
+    file!(file_path) if file_path
+    dirs      ['.']
+    pending_dir  "./pending"
+    @backup_dir = nil
+    yield(self) if block_given?
+  end
+  
+  old_meths = public_instance_methods
+
+  def file path
+    @file = File.expand_path(path)
+  end
+
+  def dirs *args
+    @dirs = args.flatten.map { |dir| File.expand_path dir }
+  end
+
+  def backup_dir dir
+    @backup_dir = File.expand_path(dir)
+  end
+
+  def pending_dir dir = :RETURN
+    @pending_dir = File.expand_path(dir)
+  end
+
+  (public_instance_methods - old_meths ).each { |name| 
+    
+    alias_method :"#{name}_set", name
+
+    eval %~
+      def #{name} *args, &blok
+      
+        if args.empty?
+        
+          unless instance_variable_defined?(:@#{name})
+            raise ArgumentError, "Instance variable not set: @#{name}"
+          end
+          @#{name}
+          
+        else
+        
+          #{name}_set(*args, &blok)
+          #
+        end
+        
+      end # === def
+    ~
+    
+  }
+  
+  def backup_file str = :RETURN
+    if str == :RETURN
+      @backup_file ||= "#{`hostname`.strip}-#{file.gsub('/',',')}.#{Time.now.utc.strftime "%Y.%m.%d.%H.%M.%S"}"
+      return @backup_file
+    end
+    
+    @backup_file = str
+  end
+
+  def source_files
+    dirs.map { |path| 
+      full = File.join( File.expand_path(path), "/*")
+      files = Dir.glob( full, File::FNM_DOTMATCH ).select { |unk| File.file?(unk) }
+    }.flatten
+  end
+  
+  def save 
+
+    content  = File.read(file)
+    standard = content.gsub("\r", '')
+
+    old = source_files.detect { |path| 
+      raw = File.read(path) 
+      raw.gsub("\r","") == standard
+    }
+
+    if !old
+      File.write(backup_file, content)
+      raise Pending, backup_file
+    end
+    
+  end # === def
+  
+end # === class Dahistory

data/spec/helper.rb

@@ -0,0 +1,15 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.print e.message, "\n"
+  $stderr.print "Run `bundle install` to install missing gems\n"
+  exit e.status_code
+end
+require 'bacon'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+Bacon.summary_on_exit

data/spec/main.rb

@@ -0,0 +1,34 @@
+
+require File.expand_path('spec/helper')
+require 'Dahistory'
+require 'Bacon_Colored'
+require 'pry'
+
+
+FOLDER = "/tmp/Dahistory_tmp"
+
+def chdir 
+  Dir.chdir(FOLDER) { yield }
+end
+
+def reset_dirs
+  `rm -rf #{FOLDER}`
+  `mkdir #{FOLDER}`
+  `mkdir #{FOLDER}/files`
+  `mkdir #{FOLDER}/history`
+  `mkdir #{FOLDER}/history/blue`
+  `mkdir #{FOLDER}/history/red`
+  `mkdir #{FOLDER}/history/yellow`
+  `mkdir #{FOLDER}/pending`
+end
+
+reset_dirs
+
+# ======== Include the tests.
+if ARGV.size > 1 && ARGV[1, ARGV.size - 1].detect { |a| File.exists?(a) }
+  # Do nothing. Bacon grabs the file.
+else
+  Dir.glob('spec/tests/*.rb').each { |file|
+    require File.expand_path(file.sub('.rb', '')) if File.file?(file)
+  }
+end

data/spec/tests/Dashistory.rb

@@ -0,0 +1,22 @@
+
+describe "Dahistory: new pending file" do
+
+  before { reset_dirs }
+  
+  it "copies file to pending dir" do
+
+    file = "files/a.txt"
+    target = rand(1000).to_s
+    chdir {
+      File.write(file, target)
+      pending = begin
+                  Dahistory.check("files/a.txt") 
+                rescue Dahistory::Pending => e
+                  e.message
+                end
+      File.read(pending).should == target
+    }
+  end
+  
+end # === Dahistory: new pending file
+

data/spec/tests/bin.rb

@@ -0,0 +1,13 @@
+
+bins = Dir.glob("bin/*")
+
+unless bins.empty?
+  describe "permissions of bin/" do
+    bins.each { |file|
+      it "should chmod 755 for: #{file}" do
+        `stat -c %a #{file}`.strip
+        .should.be == "755"
+      end
+    }
+  end # === permissions of bin/
+end # === unless bins.empty?

metadata

@@ -0,0 +1,121 @@
+--- !ruby/object:Gem::Specification
+name: Dahistory
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- da99
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-03-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bacon
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: Bacon_Colored
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Compares file to other files in specified dir(s) and backups if it does
+  not exist.
+email:
+- i-hate-spam-45671204@mailinator.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Dahistory.gemspec
+- Gemfile
+- README.md
+- Rakefile
+- lib/Dahistory.rb
+- lib/Dahistory/version.rb
+- spec/helper.rb
+- spec/main.rb
+- spec/tests/Dashistory.rb
+- spec/tests/bin.rb
+homepage: https://github.com/da99/Dahistory
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.19
+signing_key: 
+specification_version: 3
+summary: Compare file to previous history and backup.
+test_files: []