db-postgres 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 658c98714a3d05cf5fd68a3ff400dd705129faa0bca69795438cf911779bb131
-  data.tar.gz: 70c142e7f0a9e38b89def7e5c09e18477dfd53ee8ba150f682c41d8d92030316
+  metadata.gz: dda5680ffcdd6de60c833681366779e9859e497ae9b367d3bcf3a84c68f15771
+  data.tar.gz: c9d19d688ed762c97539318765b149e477d47e0cf374b774810cd0cd830336ac
 SHA512:
-  metadata.gz: 6af540667a9ca3cf59229effef1ed44e36cc3e3a1ed4180b3a0d0a81bc3601ae365e8fc67c37e4b49b3a9802bbebb9615e4637cfc2349afdffe2543c752a4bdd
-  data.tar.gz: c72065aa005d7c5a546264a236f185ec0c113cba55e39ce9bbb3c7073de51d2e203521ce6354d88020cfa9adc3f59a24e91260738121d356dcb74fefad06f729
+  metadata.gz: a50d56b3495fa91827ff03e1cf9da2667819f3b23e982ed2619bf5633e53222fc09218e4526c3941ee906b65976c8d1796499405a4f2b85cf3cb3ccce20de58c
+  data.tar.gz: 68c172f739f907eca43c9270c9053ce1e0ab4d33da5c8dbcf75852e73bcb4da7d52233abcf44ef628afccfa011d2d8032391e17eec28a4a27eaacf0d59fc7c53

checksums.yaml.gz.sig

@@ -1,5 +1,2 @@
-�nj�\�qH�P�]O���Գ*�9�JW A�-�#�ǡ��OZ�E��{����fփr�1�8�c\���
Nq���-�;u
-`�F�
�>���҉^��Y�WL�4�,A+3J���-����$;0��]�T<�udi���=A�܉��b�`ڡlؑ��a3�
�x�_';i��5�j`�<�Q]%�nuj��z�o%2Ta�>�uD�]gb���,nj$���}��?�k�kKxDq�H�'w�0���s��	�ޗ���Ie;�~��&���`�Vav.�Q�\&`E��ʿ��i�J�@�w|��4��peŤ�Y�Z�Љ��W�\Qc�V��_��;��D�S��ܢ%	
-�Z�-ʆ��
-�
-d4�����N���3��"%ĩ��TuC�
+�_��N@Z o�3����C*ɡ�e\��o�'h}��<�a�n�316P�?�E#5��>z_��"��
+Ĭ9o%:�Fc>�������~�%~v�H9���eE2��u��+_�b��A�q��=O�������d�fۀ1��y�lA�̮�C$$�Lp���pŠu��
>CZ����z���?}�b� mx��W�cɄў#�Fp��_�;�^��Φ

data/context/getting-started.md

@@ -0,0 +1,37 @@
+# Getting Started
+
+This guide explains how to get started with the `db-postgres` gem.
+
+## Installation
+
+Add the gem to your project:
+
+~~~ bash
+$ bundle add db-postgres
+~~~
+
+## Usage
+
+Here is an example of the basic usage of the adapter:
+
+~~~ ruby
+require 'async'
+require 'db/postgres'
+
+# Create an event loop:
+Sync do
+	# Create the adapter and connect to the database:
+	adapter = DB::Postgres::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
+	# => [["PostgreSQL 16.3 on x86_64-pc-linux-gnu, compiled by gcc (GCC) 14.1.1 20240522, 64-bit"]]
+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: Ruby FFI bindings for libpq C interface.
+metadata:
+  documentation_uri: https://socketry.github.io/db-postgres/
+  funding_uri: https://github.com/sponsors/ioquatix
+  source_code_uri: https://github.com/socketry/db-postgres.git
+files:
+- path: getting-started.md
+  title: Getting Started
+  description: This guide explains how to get started with the `db-postgres` gem.

data/lib/db/postgres/connection.rb

@@ -4,6 +4,7 @@
 # Copyright, 2018-2024, by Samuel Williams.
 
 require 'async/pool/resource'
+require 'db/features'
 require_relative 'native/connection'
 
 module DB
@@ -104,6 +105,21 @@ module DB
 			def next_result
 				@native.next_result
 			end
+			
+			FEATURES = DB::Features.new(
+				alter_column_type: true,
+				using_clause: true,
+				conditional_operations: true,
+				transactional_schema: true,
+				batch_alter_table: true,
+				concurrent_schema: true,
+				serial_columns: true,
+			)
+			
+			# Database feature detection for migration and query building.
+			def features
+				FEATURES
+			end
 		end
 	end
 end

data/lib/db/postgres/version.rb

@@ -5,6 +5,6 @@
 
 module DB
 	module Postgres
-		VERSION = "0.8.0"
+		VERSION = "0.9.0"
 	end
 end

data/readme.md

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

data/releases.md

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

metadata

@@ -1,13 +1,12 @@
 --- !ruby/object:Gem::Specification
 name: db-postgres
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Samuel Williams
 - Aidan Samuel
 - Tony Schneider
-autorequire:
 bindir: bin
 cert_chain:
 - |
@@ -39,7 +38,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
@@ -55,6 +54,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: db
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
 - !ruby/object:Gem::Dependency
   name: ffi-native
   requirement: !ruby/object:Gem::Requirement
@@ -69,12 +82,12 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.4'
-description:
-email:
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- context/getting-started.md
+- context/index.yaml
 - lib/db/postgres.rb
 - lib/db/postgres/adapter.rb
 - lib/db/postgres/connection.rb
@@ -87,6 +100,7 @@ files:
 - lib/db/postgres/version.rb
 - license.md
 - readme.md
+- releases.md
 homepage: https://github.com/socketry/db-postgres
 licenses:
 - MIT
@@ -94,7 +108,6 @@ metadata:
   documentation_uri: https://socketry.github.io/db-postgres/
   funding_uri: https://github.com/sponsors/ioquatix
   source_code_uri: https://github.com/socketry/db-postgres.git
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -102,15 +115,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: 3.6.9
 specification_version: 4
 summary: Ruby FFI bindings for libpq C interface.
 test_files: []