edb 0.1 → 0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 351f714ce71f151e1be9b4a0f87e31fae2eaa4f9
-  data.tar.gz: 2ede0d39dd74c3afd68e9be333acd57349f5838e
+  metadata.gz: f580ad47ecf9f08fcaea47a751ee8fa4e713cfc0
+  data.tar.gz: 8b61eba1dd93dcf190bbda91be07bf17b57fe1f3
 SHA512:
-  metadata.gz: 8ee4030d55177c90d045bd7a5573d0cab2edad8a33a9135c7a5e2cd253bf5557628b921d942048098b8f0d3ef1ace320378f281b68a0074d51077dc970fe68e9
-  data.tar.gz: a19d615b1664ed3c758bc555269c8414691ad10203c474255a9e7d18af8b5287ac9151bd49bccffc28d8dbce60985c3da31867c84bc09fdac588f07bac41d702
+  metadata.gz: b02a60eb7d3dc733544c70c4b687243df8fe7bb752b208254bfba4207748bdbc69abc7f9d7a4c9a092680bc20bdd59cbc45383a57ee326bdede89f79599f073e
+  data.tar.gz: 8cca6ca8141d811d340c2639406785ea86813f65efd11b2c4a6cf214a9d480498689bf1bda6f7395a4d83d40f89bfc579af481c6ba413caf2b7bc5173e65a5bd

data/.gitignore

@@ -0,0 +1,2 @@
+*.gem
+*2015

data/README.md

@@ -1,17 +1,20 @@
 # Backup, encrypt and manage your database
 
-*EDB* aims to be a framework to make and manage backups of your database.
-It is composed by three macro areas that reflect themself inside the `edb.yml` and are *DBMS*, *CRYPTOGRAPHY* and *STORAGE*.
-The first one is deals with the actual backup process of your favorite DBMS. The second one will eventually encrypt the backup compies made previously and the last one will be asked to storage the final output somewhere in the world.
-
-At the moment, we have just one module for each area: *PostgreSQL*, *AWS S3* and *AES-256-CBC*, but adding more modules require nothing but a new file inside the proper folder.
+*EDB* is a framework to make and manage backups of your database.
+It is composed by three macro areas that reflect themself inside `edb.yml` and are *DBMS*, *CRYPTOGRAPHY* and *STORAGE*.
+The first one deals with the actual backup process of your database. The second one will eventually encrypt the backup copies you made and the last one will copy them somewhere (S3 bucket, your local filesystem, etc.).
 
 ## Install
 `$ gem install edb`
 
 ## Run
-Setup `example/edb.yml` (remember also to change the `SECRET`) and then:
+Setup and customize `example/edb.yml` (remember also to change the `secret`) and then:
 
-`$ edb example/edb.yml`  
+`$ edb example/edb.yml`
 
 Consider also to add *EDB* to your cronjobs.
+
+## Available modules
+- *Cryptography*: `AES_256_CBC`
+- *DBMS*:         `PostgreSQL`, `MySQL`
+- *Storage*:      `S3`, `Filesystem`

data/example/edb.yml

@@ -1,13 +1,20 @@
 ---
 :DBMS:
   :PostgreSQL:
-    :binpath: '/Applications/Postgres.app/Contents/Versions/9.3/bin/'
-    :username: example
-    :password: 'pa$$w0rd'
-    :database: 'sample_database'
+    :binpath: /Applications/Postgres.app/Contents/Versions/9.3/bin
+    :username: username
+    :password: password
+    :database: sample_database
     :host: localhost
     :port: 5432
 
+  :MySQL:
+    :binpath: /Applications/MAMP/Library/bin
+    :username: username
+    :password: password
+    :database: sample_database
+    :host: localhost
+
 :CRYPTOGRAPHY:
   :AES_256_CBC:
     :secret: 0279x62O116Hn50016AGJE6D5De4gn4r
@@ -20,3 +27,6 @@
     :bucket:
       :main: backups
       :folder: sample-project
+
+  :Filesystem:
+    :path: ~/Downloads

data/lib/edb/dbms/mysql.rb

@@ -0,0 +1,44 @@
+#--
+# Copyright(C) 2015 Giovanni Capuano <webmaster@giovannicapuano.net>
+#
+# Redistribution and use in source and binary forms, with or without modification, are
+# permitted provided that the following conditions are met:
+#
+#    1. Redistributions of source code must retain the above copyright notice, this list of
+#       conditions and the following disclaimer.
+#
+# THIS SOFTWARE IS PROVIDED BY Giovanni Capuano ''AS IS'' AND ANY EXPRESS OR IMPLIED
+# WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+# FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL Giovanni Capuano OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+# ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+# The views and conclusions contained in the software and documentation are those of the
+# authors and should not be interpreted as representing official policies, either expressed
+# or implied, of Giovanni Capuano.
+#++
+
+module EDB
+  module DBMS
+    module MySQL
+      class << self
+        def backup(dir_name)
+          db    = ::EDB.opts[:DBMS][:MySQL]
+          files = {
+            dump: File.join(dir_name, "#{db[:database]}.sql")
+          }
+
+          ::EDB::Logger.log(:info, "Dumping #{db[:database]}...")
+          mysqldump = db[:binpath] && !db[:binpath].empty? ? File.join(db[:binpath], 'mysqldump') : 'mysqldump'
+          system "#{mysqldump} -u #{db[:username]} --password=#{db[:password]} --default-character-set=utf8 #{db[:database]} > #{files[:dump]}"
+
+          files.values
+        end
+      end
+    end
+  end
+end

data/lib/edb/dumper.rb

@@ -37,7 +37,10 @@ module EDB
         dbms_name = dbms[0]
 
         if EDB::DBMS.supports?(dbms_name)
-          files = EDB::DBMS.backup(dbms_name, @dir_name)
+          dir_name = File.join(@dir_name, dbms_name.to_s)
+          FileUtils.mkdir(dir_name) unless Dir.exists?(dir_name)
+
+          files = EDB::DBMS.backup(dbms_name, dir_name)
 
           if ::EDB.opts[:CRYPTOGRAPHY]
             ::EDB.opts[:CRYPTOGRAPHY].each do |method|

data/lib/edb/storage/filesystem.rb

@@ -0,0 +1,46 @@
+#--
+# Copyright(C) 2015 Giovanni Capuano <webmaster@giovannicapuano.net>
+#
+# Redistribution and use in source and binary forms, with or without modification, are
+# permitted provided that the following conditions are met:
+#
+#    1. Redistributions of source code must retain the above copyright notice, this list of
+#       conditions and the following disclaimer.
+#
+# THIS SOFTWARE IS PROVIDED BY Giovanni Capuano ''AS IS'' AND ANY EXPRESS OR IMPLIED
+# WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+# FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL Giovanni Capuano OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+# ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+# The views and conclusions contained in the software and documentation are those of the
+# authors and should not be interpreted as representing official policies, either expressed
+# or implied, of Giovanni Capuano.
+#++
+require 'fileutils'
+
+module EDB
+  module Storage
+    module Filesystem
+      class << self
+        def upload(source)
+          filesystem = ::EDB.opts[:STORAGE][:Filesystem]
+
+          path   = File.expand_path(filesystem[:path])
+          folder = source.split('/')[0..-2].join('/')
+          path   = File.join(path, folder)
+          ::EDB::Logger.log(:info, "Copying #{source} to #{path}...")
+
+          FileUtils.mkdir_p(path) unless Dir.exists?(path)
+
+          source = File.join('./', source)
+          FileUtils.cp_r(source, path)
+        end
+      end
+    end
+  end
+end

data/lib/edb/storage/s3.rb

@@ -29,7 +29,7 @@ module EDB
     module S3
       class << self
         def upload(source)
-          ::EDB::Logger.log(:info, "Uploading #{source}...")
+          ::EDB::Logger.log(:info, "Uploading #{source} to S3...")
 
           aws = ::EDB.opts[:STORAGE][:S3]
           AWS.config(aws)

data/lib/edb/version.rb

@@ -23,5 +23,5 @@
 #++
 
 module EDB
-  VERSION = '0.1'
+  VERSION = '0.2'
 end

metadata

@@ -1,24 +1,24 @@
 --- !ruby/object:Gem::Specification
 name: edb
 version: !ruby/object:Gem::Version
-  version: '0.1'
+  version: '0.2'
 platform: ruby
 authors:
 - Giovanni Capuano
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-06-24 00:00:00.000000000 Z
+date: 2015-08-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk
+  prerelease: false
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
         version: 1.59.1
   type: :runtime
-  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
@@ -31,6 +31,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".gitignore"
 - Gemfile
 - Gemfile.lock
 - README.md
@@ -42,11 +43,13 @@ files:
 - lib/edb/cryptography.rb
 - lib/edb/cryptography/aes_256_cbc.rb
 - lib/edb/dbms.rb
+- lib/edb/dbms/mysql.rb
 - lib/edb/dbms/postgresql.rb
 - lib/edb/dumper.rb
 - lib/edb/edb.rb
 - lib/edb/logger.rb
 - lib/edb/storage.rb
+- lib/edb/storage/filesystem.rb
 - lib/edb/storage/s3.rb
 - lib/edb/version.rb
 homepage: http://github.com/RoxasShadow/edb
@@ -69,7 +72,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5
+rubygems_version: 2.4.8
 signing_key: 
 specification_version: 4
 summary: A framework to make and manage backups of your database.