backup 2.4.5.1 → 3.0.0.build.0

data/spec/storage/object_spec.rb

@@ -0,0 +1,74 @@
+# encoding: utf-8
+
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Backup::Storage::Object do
+  let(:object) { Backup::Storage::Object.new(:s3) }
+
+  it do
+    object.storage_file.should == File.join(Backup::DATA_PATH, Backup::TRIGGER, 's3.yml')
+  end
+
+  describe '#load' do
+    it 'should return an array with objects' do
+      File.expects(:exist?).returns(true)
+      YAML.expects(:load_file).with(
+        File.join(Backup::DATA_PATH, Backup::TRIGGER, 's3.yml')
+      ).returns(YAML.load([Backup::Storage::S3.new, Backup::Storage::S3.new].to_yaml))
+
+      objects = object.load
+      objects.should be_an(Array)
+      objects.first.should be_an_instance_of(Backup::Storage::S3)
+    end
+
+    describe 'loading them sorted by time descending (newest backup is first in the array)' do
+      it do
+        obj_1 = Backup::Storage::S3.new; obj_1.time = '2007.00.00.00.00.00'
+        obj_2 = Backup::Storage::S3.new; obj_2.time = '2009.00.00.00.00.00'
+        obj_3 = Backup::Storage::S3.new; obj_3.time = '2011.00.00.00.00.00'
+
+        File.expects(:exist?).returns(true)
+        YAML.expects(:load_file).with(
+          File.join(Backup::DATA_PATH, Backup::TRIGGER, 's3.yml')
+        ).returns(YAML.load([obj_1, obj_2, obj_3].to_yaml))
+
+        objects = object.load
+        objects[0].time.should == '2011.00.00.00.00.00'
+        objects[1].time.should == '2009.00.00.00.00.00'
+        objects[2].time.should == '2007.00.00.00.00.00'
+      end
+
+      it do
+        obj_3 = Backup::Storage::S3.new; obj_3.time = '2007.00.00.00.00.00'
+        obj_2 = Backup::Storage::S3.new; obj_2.time = '2009.00.00.00.00.00'
+        obj_1 = Backup::Storage::S3.new; obj_1.time = '2011.00.00.00.00.00'
+
+        File.expects(:exist?).returns(true)
+        YAML.expects(:load_file).with(
+          File.join(Backup::DATA_PATH, Backup::TRIGGER, 's3.yml')
+        ).returns(YAML.load([obj_1, obj_2, obj_3].to_yaml))
+
+        objects = object.load
+        objects[0].time.should == '2011.00.00.00.00.00'
+        objects[1].time.should == '2009.00.00.00.00.00'
+        objects[2].time.should == '2007.00.00.00.00.00'
+      end
+
+      it do
+        obj_3 = Backup::Storage::S3.new; obj_3.time = '2007.00.00.00.00.00'
+        obj_1 = Backup::Storage::S3.new; obj_1.time = '2009.00.00.00.00.00'
+        obj_2 = Backup::Storage::S3.new; obj_2.time = '2011.00.00.00.00.00'
+
+        File.expects(:exist?).returns(true)
+        YAML.expects(:load_file).with(
+          File.join(Backup::DATA_PATH, Backup::TRIGGER, 's3.yml')
+        ).returns(YAML.load([obj_1, obj_2, obj_3].to_yaml))
+
+        objects = object.load
+        objects[0].time.should == '2011.00.00.00.00.00'
+        objects[1].time.should == '2009.00.00.00.00.00'
+        objects[2].time.should == '2007.00.00.00.00.00'
+      end
+    end
+  end
+end

data/spec/storage/rsync_spec.rb

@@ -0,0 +1,115 @@
+# encoding: utf-8
+
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Backup::Storage::RSync do
+
+  let(:rsync) do
+    Backup::Storage::RSync.new do |rsync|
+      rsync.username  = 'my_username'
+      rsync.password  = 'my_password'
+      rsync.ip        = '123.45.678.90'
+      rsync.port      = 22
+      rsync.path      = '~/backups/'
+    end
+  end
+
+  before do
+    Backup::Configuration::Storage::RSync.clear_defaults!
+  end
+
+  it 'should have defined the configuration properly' do
+    rsync.username.should == 'my_username'
+    rsync.password.should == 'my_password'
+    rsync.ip.should       == '123.45.678.90'
+    rsync.port.should     == 22
+    rsync.path.should     == 'backups/'
+  end
+
+  it 'should use the defaults if a particular attribute has not been defined' do
+    Backup::Configuration::Storage::RSync.defaults do |rsync|
+      rsync.username = 'my_default_username'
+      rsync.password = 'my_default_password'
+      rsync.path     = '~/backups'
+    end
+
+    rsync = Backup::Storage::RSync.new do |rsync|
+      rsync.password = 'my_password'
+      rsync.ip       = '123.45.678.90'
+    end
+
+    rsync.username.should == 'my_default_username'
+    rsync.password.should == 'my_password'
+    rsync.ip.should       == '123.45.678.90'
+    rsync.port.should     == 22
+  end
+
+  it 'should have its own defaults' do
+    rsync = Backup::Storage::RSync.new
+    rsync.port.should == 22
+    rsync.path.should == 'backups'
+  end
+
+  describe '#connection' do
+    it 'should establish a connection to the remote server using the provided ip address and credentials' do
+      Net::SSH.expects(:start).with('123.45.678.90', 'my_username', :password => 'my_password', :port => 22)
+      rsync.send(:connection)
+    end
+  end
+
+  describe '#transfer!' do
+    let(:connection) { mock('Net::SCP') }
+
+    before do
+      Net::SSH.stubs(:start).returns(connection)
+      rsync.stubs(:create_remote_directories!)
+      Backup::Logger.stubs(:message)
+    end
+
+    it 'should transfer the provided file to the path' do
+      Backup::Model.new('blah', 'blah') {}
+      file = mock("Backup::Storage::RSync::File")
+
+      rsync.expects(:create_remote_directories!)
+      rsync.expects(:utility).returns('rsync')
+      rsync.expects(:run).with("rsync -z -e ssh --port='22' '#{ File.join(Backup::TMP_PATH, "#{ Backup::TIME }.#{ Backup::TRIGGER }.tar") }' 'my_username@123.45.678.90:backups/#{ Backup::TRIGGER }/#{ Backup::TRIGGER }.tar'")
+
+      rsync.send(:transfer!)
+    end
+  end
+
+  describe '#remove!' do
+    let(:connection) { mock('Net::SCP') }
+
+    before do
+      Net::SSH.stubs(:start).returns(connection)
+    end
+
+    it 'should remove the file from the remote server path' do
+      connection.expects(:exec!).with("rm backups/myapp/#{ Backup::TIME }.#{ Backup::TRIGGER }.tar")
+      rsync.send(:remove!)
+    end
+  end
+
+  describe '#create_remote_directories!' do
+    let(:connection) { mock('Net::SSH') }
+
+    before do
+      Net::SSH.stubs(:start).returns(connection)
+    end
+
+    it 'should properly create remote directories one by one' do
+      rsync.path = 'backups/some_other_folder/another_folder'
+      connection.expects(:exec!).with("mkdir -p 'backups/some_other_folder/another_folder/myapp'")
+      rsync.send(:create_remote_directories!)
+    end
+  end
+
+  describe '#perform' do
+    it 'should invoke transfer!' do
+      rsync.expects(:transfer!)
+      rsync.perform!
+    end
+  end
+
+end

data/spec/storage/s3_spec.rb

@@ -0,0 +1,110 @@
+# encoding: utf-8
+
+require File.dirname(__FILE__) + '/../spec_helper'
+
+##
+# available S3 regions:
+# eu-west-1, us-east-1, ap-southeast-1, us-west-1
+describe Backup::Storage::S3 do
+
+  let(:s3) do
+    Backup::Storage::S3.new do |s3|
+      s3.access_key_id      = 'my_access_key_id'
+      s3.secret_access_key  = 'my_secret_access_key'
+      s3.region             = 'us-east-1'
+      s3.bucket             = 'my-bucket'
+      s3.path               = 'backups'
+      s3.keep               = 20
+    end
+  end
+
+  before do
+    Backup::Configuration::Storage::S3.clear_defaults!
+  end
+
+  it 'should have defined the configuration properly' do
+    s3.access_key_id.should      == 'my_access_key_id'
+    s3.secret_access_key.should  == 'my_secret_access_key'
+    s3.region.should             == 'us-east-1'
+    s3.bucket.should             == 'my-bucket'
+    s3.keep.should               == 20
+  end
+
+  it 'should use the defaults if a particular attribute has not been defined' do
+    Backup::Configuration::Storage::S3.defaults do |s3|
+      s3.access_key_id      = 'my_access_key_id'
+      s3.region             = 'us-east-1'
+    end
+
+    s3 = Backup::Storage::S3.new do |s3|
+      s3.region = 'us-west-1'
+      s3.path   = 'my/backups'
+    end
+
+    s3.access_key_id.should     == 'my_access_key_id' # not defined, uses default
+    s3.secret_access_key.should == nil                # not defined, no default
+    s3.region.should            == 'us-west-1'        # defined, overwrites default
+    s3.bucket.should            == nil                # not defined, no default
+    s3.path.should              == 'my/backups'       # overwritten from Backup::Storage::S3
+  end
+
+  describe '#connection' do
+    it 'should establish a connection to Amazon S3 using the provided credentials' do
+      Fog::Storage.expects(:new).with({
+        :provider               => 'AWS',
+        :aws_access_key_id      => 'my_access_key_id',
+        :aws_secret_access_key  => 'my_secret_access_key',
+        :region                 => 'us-east-1'
+      })
+
+      s3.send(:connection)
+    end
+  end
+
+  describe '#provider' do
+    it 'should be AWS' do
+      s3.provider == 'AWS'
+    end
+  end
+
+  describe '#transfer!' do
+    let(:connection) { mock('Fog::Storage') }
+    before do
+      Fog::Storage.stubs(:new).returns(connection)
+      Backup::Logger.stubs(:message)
+    end
+
+    it 'should transfer the provided file to the bucket' do
+      Backup::Model.new('blah', 'blah') {}
+      file = mock("Backup::Storage::S3::File")
+      File.expects(:read).with("#{File.join(Backup::TMP_PATH, "#{ Backup::TIME }.#{ Backup::TRIGGER}")}.tar").returns(file)
+      s3.expects(:remote_file).returns("#{ Backup::TIME }.#{ Backup::TRIGGER }.tar").twice
+      connection.expects(:sync_clock)
+      connection.expects(:put_object).with('my-bucket', "backups/myapp/#{ Backup::TIME }.#{ Backup::TRIGGER }.tar", file)
+      s3.send(:transfer!)
+    end
+  end
+
+  describe '#remove!' do
+    let(:connection) { mock('Fog::Storage') }
+    before do
+      Fog::Storage.stubs(:new).returns(connection)
+    end
+
+    it 'should remove the file from the bucket' do
+      s3.expects(:remote_file).returns("#{ Backup::TIME }.#{ Backup::TRIGGER }.tar")
+      connection.expects(:sync_clock)
+      connection.expects(:delete_object).with('my-bucket', "backups/myapp/#{ Backup::TIME }.#{ Backup::TRIGGER }.tar")
+      s3.send(:remove!)
+    end
+  end
+
+  describe '#perform' do
+    it 'should invoke transfer! and cycle!' do
+      s3.expects(:transfer!)
+      s3.expects(:cycle!)
+      s3.perform!
+    end
+  end
+
+end

data/spec/storage/scp_spec.rb

@@ -0,0 +1,129 @@
+# encoding: utf-8
+
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Backup::Storage::SCP do
+
+  let(:scp) do
+    Backup::Storage::SCP.new do |scp|
+      scp.username  = 'my_username'
+      scp.password  = 'my_password'
+      scp.ip        = '123.45.678.90'
+      scp.port      = 22
+      scp.path      = '~/backups/'
+      scp.keep      = 20
+    end
+  end
+
+  before do
+    Backup::Configuration::Storage::SCP.clear_defaults!
+  end
+
+  it 'should have defined the configuration properly' do
+    scp.username.should == 'my_username'
+    scp.password.should == 'my_password'
+    scp.ip.should       == '123.45.678.90'
+    scp.port.should     == 22
+    scp.path.should     == 'backups/'
+    scp.keep.should     == 20
+  end
+
+  it 'should use the defaults if a particular attribute has not been defined' do
+    Backup::Configuration::Storage::SCP.defaults do |scp|
+      scp.username = 'my_default_username'
+      scp.password = 'my_default_password'
+      scp.path     = '~/backups'
+    end
+
+    scp = Backup::Storage::SCP.new do |scp|
+      scp.password = 'my_password'
+      scp.ip       = '123.45.678.90'
+    end
+
+    scp.username.should == 'my_default_username'
+    scp.password.should == 'my_password'
+    scp.ip.should       == '123.45.678.90'
+    scp.port.should     == 22
+  end
+
+  it 'should have its own defaults' do
+    scp = Backup::Storage::SCP.new
+    scp.port.should == 22
+    scp.path.should == 'backups'
+  end
+
+  describe '#connection' do
+    it 'should establish a connection to the remote server using the provided ip address and credentials' do
+      Net::SSH.expects(:start).with('123.45.678.90', 'my_username', :password => 'my_password', :port => 22)
+      scp.send(:connection)
+    end
+  end
+
+  describe '#transfer!' do
+    let(:connection) { mock('Net::SCP') }
+
+    before do
+      Net::SSH.stubs(:start).returns(connection)
+      scp.stubs(:create_remote_directories!)
+      Backup::Logger.stubs(:message)
+    end
+
+    it 'should transfer the provided file to the path' do
+      Backup::Model.new('blah', 'blah') {}
+      file = mock("Backup::Storage::SCP::File")
+
+      scp.expects(:create_remote_directories!)
+
+      ssh_scp = mock('Net::SSH::SCP')
+      connection.expects(:scp).returns(ssh_scp)
+
+      ssh_scp.expects(:upload!).with(
+        File.join(Backup::TMP_PATH, "#{ Backup::TIME }.#{ Backup::TRIGGER }.tar"),
+        File.join('backups/myapp', "#{ Backup::TIME }.#{ Backup::TRIGGER }.tar")
+      )
+
+      scp.send(:transfer!)
+    end
+  end
+
+  describe '#remove!' do
+    let(:connection) { mock('Net::SCP') }
+
+    before do
+      Net::SSH.stubs(:start).returns(connection)
+    end
+
+    it 'should remove the file from the remote server path' do
+      connection.expects(:exec!).with("rm backups/myapp/#{ Backup::TIME }.#{ Backup::TRIGGER }.tar")
+      scp.send(:remove!)
+    end
+  end
+
+  describe '#create_remote_directories!' do
+    let(:connection) { mock('Net::SSH') }
+
+    before do
+      Net::SSH.stubs(:start).returns(connection)
+    end
+
+    it 'should properly create remote directories one by one' do
+      scp.path = 'backups/some_other_folder/another_folder'
+
+      connection.expects(:exec!).with("mkdir 'backups'")
+      connection.expects(:exec!).with("mkdir 'backups/some_other_folder'")
+      connection.expects(:exec!).with("mkdir 'backups/some_other_folder/another_folder'")
+      connection.expects(:exec!).with("mkdir 'backups/some_other_folder/another_folder/myapp'")
+
+      scp.send(:create_remote_directories!)
+    end
+  end
+
+  describe '#perform' do
+    it 'should invoke transfer! and cycle!' do
+      scp.expects(:transfer!)
+      scp.expects(:cycle!)
+      scp.perform!
+    end
+  end
+
+end

data/spec/storage/sftp_spec.rb

@@ -0,0 +1,125 @@
+# encoding: utf-8
+
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Backup::Storage::SFTP do
+
+  let(:sftp) do
+    Backup::Storage::SFTP.new do |sftp|
+      sftp.username  = 'my_username'
+      sftp.password  = 'my_password'
+      sftp.ip        = '123.45.678.90'
+      sftp.port      = 22
+      sftp.path      = '~/backups/'
+      sftp.keep      = 20
+    end
+  end
+
+  before do
+    Backup::Configuration::Storage::SFTP.clear_defaults!
+  end
+
+  it 'should have defined the configuration properly' do
+    sftp.username.should == 'my_username'
+    sftp.password.should == 'my_password'
+    sftp.ip.should       == '123.45.678.90'
+    sftp.port.should     == 22
+    sftp.path.should     == 'backups/'
+    sftp.keep.should     == 20
+  end
+
+  it 'should use the defaults if a particular attribute has not been defined' do
+    Backup::Configuration::Storage::SFTP.defaults do |sftp|
+      sftp.username = 'my_default_username'
+      sftp.password = 'my_default_password'
+      sftp.path     = '~/backups'
+    end
+
+    sftp = Backup::Storage::SFTP.new do |sftp|
+      sftp.password = 'my_password'
+      sftp.ip       = '123.45.678.90'
+    end
+
+    sftp.username.should == 'my_default_username'
+    sftp.password.should == 'my_password'
+    sftp.ip.should       == '123.45.678.90'
+    sftp.port.should     == 22
+  end
+
+  it 'should have its own defaults' do
+    sftp = Backup::Storage::SFTP.new
+    sftp.port.should == 22
+    sftp.path.should == 'backups'
+  end
+
+  describe '#connection' do
+    it 'should establish a connection to the remote server using the provided ip address and credentials' do
+      Net::SFTP.expects(:start).with('123.45.678.90', 'my_username', :password => 'my_password', :port => 22)
+      sftp.send(:connection)
+    end
+  end
+
+  describe '#transfer!' do
+    let(:connection) { mock('Fog::Storage') }
+
+    before do
+      Net::SFTP.stubs(:start).returns(connection)
+      sftp.stubs(:create_remote_directories!)
+      Backup::Logger.stubs(:message)
+    end
+
+    it 'should transfer the provided file to the path' do
+      Backup::Model.new('blah', 'blah') {}
+      file = mock("Backup::Storage::SFTP::File")
+
+      sftp.expects(:create_remote_directories!)
+      connection.expects(:upload!).with(
+        File.join(Backup::TMP_PATH, "#{ Backup::TIME }.#{ Backup::TRIGGER }.tar"),
+        File.join('backups/myapp', "#{ Backup::TIME }.#{ Backup::TRIGGER }.tar")
+      )
+
+      sftp.send(:transfer!)
+    end
+  end
+
+  describe '#remove!' do
+    let(:connection) { mock('Net::SFTP') }
+
+    before do
+      Net::SFTP.stubs(:start).returns(connection)
+    end
+
+    it 'should remove the file from the remote server path' do
+      connection.expects(:remove!).with("backups/myapp/#{ Backup::TIME }.#{ Backup::TRIGGER }.tar")
+      sftp.send(:remove!)
+    end
+  end
+
+  describe '#create_remote_directories!' do
+    let(:connection) { mock('Net::SFTP') }
+
+    before do
+      Net::SFTP.stubs(:start).returns(connection)
+    end
+
+    it 'should properly create remote directories one by one' do
+      sftp.path = 'backups/some_other_folder/another_folder'
+
+      connection.expects(:mkdir!).with('backups')
+      connection.expects(:mkdir!).with('backups/some_other_folder')
+      connection.expects(:mkdir!).with('backups/some_other_folder/another_folder')
+      connection.expects(:mkdir!).with('backups/some_other_folder/another_folder/myapp')
+
+      sftp.send(:create_remote_directories!)
+    end
+  end
+
+  describe '#perform' do
+    it 'should invoke transfer! and cycle!' do
+      sftp.expects(:transfer!)
+      sftp.expects(:cycle!)
+      sftp.perform!
+    end
+  end
+
+end