db-mariadb 0.11.2 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 95566c6a63ab1bf4652c2cb71c01f9617f8ad942c30ec033537cd644f119927e
-  data.tar.gz: 0c5ea74e6b1230c6ad49dad343342553bebba46ef9bb032dae0088c3d13891ba
+  metadata.gz: be804b294c1772c8839f21044deec4b397dea3b7c2212587839f64ee038d9a92
+  data.tar.gz: 19c7766d192dbe9443ef4fa0acd1dbf90be1b9d925084617603b347fbfb6095b
 SHA512:
-  metadata.gz: 6eebe56df786458477e5d822335f56754c0074e11996d9aca17e24ee9bd2b88571e65fdc051df3290f8dff4e4c3b45aaf1973f7fa29f969985f58aa7d7efbc03
-  data.tar.gz: 65fef4dcfa24803c438b506c10cf9e45b66acd341f7bf2c6d5bc4b83a4964d6ff38037e18910ddfe2b915ec209ab3f0fb621276bf42220192c8f729f7f13e941
+  metadata.gz: 82bb2012e7e245ccca60f022e55754ad05707b3c4f37432db124ba39b8c208793028964295bedd445b8905fc929abeb219575e3693870d65fd1b418592bb2f7c
+  data.tar.gz: f8f6b604648f295a6778a1ff923737a4d8278c4711b7977265509e36a4194cdd2155fec3ebfce4a01b19eb95fa2720f350e0e7739e35a0e5d68e6dfce762286e

data/context/getting-started.md

@@ -0,0 +1,37 @@
+# Getting Started
+
+This guide explains how to get started with the `db-mariadb` gem.
+
+## Installation
+
+Add the gem to your project:
+
+~~~ bash
+$ bundle add db-mariadb
+~~~
+
+## Usage
+
+Here is an example of the basic usage of the adapter:
+
+~~~ ruby
+require 'async'
+require 'db/mariadb'
+
+# Create an event loop:
+Sync do
+	# Create the adapter and connect to the database:
+	adapter = DB::MariaDB::Adapter.new(database: 'test')
+	connection = adapter.call
+	
+	# Execute the query:
+	result = connection.send_query("SELECT VERSION()")
+	
+	# Get the results:
+	pp connection.next_result.to_a
+	# => [["10.4.13-MariaDB"]]
+ensure
+	# Return the connection to the client connection pool:
+	connection.close
+end
+~~~

data/context/index.yaml

@@ -0,0 +1,12 @@
+# Automatically generated context index for Utopia::Project guides.
+# Do not edit then files in this directory directly, instead edit the guides and then run `bake utopia:project:agent:context:update`.
+---
+description: An event-driven interface for MariaDB and MySQL servers.
+metadata:
+  documentation_uri: https://socketry.github.io/db-mariadb/
+  funding_uri: https://github.com/sponsors/ioquatix
+  source_code_uri: https://github.com/socketry/db-mariadb.git
+files:
+- path: getting-started.md
+  title: Getting Started
+  description: This guide explains how to get started with the `db-mariadb` gem.

data/lib/db/mariadb/adapter.rb

@@ -1,19 +1,25 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2020-2024, by Samuel Williams.
+# Copyright, 2020-2026, by Samuel Williams.
 
-require_relative 'connection'
+require_relative "connection"
 
 module DB
 	module MariaDB
+		# A database adapter for connecting to MariaDB and MySQL servers.
 		class Adapter
+			# Initialize a new adapter with connection options.
+			# @parameter options [Hash] Connection options to be passed to the connection.
 			def initialize(**options)
 				@options = options
 			end
 			
+			# @attribute [Hash] The connection options.
 			attr :options
 			
+			# Create a new database connection.
+			# @returns [Connection] A new connection instance.
 			def call
 				Connection.new(**@options)
 			end

data/lib/db/mariadb/connection.rb

@@ -1,52 +1,67 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2020-2024, by Samuel Williams.
+# Copyright, 2020-2026, by Samuel Williams.
 
-require 'async/pool/resource'
+require "async/pool/resource"
+require "db/features"
 
-require_relative 'native/connection'
+require_relative "native/connection"
 
 module DB
 	module MariaDB
-		# This implements the interface between the underyling native interface interface and "standardised" connection interface.
+		# A high-level database connection that implements the standardized connection interface.
+		# This class provides a bridge between the underlying native MariaDB interface and the DB gem's unified connection API.
 		class Connection < Async::Pool::Resource
+			# Initialize a new database connection.
+			# @parameter options [Hash] Connection options passed to the native connection.
 			def initialize(**options)
 				@native = Native::Connection.connect(**options)
 				
 				super()
 			end
 			
+			# Close the database connection and release resources.
 			def close
 				@native.close
 				
 				super
 			end
 			
+			# Get the type mapping for database types.
+			# @returns [Hash] The type mapping configuration.
 			def types
 				@native.types
 			end
 			
+			# Append an escaped string value to the buffer.
+			# @parameter value [String] The string value to escape and append.
+			# @parameter buffer [String] The buffer to append to.
+			# @returns [String] The buffer with the escaped string appended.
 			def append_string(value, buffer = String.new)
 				buffer << "'" << @native.escape(value) << "'"
 				
 				return buffer
 			end
 			
+			# Append a literal value to the buffer with appropriate formatting.
+			# @parameter value [Object] The value to append (supports Time, Date, Numeric, Boolean, nil, and strings).
+			# @parameter buffer [String] The buffer to append to.
+			# @returns [String] The buffer with the formatted value appended.
 			def append_literal(value, buffer = String.new)
 				case value
 				when Time, DateTime
-					append_string(value.utc.strftime('%Y-%m-%d %H:%M:%S'), buffer)
+					append_string(value.utc.strftime("%Y-%m-%d %H:%M:%S"), buffer)
 				when Date
-					append_string(value.strftime('%Y-%m-%d'), buffer)
+					append_string(value.strftime("%Y-%m-%d"), buffer)
 				when Numeric
 					buffer << value.to_s
 				when TrueClass
-					buffer << 'TRUE'
+					buffer << "TRUE"
 				when FalseClass
-					buffer << 'FALSE'
+					buffer << "FALSE"
 				when nil
-					buffer << 'NULL'
+					buffer << "NULL"
 				else
 					append_string(value, buffer)
 				end
@@ -54,12 +69,16 @@ module DB
 				return buffer
 			end
 			
+			# Append an escaped identifier to the buffer.
+			# @parameter value [String | Array(String)] The identifier or array of identifiers to escape.
+			# @parameter buffer [String] The buffer to append to.
+			# @returns [String] The buffer with the escaped identifier appended.
 			def append_identifier(value, buffer = String.new)
 				case value
 				when Array
 					first = true
 					value.each do |part|
-						buffer << '.' unless first
+						buffer << "." unless first
 						first = false
 						
 						buffer << escape_identifier(part)
@@ -71,7 +90,12 @@ module DB
 				return buffer
 			end
 			
-			def key_column(name = 'id', primary: true, null: false)
+			# Generate a key column definition for table creation.
+			# @parameter name [String] The column name.
+			# @parameter primary [Boolean] Whether this is a primary key column.
+			# @parameter null [Boolean] Whether this column allows null values.
+			# @returns [String] The column definition string.
+			def key_column(name = "id", primary: true, null: false)
 				buffer = String.new
 				
 				append_identifier(name, buffer)
@@ -87,20 +111,39 @@ module DB
 				return buffer
 			end
 			
+			# Get the current connection status.
+			# @returns [String] The status string from the server.
 			def status
 				@native.status
 			end
 			
+			# Send a query to the database server.
+			# @parameter statement [String] The SQL statement to execute.
 			def send_query(statement)
 				@native.discard_results
 				
 				@native.send_query(statement)
 			end
 			
+			# Get the next result set from a multi-result query.
+			# @returns [Native::Result | Nil] The next result set, or `nil` if no more results.
 			def next_result
 				@native.next_result
 			end
 			
+			FEATURES = DB::Features.new(
+				modify_column: true,
+				conditional_operations: true,
+				batch_alter_table: true,
+				auto_increment: true
+			)
+			
+			# Database feature detection for migration and query building.
+			# @returns [DB::Features] The supported database features.
+			def features
+				FEATURES
+			end
+			
 			protected
 			
 			def escape_identifier(value)

data/lib/db/mariadb/error.rb

@@ -5,6 +5,7 @@
 
 module DB
 	module MariaDB
+		# An error raised by the MariaDB adapter.
 		class Error < StandardError
 		end
 	end

data/lib/db/mariadb/native/connection.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2020-2024, by Samuel Williams.
+# Copyright, 2020-2026, by Samuel Williams.
 
-require_relative 'result'
-require_relative '../error'
+require_relative "result"
+require_relative "../error"
 
 module DB
 	module MariaDB
@@ -51,8 +51,22 @@ module DB
 			
 			ffi_attach_function :mysql_real_escape_string, [:pointer, :pointer, :string, :size_t], :size_t
 			
+			# A native FFI connection to the MariaDB/MySQL client library.
 			class Connection < FFI::Pointer
-				def self.connect(host: 'localhost', username: nil, password: nil, database: nil, port: 0, unix_socket: nil, client_flags: 0, compression: false, types: DEFAULT_TYPES, **options)
+				# Establish a connection to the MariaDB/MySQL server.
+				# @parameter host [String] The hostname or IP address to connect to.
+				# @parameter username [String | Nil] The username for authentication.
+				# @parameter password [String | Nil] The password for authentication.
+				# @parameter database [String | Nil] The database name to connect to.
+				# @parameter port [Integer] The port number to connect to.
+				# @parameter unix_socket [String | Nil] The Unix socket path for local connections.
+				# @parameter client_flags [Integer] Client connection flags.
+				# @parameter compression [Boolean] Whether to enable connection compression.
+				# @parameter types [Hash] Type mapping configuration.
+				# @parameter options [Hash] Additional connection options.
+				# @returns [Connection] A new connected instance.
+				# @raises [Error] If the connection fails.
+				def self.connect(host: "localhost", username: nil, password: nil, database: nil, port: 0, unix_socket: nil, client_flags: 0, compression: false, types: DEFAULT_TYPES, **options)
 					pointer = Native.mysql_init(nil)
 					Native.mysql_options(pointer, MYSQL_OPT_NONBLOCK, nil)
 					
@@ -93,6 +107,11 @@ module DB
 					return self.new(pointer, io, types, **options)
 				end
 				
+				# Initialize a native connection wrapper.
+				# @parameter address [FFI::Pointer] The pointer to the native connection.
+				# @parameter io [IO] The IO object for the socket.
+				# @parameter types [Hash] Type mapping configuration.
+				# @parameter options [Hash] Additional options.
 				def initialize(address, io, types, **options)
 					super(address)
 					
@@ -102,8 +121,11 @@ module DB
 					@types = types
 				end
 				
+				# @attribute [Hash] The type mapping configuration.
 				attr :types
 				
+				# Wait for the specified IO condition.
+				# @parameter status [Integer] The status flags indicating which IO condition to wait for.
 				def wait_for(status)
 					if status & MYSQL_WAIT_READ
 						@io.wait_readable
@@ -112,16 +134,22 @@ module DB
 					end
 				end
 				
+				# Check for errors and raise an exception if one occurred.
+				# @parameter message [String] The error message prefix.
+				# @raises [Error] If an error occurred.
 				def check_error!(message)
 					if Native.mysql_errno(self) != 0
 						raise Error, "#{message}: #{Native.mysql_error(self)}!"
 					end
 				end
 				
+				# Get the current connection status.
+				# @returns [String] The status string from the server.
 				def status
 					Native.mysql_stat(self)
 				end
 				
+				# Free the current result set.
 				def free_result
 					if @result
 						Native.mysql_free_result(@result)
@@ -130,6 +158,7 @@ module DB
 					end
 				end
 				
+				# Close the connection and release all resources.
 				def close
 					self.free_result
 					
@@ -138,6 +167,9 @@ module DB
 					@io.close
 				end
 				
+				# Escape a string value for safe inclusion in SQL queries.
+				# @parameter value [String] The value to escape.
+				# @returns [String] The escaped string.
 				def escape(value)
 					value = value.to_s
 					
@@ -149,6 +181,9 @@ module DB
 					return out.read_string
 				end
 				
+				# Send a query to the server for execution.
+				# @parameter statement [String] The SQL statement to execute.
+				# @raises [Error] If the query fails.
 				def send_query(statement)
 					self.free_result
 					
@@ -167,18 +202,23 @@ module DB
 					end
 				end
 				
-				# @returns [Boolean] If there are more results.
+				# Check if there are more result sets available.
+				# @returns [Boolean] True if there are more results.
 				def more_results?
 					Native.mysql_more_results(self) == 1
 				end
 				
+				# Get the next result set from a multi-result query.
+				# @parameter types [Hash] Type mapping to use for this result.
+				# @returns [Result | Nil] The next result set, or `nil` if no more results.
 				def next_result(types: @types)
 					if result = self.get_result
 						return Result.new(self, types, result)
 					end
 				end
 				
-				# Silently discard any results that application didn't read.
+				# Silently discard any results that the application did not read.
+				# @returns [Nil]
 				def discard_results
 					while result = self.get_result
 					end
@@ -186,14 +226,20 @@ module DB
 					return nil
 				end
 				
+				# Get the number of rows affected by the last query.
+				# @returns [Integer] The number of affected rows.
 				def affected_rows
 					Native.mysql_affected_rows(self)
 				end
 				
+				# Get the last auto-generated ID from an INSERT query.
+				# @returns [Integer] The last insert ID.
 				def insert_id
 					Native.mysql_insert_id(self)
 				end
 				
+				# Get information about the last query execution.
+				# @returns [String | Nil] Information string about the query.
 				def info
 					Native.mysql_info(self)
 				end

data/lib/db/mariadb/native/field.rb

@@ -1,14 +1,14 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2020-2024, by Samuel Williams.
+# Copyright, 2020-2026, by Samuel Williams.
 
-require_relative '../native'
+require_relative "../native"
 
-require_relative 'types'
+require_relative "types"
 
-require 'date'
-require 'json'
+require "date"
+require "json"
 
 module DB
 	module MariaDB
@@ -46,8 +46,8 @@ module DB
 			
 			DEFAULT_TYPES = {
 				# Pseudo types:
-				primary_key: Types::Integer.new('BIGINT AUTO_INCREMENT PRIMARY KEY'),
-				foreign_key: Types::Integer.new('BIGINT'),
+				primary_key: Types::Integer.new("BIGINT AUTO_INCREMENT PRIMARY KEY"),
+				foreign_key: Types::Integer.new("BIGINT"),
 				text: Types::Text.new("TEXT"),
 				string: Types::Text.new("VARCHAR(255)"),
 				
@@ -77,6 +77,7 @@ module DB
 				set: Types::Integer.new("SET"),
 			}
 			
+			# A field (column) in a result set with metadata and type information.
 			class Field < FFI::Struct
 				layout(
 					:name, :string,
@@ -102,14 +103,20 @@ module DB
 					:extension, :pointer,
 				)
 				
+				# Check if this field represents a boolean type.
+				# @returns [Boolean] True if the field is a boolean.
 				def boolean?
 					self[:length] == 1 && (self[:type] == :tiny || self[:type] == :long)
 				end
 				
+				# Get the field name.
+				# @returns [String] The field name.
 				def name
 					self[:name]
 				end
 				
+				# Get the field type, with boolean detection.
+				# @returns [Symbol] The field type.
 				def type
 					if boolean?
 						:boolean
@@ -118,6 +125,8 @@ module DB
 					end
 				end
 				
+				# Generate a string representation of the field.
+				# @returns [String] A human-readable representation.
 				def inspect
 					"\#<#{self.class} name=#{self.name} type=#{self.type} length=#{self[:length]}>"
 				end

data/lib/db/mariadb/native/result.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2020-2024, by Samuel Williams.
+# Copyright, 2020-2026, by Samuel Williams.
 
-require_relative 'field'
+require_relative "field"
 
 module DB
 	module MariaDB
@@ -16,7 +16,12 @@ module DB
 			
 			ffi_attach_function :mysql_fetch_fields, [:pointer], :pointer
 			
+			# A result set from a database query with row iteration and type casting.
 			class Result < FFI::Pointer
+				# Initialize a new result set wrapper.
+				# @parameter connection [Connection] The connection that produced this result.
+				# @parameter types [Hash] Type mapping for field conversion.
+				# @parameter address [FFI::Pointer] The pointer to the native result.
 				def initialize(connection, types = {}, address)
 					super(address)
 					
@@ -26,10 +31,14 @@ module DB
 					@casts = nil
 				end
 				
+				# Get the number of fields in this result set.
+				# @returns [Integer] The field count.
 				def field_count
 					Native.mysql_num_fields(self)
 				end
 				
+				# Get the field metadata for this result set.
+				# @returns [Array(Field)] The array of field objects.
 				def fields
 					unless @fields
 						pointer = Native.mysql_fetch_fields(self)
@@ -42,15 +51,21 @@ module DB
 					return @fields
 				end
 				
+				# Get the field names for this result set.
+				# @returns [Array(String)] The array of field names.
 				def field_names
 					fields.map(&:name)
 				end
 				
+				# Get the type converters for each field.
+				# @returns [Array] The array of type converter objects.
 				def field_types
 					fields.map{|field| @types[field.type]}
 				end
 				
+				# Get the number of rows in this result set.
 				# In the context of unbuffered queries, this is the number of rows that have been fetched so far.
+				# @returns [Integer] The row count.
 				def row_count
 					Native.mysql_num_rows(self)
 				end
@@ -58,6 +73,9 @@ module DB
 				alias count row_count
 				alias keys field_names
 				
+				# Cast row values to appropriate Ruby types.
+				# @parameter row [Array] The raw row data.
+				# @returns [Array] The row with values cast to proper types.
 				def cast!(row)
 					@casts ||= self.field_types
 					
@@ -70,6 +88,9 @@ module DB
 					return row
 				end
 				
+				# Iterate over each row in the result set.
+				# @yields {|row| ...} Each row as an array.
+				# 	@parameter row [Array] The current row data.
 				def each
 					row = FFI::MemoryPointer.new(:pointer)
 					field_count = self.field_count
@@ -95,6 +116,10 @@ module DB
 					@connection.check_error!("Reading recordset")
 				end
 				
+				# Map over each row in the result set.
+				# @yields {|row| ...} Each row as an array.
+				# 	@parameter row [Array] The current row data.
+				# @returns [Array] The mapped results.
 				def map(&block)
 					results = []
 					
@@ -105,6 +130,8 @@ module DB
 					return results
 				end
 				
+				# Convert the entire result set to an array.
+				# @returns [Array(Array)] All rows as arrays.
 				def to_a
 					rows = []
 					

data/lib/db/mariadb/native/types.rb

@@ -1,49 +1,70 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2020-2024, by Samuel Williams.
+# Copyright, 2020-2026, by Samuel Williams.
 
-require 'json'
-require 'bigdecimal'
+require "json"
+require "bigdecimal"
 
 module DB
 	module MariaDB
 		module Native
+			# Provides type converters for translating between MariaDB types and Ruby types.
 			module Types
+				# A text/string type converter.
 				class Text
+					# Initialize a text type converter.
+					# @parameter name [String] The SQL type name.
 					def initialize(name = "TEXT")
 						@name = name
 					end
 					
+					# @attribute [String] The SQL type name.
 					attr :name
 					
+					# Parse a string value from the database.
+					# @parameter string [String | Nil] The raw string value.
+					# @returns [String | Nil] The string value.
 					def parse(string)
 						string
 					end
 				end
 				
+				# An integer type converter.
 				class Integer
+					# Initialize an integer type converter.
+					# @parameter name [String] The SQL type name.
 					def initialize(name = "INTEGER")
 						@name = name
 					end
 					
+					# @attribute [String] The SQL type name.
 					attr :name
 					
+					# Parse an integer value from the database.
+					# @parameter string [String | Nil] The raw string value.
+					# @returns [Integer | Nil] The parsed integer.
 					def parse(string)
 						Integer(string) if string
 					end
 				end
 				
+				# A boolean type converter.
 				class Boolean
+					# Get the SQL type name for boolean.
+					# @returns [String] The type name.
 					def name
 						"BOOLEAN"
 					end
 					
+					# Parse a boolean value from the database.
+					# @parameter string [String | Nil] The raw string value.
+					# @returns [Boolean | Integer | Nil] The parsed boolean value.
 					def parse(string)
 						case string
-						when '0'
+						when "0"
 							false
-						when '1'
+						when "1"
 							true
 						when nil
 							nil
@@ -53,45 +74,71 @@ module DB
 					end
 				end
 				
+				# A decimal type converter.
 				class Decimal
+					# Get the SQL type name for decimal.
+					# @returns [String] The type name.
 					def name
 						"DECIMAL"
 					end
 					
+					# Parse a decimal value from the database.
+					# @parameter string [String | Nil] The raw string value.
+					# @returns [BigDecimal | Nil] The parsed decimal.
 					def parse(string)
 						BigDecimal(string) if string
 					end
 				end
 				
+				# A floating point type converter.
 				class Float
+					# Initialize a float type converter.
+					# @parameter name [String] The SQL type name.
 					def initialize(name = "FLOAT")
 						@name = name
 					end
 					
+					# @attribute [String] The SQL type name.
 					attr :name
 					
+					# Parse a float value from the database.
+					# @parameter string [String | Nil] The raw string value.
+					# @returns [Float | Nil] The parsed float.
 					def parse(string)
 						Float(string) if string
 					end
 				end
 				
+				# A symbol/enum type converter.
 				class Symbol
+					# Get the SQL type name for enum.
+					# @returns [String] The type name.
 					def name
 						"ENUM"
 					end
 					
+					# Parse a symbol value from the database.
+					# @parameter string [String | Nil] The raw string value.
+					# @returns [Symbol | Nil] The parsed symbol.
 					def parse(string)
 						string&.to_sym
 					end
 				end
 				
+				# A datetime type converter.
 				class DateTime
+					# Initialize a datetime type converter.
+					# @parameter name [String] The SQL type name.
 					def initialize(name = "DATETIME")
 						@name = name
 					end
 					
+					# @attribute [String] The SQL type name.
 					attr :name
 					
+					# Parse a datetime value from the database.
+					# @parameter string [String | Nil] The raw string value.
+					# @returns [Time | Nil] The parsed datetime as a UTC Time object.
 					def parse(string)
 						if string
 							parts = string.split(/[\-\s:]/)
@@ -101,11 +148,17 @@ module DB
 					end
 				end
 				
+				# A date type converter.
 				class Date
+					# Get the SQL type name for date.
+					# @returns [String] The type name.
 					def name
 						"DATE"
 					end
 					
+					# Parse a date value from the database.
+					# @parameter string [String | Nil] The raw string value.
+					# @returns [Time | Nil] The parsed date as a UTC Time object.
 					def parse(string)
 						if string
 							parts = string.split(/[\-\s:]/)
@@ -115,11 +168,17 @@ module DB
 					end
 				end
 				
+				# A JSON type converter.
 				class JSON
+					# Get the SQL type name for JSON.
+					# @returns [String] The type name.
 					def name
 						"JSON"
 					end
 					
+					# Parse a JSON value from the database.
+					# @parameter string [String | Nil] The raw string value.
+					# @returns [Hash | Array | Nil] The parsed JSON with symbolized keys.
 					def parse(string)
 						::JSON.parse(string, symbolize_names: true) if string
 					end

data/lib/db/mariadb/native.rb

@@ -1,19 +1,20 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2020-2024, by Samuel Williams.
+# Copyright, 2020-2026, by Samuel Williams.
 
-require 'ffi/module'
-require 'ffi/module/config_tool'
+require "ffi/native"
+require "ffi/native/config_tool"
 
 module DB
 	module MariaDB
+		# Provides FFI bindings to the native MariaDB/MySQL client library.
 		module Native
-			extend FFI::Module::Library
-			extend FFI::Module::Loader
-			extend FFI::Module::ConfigTool
+			extend FFI::Native::Library
+			extend FFI::Native::Loader
+			extend FFI::Native::ConfigTool
 			
-			ffi_load('mariadb') ||
+			ffi_load("mariadb") ||
 				ffi_load_using_config_tool(%w{mariadb_config --libs}) ||
 				ffi_load_using_config_tool(%w{mysql_config --libs}) ||
 				ffi_load_failure(<<~EOF)

data/lib/db/mariadb/version.rb

@@ -1,10 +1,12 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2020-2024, by Samuel Williams.
+# Copyright, 2020-2026, by Samuel Williams.
 
+# @namespace
 module DB
+	# @namespace
 	module MariaDB
-		VERSION = "0.11.2"
+		VERSION = "0.13.0"
 	end
 end

data/lib/db/mariadb.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2020-2024, by Samuel Williams.
+# Copyright, 2020-2026, by Samuel Williams.
 
-require_relative 'mariadb/native'
-require_relative 'mariadb/connection'
+require_relative "mariadb/native"
+require_relative "mariadb/connection"
 
-require_relative 'mariadb/adapter'
+require_relative "mariadb/adapter"
 
-require 'db/adapters'
+require "db/adapters"
 DB::Adapters.register(:mariadb, DB::MariaDB::Adapter)

data/license.md

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright, 2020-2024, by Samuel Williams.  
+Copyright, 2020-2026, by Samuel Williams.  
 Copyright, 2024, by Hal Brodigan.  
 
 Permission is hereby granted, free of charge, to any person obtaining a copy

data/readme.md

@@ -10,6 +10,14 @@ Please see the [project documentation](https://socketry.github.io/db-mariadb/) f
 
   - [Getting Started](https://socketry.github.io/db-mariadb/guides/getting-started/index) - This guide explains how to get started with the `db-mariadb` gem.
 
+## Releases
+
+Please see the [project releases](https://socketry.github.io/db-mariadb/releases/index) for all releases.
+
+### v0.12.0
+
+  - Add support for `DB::Features`.
+
 ## Contributing
 
 We welcome contributions to this project.

data/releases.md

@@ -0,0 +1,5 @@
+# Releases
+
+## v0.12.0
+
+  - Add support for `DB::Features`.

metadata

@@ -1,12 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: db-mariadb
 version: !ruby/object:Gem::Version
-  version: 0.11.2
+  version: 0.13.0
 platform: ruby
 authors:
 - Samuel Williams
 - Hal Brodigan
-autorequire:
 bindir: bin
 cert_chain:
 - |
@@ -38,7 +37,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-07-27 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async-pool
@@ -69,25 +68,39 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: ffi-module
+  name: db
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.0
+        version: '0.14'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.0
-description:
-email:
+        version: '0.14'
+- !ruby/object:Gem::Dependency
+  name: ffi-native
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.0
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- context/getting-started.md
+- context/index.yaml
 - lib/db/mariadb.rb
 - lib/db/mariadb/adapter.rb
 - lib/db/mariadb/connection.rb
@@ -100,6 +113,7 @@ files:
 - lib/db/mariadb/version.rb
 - license.md
 - readme.md
+- releases.md
 homepage: https://github.com/socketry/db-mariadb
 licenses:
 - MIT
@@ -107,7 +121,6 @@ metadata:
   documentation_uri: https://socketry.github.io/db-mariadb/
   funding_uri: https://github.com/sponsors/ioquatix
   source_code_uri: https://github.com/socketry/db-mariadb.git
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -115,15 +128,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
-signing_key:
+rubygems_version: 4.0.3
 specification_version: 4
 summary: An event-driven interface for MariaDB and MySQL servers.
 test_files: []