db 0.13.0 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 64a6f849cc021f19902e7aa339156fd839b6ee03f8bb481c66a86524cdd447d8
-  data.tar.gz: c4bd22be9d7cc9b9862682f0c10856cac5723f684daf426ecf60737124faa7cc
+  metadata.gz: e32753720467fe5085b599ca44812117efa453bbb6ae959e4bb8990cab6d4087
+  data.tar.gz: b3a6480f045f16d015c0d9b105e361b6eddbbff489a45ac3e9145a49011ea07e
 SHA512:
-  metadata.gz: 1bfa44a0456cca0c87a6f40349a7b7da597bdf53e1169aa0490532f98a90fad3179d562a1c3d5f40750888659ec705d4007984eebf9f1aa97be242918d4c66f9
-  data.tar.gz: 130a8e292f7f584da81fb8700071d35c0cda6cac8392ebe45e0b53f0527c5f26ab527db4aac3d01d9b051772d605175f27e32625a5d12a431fde19729d8bb8cd
+  metadata.gz: 78a879265c001e502faa4c8227a0f3457501bee7b55ac15eb4f7fe7ed267cdba0c476e411bc862dfe310b44d64fadcdb02f358fb0038f22fe3a56f4cb60c8ce9
+  data.tar.gz: 3b8be8be3b52d3f0d1b3cddbac2149e664a29fffed62d994eb8759f11ebb264df12ed6e620f8bf00da68ee1391c5486af59be0f5e6e274716408b585d89e1c74

data/lib/db/client.rb

@@ -25,6 +25,10 @@ module DB
 		
 		# Close all open connections in the connection pool.
 		def close
+			@pool.wait_until_free do
+				Console.warn(self) {"Waiting for #{@adapter} pool to drain: #{@pool}"}
+			end
+			
 			@pool.close
 		end
 		

data/lib/db/features.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2024, by Samuel Williams.
+
+module DB
+	# Standardized feature detection for database adapters.
+	# All features default to false, and adapters can enable specific capabilities.
+	class Features
+		def initialize(**features)
+			@features = features
+		end
+		
+		# Check if a specific feature is enabled.
+		def enabled?(feature)
+			@features.fetch(feature, false)
+		end
+		
+		# Get all enabled features.
+		def enabled_features
+			@features.select{|_, enabled| enabled}.keys
+		end
+		
+		# Create a new Features instance with additional or modified features.
+		def with(**additional_features)
+			self.class.new(**@features, **additional_features)
+		end
+		
+		# PostgreSQL-style column type modification: ALTER COLUMN name TYPE type USING expression.
+		def alter_column_type?
+			@features.fetch(:alter_column_type, false)
+		end
+		
+		# MySQL-style column modification: MODIFY COLUMN name type.
+		def modify_column?
+			@features.fetch(:modify_column, false)
+		end
+		
+		# Support for USING clause in column type changes.
+		def using_clause?
+			@features.fetch(:using_clause, false)
+		end
+		
+		# Support for IF EXISTS/IF NOT EXISTS clauses.
+		def conditional_operations?
+			@features.fetch(:conditional_operations, false)
+		end
+		
+		# Schema operations can be rolled back within transactions.
+		def transactional_schema?
+			@features.fetch(:transactional_schema, false)
+		end
+		
+		# Multiple operations can be combined in a single ALTER TABLE statement.
+		def batch_alter_table?
+			@features.fetch(:batch_alter_table, false)
+		end
+		
+		# Support for concurrent/online schema changes.
+		def concurrent_schema?
+			@features.fetch(:concurrent_schema, false)
+		end
+		
+		# Support for adding constraints with validation deferred.
+		def deferred_constraints?
+			@features.fetch(:deferred_constraints, false)
+		end
+		
+		# PostgreSQL-style SERIAL/BIGSERIAL auto-increment columns.
+		def serial_columns?
+			@features.fetch(:serial_columns, false)
+		end
+		
+		# MySQL-style AUTO_INCREMENT auto-increment columns.
+		def auto_increment?
+			@features.fetch(:auto_increment, false)
+		end
+		
+		# SQLite-style INTEGER PRIMARY KEY auto-increment.
+		def integer_primary_key_autoincrement?
+			@features.fetch(:integer_primary_key_autoincrement, false)
+		end
+		
+		# Support for IDENTITY columns (SQL Server/newer PostgreSQL).
+		def identity_columns?
+			@features.fetch(:identity_columns, false)
+		end
+	end
+end

data/lib/db/version.rb

@@ -5,5 +5,5 @@
 
 # @namespace
 module DB
-	VERSION = "0.13.0"
+	VERSION = "0.14.0"
 end

data/lib/db.rb

@@ -6,3 +6,4 @@
 require_relative "db/version"
 require_relative "db/adapters"
 require_relative "db/client"
+require_relative "db/features"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: db
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.14.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -66,6 +66,7 @@ files:
 - lib/db/client.rb
 - lib/db/context/session.rb
 - lib/db/context/transaction.rb
+- lib/db/features.rb
 - lib/db/query.rb
 - lib/db/records.rb
 - lib/db/version.rb