sack 1.0.2 → 1.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c2490d6fa06201302120d44d10dcb76b33dddb82
-  data.tar.gz: 86e72e9b5d1979e083b83df349fc2f724a225748
+  metadata.gz: 36631ab9960ab0352fc67299eb542d4c45ff7bea
+  data.tar.gz: 68295a9026aec98c51b35a6574608568510f22de
 SHA512:
-  metadata.gz: be1234cb58d2e5ab49090118fb8a53f6841f9073bf2cbe8462226579674a97025ea679aeaa2cb0c7b875dd96a117681205b5e65c54f9b78c1ce2dd57c83a5299
-  data.tar.gz: 7b58c7bbc84c2531e76f35b4b7fca2ff732db9443d027789b25186b5c94ac657a162ff06948a12cc0b526fa35db401f6078df9b0bf3c5a67999e3404acdab396
+  metadata.gz: eb2c612f125c841885c785f7ade20715d5afea212c3346a6b98c40499e758d2e2d145051ca57afc21d64f07eb5a1ab1ed2a3bec2a584cca5e941ad0609098d9a
+  data.tar.gz: 3580ba64a327c27972d694da5a7e7962967303a0507638b9286d689dc3fe3d768c3e2778d70df01bf0567d659fb20f86cab046b62c952f9c3532aaf9b443f6e1

data/README.md

@@ -286,6 +286,20 @@ module Bork
 end
 ```
 
+### Schema Migrations
+
+As your application evolves, your database schema may change over time.
+
+Unlike many popular frameworks, the concept of 'migrations' does not exist with Sack, at least not in the 'traditional' sense where one would create migration files describing changes to be applied in sequence.
+
+Sack will simply always try to keep your database up to date with your schema.
+Upon initialization, Sack verifies the database against the schema defined by your application. The migration policy is simple: _anything that is not present gets added_.
+
+New tables will be created, as well as new fields (columns) in already-existing tables.
+
+*HOWEVER* it must be noted that things only get +added+. Tables and fields are NEVER removed. Existing fields are NEVER modified.
+This keeps the concept of migration VERY simple.
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/lib/sack/database/data.rb

@@ -38,6 +38,14 @@ module Sack
 				@db.execute "create table #{Sanitizer.table @schema, name} (#{fq});"
 			end
 
+			# Alter Table:
+			# Adds missing fields to an already-existing table (ONLY adds, does not remove or modify existing fields).
+			# @param [Symbol] name Table name
+			# @param [Hash] fields A hash mapping of field names to type definition arrays (from _FTYPES_)
+			def alter_table name, fields
+				fields.each { |fname, ftype| @db.execute "alter table #{Sanitizer.table @schema, name} add #{Sanitizer.field_name fname} #{ftype.respond_to?(:each) ? ftype.collect { |e| FTYPES[Sanitizer.ftype e] }.join(' ') : FTYPES[Sanitizer.ftype ftype]};" rescue nil }
+			end
+
 			# Count:
 			# Counts the number of rows for a given table.
 			# @param [Symbol] table Table name

data/lib/sack/database.rb

@@ -72,14 +72,23 @@ module Sack
 		# Verify Schema:
 		# Verifies the supplied schema against the actual database & re-creates it if necessary.
 		def verify_schema
-			open { |data| rebuild_schema data unless @schema.keys.inject(true) { |a, table| a && (data.exec "select count(*) from #{table};" rescue nil) } }
+			open { |data| rebuild_schema data unless check_schema data }
+		end
+
+		# Check Schema:
+		# Verifies the supplied schema against the actual database.
+		# @param [Data] data Data access interface
+		# @return [Object] True if schema is valid, False otherwise
+		def check_schema data
+			@schema.keys.inject(true) { |a, table| a && (data.exec "select count(*) from #{table};" rescue nil) }
 		end
 
 		# Rebuild Schema:
 		# Re-creates the database according to the supplied schema.
 		# @param [Data] data Data access interface
 		def rebuild_schema data
-			@schema.each { |table, fields| data.create_table table, fields }
+			@schema.each { |table, fields| data.create_table table, fields rescue data.alter_table table, fields }
+			raise "Rebuilding Schema Failed - Check Database & Access Permissions" unless check_schema data
 		end
 
 		# Method Missing:

data/lib/sack/version.rb

@@ -5,5 +5,5 @@
 module Sack
 
 	# Version
-	VERSION = '1.0.2'
+	VERSION = '1.1.3'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sack
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.1.3
 platform: ruby
 authors:
 - Eresse
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-05-29 00:00:00.000000000 Z
+date: 2017-05-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler