semian-postgres 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4363cbe92367756e749732e77c206c2e270dfce1c076fa704eb3d4dfa32f7c06
+  data.tar.gz: bfec19a9865ea7b130564e88242b302d0dc67d8b68bbd685534cac92a2416281
+SHA512:
+  metadata.gz: 9325b3f83bee8362219ba95a0d3bd0af58ca184797332bf44b2cf60e4e5e859b1c920d3bcf6015678cfd20617956d88321d1e426c0d999e79b0cd14f9ff69777
+  data.tar.gz: e29883327d72551ca75b6cd3d3c2c4e4b3170971e4f33bad9e722308e3011be048dbf4c7d0a4f06ce3e506d72b0c14aa5910aec84e058a91be9e7237a528599b

data/.dockerignore

@@ -0,0 +1,6 @@
+*
+!lib
+!.rubocop.yml
+!Gemfile*
+!Rakefile
+!semian-postgres.gemspec

data/.gitattributes

@@ -0,0 +1,3 @@
+Gemfile.lock linguist-generated=true
+*.gemfile.lock linguist-generated=true
+*.gemfile linguist-language=ruby

data/.github/.dependabot.yml

@@ -0,0 +1,14 @@
+---
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: daily
+  - package-ecosystem: bundler
+    directory: /
+    open-pull-requests-limit: 10
+    insecure-external-code-execution: allow
+    registries: "*"
+    schedule:
+      interval: dails

data/.github/workflows/ci.yml

@@ -0,0 +1,91 @@
+---
+name: Continuous Integration
+
+on:
+  push:
+    branches: main
+  pull_request:
+
+concurrency:
+  group: ${{ github.ref }}-bundle
+  cancel-in-progress: true
+
+jobs:
+  rubocop:
+    name: Rubocop
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ inputs.ruby }}
+          bundler-cache: true
+
+      - name: Run rubocop
+        run: |
+          bundle exec rubocop
+
+  yamllint:
+    name: 'Yamllint'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Yamllint
+        uses: karancode/yamllint-github-action@dd59165b84d90d37fc919c3c7dd84c7e37cd6bfb
+        with:
+          yamllint_comment: true
+        env:
+          GITHUB_ACCESS_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+  test:
+    name: Run specs
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ["2.7", "3.0", "3.1"]
+        postgres: ["9.6", "10", "11", "12", "13"]
+    runs-on: ubuntu-latest
+    container:
+      image: ruby:${{ matrix.ruby }}
+    services:
+      postgres:
+        image: postgres:${{ matrix.postgres }}
+        env:
+          POSTGRES_PASSWORD: password
+        options: >-
+          --health-cmd="pg_isready"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=5
+      toxiproxy:
+        image: ghcr.io/shopify/toxiproxy:2.5.0
+    env:
+      CI: "1"
+      PGHOST: "postgres"
+      PGUSER: "postgres"
+      PGPASSWORD: "password"
+      TOXIPROXY_HOST: "toxiproxy"
+      ImageOS: "ubuntu20"
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Cache
+        uses: actions/cache@v3
+        with:
+          path: vendor/bundle
+          key: ${{ runner.os }}-ruby-${{ matrix.ruby }}-gems-${{ hashFiles( format('{0}.lock', env.BUNDLE_GEMFILE) ) }}
+          restore-keys: |
+            ${{ runner.os }}-ruby-${{ matrix.ruby }}-gems-
+
+      - name: Bundle
+        run: |
+          bundle config path vendor/bundle
+          bundle install
+
+      - name: Run tests
+        run: |
+          bundle exec rspec

data/.github/workflows/release.yml

@@ -0,0 +1,54 @@
+---
+
+name: release-please
+
+on:
+  push:
+    branches: main
+
+env:
+  GEM_NAME: "semian-postgres"
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - uses: google-github-actions/release-please-action@v3
+        id: release
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          release-type: ruby
+          bump-minor-pre-major: true
+          bump-patch-for-minor-pre-major: true
+          prerelease: true
+          package-name: ${{ env.GEM_NAME }}
+          version-file: "lib/semian/pg/version.rb"
+          command: "github-release"
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+        if: ${{ steps.release.outputs.release_created }}
+
+      - name: Build gem
+        run: |
+          gem build ${{ env.GEM_NAME }}.gemspec -o ${{ env.GEM_NAME }}.gem
+        if: ${{ steps.release.outputs.release_created }}
+
+  release-pr:
+    runs-on: ubuntu-latest
+    needs:
+      - release-please
+    steps:
+      - uses: google-github-actions/release-please-action@v3
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          release-type: ruby
+          bump-minor-pre-major: true
+          bump-patch-for-minor-pre-major: true
+          package-name: ${{ env.GEM_NAME }}
+          version-file: "lib/semian/pg/version.rb"
+          command: "release-pr"

data/.gitignore

@@ -0,0 +1,31 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/tmp/
+
+Used by dotenv library to load environment variables.
+.env
+.idea
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# Gem packaging
+Gemfile.lock
+.ruby-gemset
+.rvmrc
+.DS_Store
+.rspec_status

data/.pre-commit-config.yaml

@@ -0,0 +1,16 @@
+---
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.3.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+  - repo: https://github.com/mattlqx/pre-commit-ruby
+    rev: v1.3.5
+    hooks:
+      - id: rubocop
+  - repo: https://github.com/adrienverge/yamllint.git
+    rev: v1.17.0
+    hooks:
+      - id: yamllint

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,26 @@
+---
+require:
+  - rubocop-rspec
+  - rubocop-rake
+
+AllCops:
+  NewCops: enable
+  TargetRubyVersion: 2.7
+
+Metrics/MethodLength:
+  Enabled: 50
+
+RSpec/MultipleExpectations:
+  Enabled: false
+
+RSpec/ExampleLength:
+  Enabled: 25
+
+RSpec/MultipleMemoizedHelpers:
+  Enabled: 10
+
+Layout/LineLength:
+  Enabled: 160
+
+RSpec/Capybara/FeatureMethods:
+  Enabled: false

data/.ruby-version

@@ -0,0 +1 @@
+3.1.2

data/.yamllint

@@ -0,0 +1,6 @@
+---
+extends: default
+rules:
+  line-length:
+    max: 120
+    level: warning

data/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## [0.1.1](https://github.com/mschoenlaub/semian-postgres/compare/v0.1.0...v0.1.1) (2022-10-31)
+
+
+### Bug Fixes
+
+* Fix repo URL in gemspec ([8b3e9b0](https://github.com/mschoenlaub/semian-postgres/commit/8b3e9b0aee2ef259ee2f1b0572ff5d561cf993fe))
+
+## 0.1.0 (2022-10-31)
+
+
+### Features
+
+* initial release ([74885ee](https://github.com/mschoenlaub/semian-postgres/commit/74885ee9b96a1cb42c7dbcb63730b8a68628dd5f))

data/Dockerfile

@@ -0,0 +1,20 @@
+ARG RUBY_VERSION=3.1.2
+FROM ruby:${RUBY_VERSION} as base
+
+# Avoid warnings by switching to noninteractive
+ENV DEBIAN_FRONTEND=noninteractive
+
+RUN apt-get update && apt-get install --no-install-recommends -y \
+      build-essential \
+      libssl-dev \
+      postgresql-client \
+      libpq-dev \
+      netcat \
+ && rm -rf /var/lib/apt/lists/* \
+ && gem install bundler
+
+WORKDIR /app
+COPY . .
+RUN chmod +x scripts/*.sh
+RUN bundle install
+CMD ["/bin/bash"]

data/Gemfile

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in semian-pg.gemspec
+gemspec
+
+gem 'rake', '~> 12.0'
+
+group :test do
+  gem 'rspec', '~> 3.0'
+  gem 'ruby-debug-ide', '~> 0.7.3'
+  gem 'timecop', '~> 0.9.1'
+  gem 'toxiproxy', '~> 2.0 '
+end
+
+group :lint do
+  gem 'rubocop', require: false
+  gem 'rubocop-rake', require: false
+  gem 'rubocop-rspec', require: false
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2022 Manuel Schönlaub
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,72 @@
+# semian-postgres
+
+This library provides a Postgres adapter for [Semian](https://github.com/Shopify/semian) by wrapping the [pg gem](https://rubygems.org/gems/pg)
+Semian is a resiliency toolkit for Ruby applications that provides a way to protect your application from external failures by limiting the number of resources that can be used at a time.
+You can read more about Semian [here](https://github.com/Shopify/semian)).
+
+## Usage
+
+Add the gem to your `Gemfile` and require it in your application.
+
+```ruby
+gem 'semian-pg', require: %w(semian semian/pg)
+```
+
+
+## Configuration
+
+The adapter is configured by a callback function, which would be ideally defined in some sort of initialization file.
+For Rails applications these would usually live in the `config/initializers/` directory.
+
+
+### Minimal example
+The following example configures an adapter to open the circuit after three unsuccessful
+connection attempts and close it after each successful attempt.
+
+Bulkheading is disabled, because this is not supported with servers that have a thread-oriented model, such as [Puma](https://github.com/puma/puma)
+
+```ruby
+require "semian"
+require "semian/postgres"
+
+SEMIAN_PARAMETERS = {
+  circuit_breaker: true,
+  success_threshold: 1,
+  error_threshold: 3,
+  error_timeout: 3,
+  bulkhead: false,
+}
+
+Semian::PG.semian_configuration = proc do |host, port|
+  if host == "localhost" && port == 5432
+    return SEMIAN_PARAMETERS
+  end
+end
+
+conn = PG.connect(host: "example.com", port: 5432)
+conn.exec("SELECT 1")
+```
+
+
+## Development
+Semian, and by extension semian-postgres, currently depends on Linux for **Bulkheading**.
+
+The development environment is based on `docker-compose`, spinning up containers for Postgres and Toxiproxy.
+Additionally a `dev` container is spun up. The `Gemfile` contains `ruby-debug-ide` to support remote debugging from the IDE.
+
+A typical development workflow would be to run the tests in the `dev` container
+```bash
+docker compose up -d
+docker compose exec dev bin/setup
+docker compose exec dev rake rubocop spec
+```
+
+
+## Contributing
+
+Bug reports and pull requests are welcome on [GitHub](https://github.com/mschoenlaub/semian-postgres).
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+
+RuboCop::RakeTask.new
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/bin/console

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'semian/pg'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/docker-compose.yml

@@ -0,0 +1,31 @@
+---
+version: "3.7"
+services:
+  dev:
+    environment:
+      DEBUG: "1"
+      PGHOST: "postgres"
+      PGUSER: "postgres"
+      PGPASSWORD: "password"
+      TOXIPROXY_HOST: "toxiproxy"
+    build:
+      context: ./
+      dockerfile: Dockerfile
+    container_name: semian-dev
+    volumes:
+      - .:/app
+    command:
+      - /bin/bash
+      - -c
+      - |
+        bundle install
+        sleep infinity
+  toxiproxy:
+    image: ghcr.io/shopify/toxiproxy:2.5.0
+    container_name: toxiproxy
+    depends_on:
+      - postgres
+  postgres:
+    image: postgres
+    environment:
+      POSTGRES_PASSWORD: password

data/lib/semian/pg/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Semian
+  module PG
+    VERSION = '0.1.1'
+  end
+end

data/lib/semian/pg.rb

@@ -0,0 +1,148 @@
+# frozen_string_literal: true
+
+require 'semian/pg/version'
+require 'semian/adapter'
+require 'pg'
+
+# We need to patch the actual pg gem to decorate the base errors such as PG::Error
+module PG
+  ::PG::Error.include(Semian::AdapterError)
+  ::PG::QueryCanceled.class_eval do
+    def marks_semian_circuits?
+      message != ~/canceling statement due to statement timeout/
+    end
+  end
+
+  # This allows us to use semian as a drop-in replacement.
+  class SemianError < PG::Error
+    def initialize(semian_identifier, *args)
+      super(*args)
+      @semian_identifier = semian_identifier
+    end
+  end
+
+  ResourceBusyError = Class.new(SemianError)
+  CircuitOpenError = Class.new(SemianError)
+end
+
+module Semian
+  # The adapter wraps the PG::Connection class and implements the methods for resource acquisition.
+  module PG
+    include Semian::Adapter
+
+    ResourceBusyError = ::PG::ResourceBusyError
+    CircuitOpenError = ::PG::CircuitOpenError
+
+    # This error is raised when the configuration hook is modified more than once.
+    class ConfigurationChangedError < RuntimeError
+      def initialize(msg = 'Cannot re-initialize semian_configuration')
+        super
+      end
+    end
+
+    class << self
+      attr_accessor :exceptions
+      attr_reader :semian_configuration
+
+      def semian_configuration=(configuration)
+        raise ConfigurationChangedError unless @semian_configuration.nil?
+
+        @semian_configuration = configuration
+      end
+
+      def retrieve_semian_configuration(host, port)
+        @semian_configuration.call(host, port) if @semian_configuration.respond_to?(:call)
+      end
+    end
+
+    def conninfo_hash
+      h = super
+      h.merge!(connect_timeout: @connect_timeout) if @connect_timeout
+      h
+    end
+
+    def semian_identifier
+      @semian_identifier ||= "pg_#{raw_semian_options[:name]}" if raw_semian_options && raw_semian_options[:name]
+      @semian_identifier ||= "pg_#{@iopts[:host]}:#{@iopts[:port]}"
+    end
+
+    def raw_semian_options
+      @raw_semian_options ||= begin
+        @raw_semian_options = Semian::PG.retrieve_semian_configuration(@iopts[:host], @iopts[:port])
+        @raw_semian_options = @raw_semian_options.dup unless @raw_semian_options.nil?
+      end
+    end
+
+    def disabled?
+      raw_semian_options.nil?
+    end
+
+    def resource_exceptions
+      [::PG::ConnectionBad, ::PG::QueryCanceled].freeze
+    end
+
+    def async_connect_or_reset(*args)
+      acquire_semian_resource(adapter: :pg, scope: :connection) do
+        super
+      end
+    end
+
+    QUERY_WHITELIST = Regexp.union(
+      %r{\A(?:/\*.*?\*/)?\s*ROLLBACK}i,
+      %r{\A(?:/\*.*?\*/)?\s*COMMIT}i,
+      %r{\A(?:/\*.*?\*/)?\s*RELEASE\s+SAVEPOINT}i
+    )
+
+    QUERY_METHODS = %i[query exec exec_params].freeze
+
+    def query_whitelisted?(sql)
+      QUERY_WHITELIST =~ sql
+    rescue ArgumentError
+      return false unless sql.valid_encoding?
+
+      raise
+    end
+
+    QUERY_METHODS.each do |method|
+      define_method(method) do |*args|
+        return super(*args) if query_whitelisted?(args[0])
+
+        acquire_semian_resource(adapter: :pg, scope: :query) do
+          super(*args)
+        end
+      end
+    end
+
+    def with_resource_timeout(temp_timeout)
+      prev_conn_timeout = conninfo_hash[:connect_timeout]
+      begin
+        @connect_timeout = temp_timeout
+        yield
+      ensure
+        @connect_timeout = prev_conn_timeout
+      end
+    end
+
+    # The pg gem defines some necessary methods on class level, which is why we have to hook into them.
+    module ClassMethods
+      def connect_start(*args)
+        conn = super
+        conn.instance_variable_set(:@iopts, _iopts(*args))
+        conn
+      end
+
+      private
+
+      def _iopts(*args)  # rubocop:disable Metrics/AbcSize
+        option_string = parse_connect_args(*args)
+        iopts = conninfo_parse(option_string).each_with_object({}) do |h, o|
+          o[h[:keyword].to_sym] = h[:val] if h[:val]
+        end
+        conndefaults.each_with_object({}) { |h, o| o[h[:keyword].to_sym] = h[:val] if h[:val] }.merge(iopts)
+      end
+    end
+  end
+end
+
+::PG::Connection.prepend(Semian::PG)
+::PG::Connection.singleton_class.prepend(Semian::PG::ClassMethods)

data/semian-postgres.gemspec

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require_relative 'lib/semian/pg/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'semian-postgres'
+  spec.version = Semian::PG::VERSION
+  spec.homepage = 'https://github.com/mschoenlaub/semian-postgres'
+  spec.authors = ['Manuel Schönlaub']
+  spec.email = ['manuel.schonlaub@prodigygame.com']
+
+  spec.summary = 'Semian adapter for Postgres'
+  spec.license = 'MIT'
+  spec.required_ruby_version = Gem::Requirement.new('>=2.7.0')
+
+  spec.add_runtime_dependency 'pg', '~> 1.4.0'
+  spec.add_runtime_dependency 'semian', '~> 0.16.0'
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = spec.homepage
+  spec.metadata['changelog_uri'] = "#{spec.homepage}/main/CHANGELOG.md"
+
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.require_paths = ['lib']
+  spec.metadata['rubygems_mfa_required'] = 'true'
+end

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification
+name: semian-postgres
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Manuel Schönlaub
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2022-10-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pg
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.4.0
+- !ruby/object:Gem::Dependency
+  name: semian
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.16.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.16.0
+description:
+email:
+- manuel.schonlaub@prodigygame.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".dockerignore"
+- ".gitattributes"
+- ".github/.dependabot.yml"
+- ".github/workflows/ci.yml"
+- ".github/workflows/release.yml"
+- ".gitignore"
+- ".pre-commit-config.yaml"
+- ".rspec"
+- ".rubocop.yml"
+- ".ruby-version"
+- ".yamllint"
+- CHANGELOG.md
+- Dockerfile
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- docker-compose.yml
+- lib/semian/pg.rb
+- lib/semian/pg/version.rb
+- semian-postgres.gemspec
+homepage: https://github.com/mschoenlaub/semian-postgres
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/mschoenlaub/semian-postgres
+  source_code_uri: https://github.com/mschoenlaub/semian-postgres
+  changelog_uri: https://github.com/mschoenlaub/semian-postgres/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.7
+signing_key:
+specification_version: 4
+summary: Semian adapter for Postgres
+test_files: []