pgtk 0.27.0 → 0.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 51f0c148d2990a05c012d2da4494bd303f333e428b7c188f9d3efe9a7ff6e078
-  data.tar.gz: 33a5d9b992f0bc16d70cd922a5e15c054f0643e5b376eb039c62d5c129ddada2
+  metadata.gz: 757b15a689138f24c6ede8c373da30e0dce065bced0be49ecc1cde717fa44498
+  data.tar.gz: b3d1f97cb77914eda80071362d7adbaf850e2b2db810b6cc3f6fdce6d1b51f69
 SHA512:
-  metadata.gz: 19539334e9bf2f48f5a3a640ab79cb6c737d2e6e7d21d03524c0146cb264f58197adf77cb04fcb4262e5ecc4eab4906f9000e279307a8321d16b7d26806152c3
-  data.tar.gz: 1eab8e38e7d81f9f8dd02e68f8afbc8489a7379f9ee8f74cafb8f9cf3a105b7d11af67204baf9fbe0e8ee3af438f6391aef4a46fb9a96a16e708975a55dbf977
+  metadata.gz: c2d377b1dc85c5d499665f6c57118b9c7373e8026e80eb0a21ef1a1ef5b2decffa80cdd2225f1a89cfe43e120d32f96cd64e047c841611883fc3f5dee7683284
+  data.tar.gz: 24f984d5f13d767514fd47b75920d3da94a0f6abfb4be0daf408d90846161a09c34b1607e4565a33ca3f3d5d61973496171d44f17eebab4aed50d558dd26628b

data/Gemfile.lock

@@ -52,7 +52,7 @@ GEM
     pg (1.6.2-x64-mingw-ucrt)
     pg (1.6.2-x86_64-linux)
     prism (1.6.0)
-    qbash (0.4.7)
+    qbash (0.4.8)
       backtrace (> 0)
       elapsed (> 0)
       loog (> 0)
@@ -102,7 +102,7 @@ GEM
     simplecov_json_formatter (0.1.4)
     slop (4.10.1)
     tago (0.4.0)
-    threads (0.4.1)
+    threads (0.5.0)
       backtrace (~> 0)
       concurrent-ruby (~> 1.0)
     timeout (0.4.4)

data/README.md

@@ -228,8 +228,8 @@ stash = Pgtk::Stash.new(
   cap: 10_000,          # Maximum cached query results (default: 10,000)
   cap_interval: 60,     # Seconds between cache size enforcement (default: 60)
   refill_interval: 16,  # Seconds between stale query refilling (default: 16)
-  refill_delay: 0.5,    # Seconds to wait before refilling the cache (default: 0)
-  retire: 60,           # Maximum age in seconds to keep a query in cache (default: 15 min)
+  refill_delay: 0.5,    # Seconds to wait before refilling the cache
+  retire: 60,           # Maximum age in seconds to keep a query in cache
   retire_interval: 5.5, # How often to retire (default: 60)
   threads: 4,           # Worker threads for background refilling (default: 4)
   max_queue_length: 128 # Maximum refilling tasks in queue (default: 128)

data/lib/pgtk/liquicheck_task.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: Copyright (c) 2019-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+require 'nokogiri'
+require 'rake/tasklib'
+require_relative '../pgtk'
+
+# Liquicheck rake task for check Liquibase XML files.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2019-2025 Yegor Bugayenko
+# License:: MIT
+class Pgtk::LiquicheckTask < Rake::TaskLib
+  # Task name
+  # @return [Symbol]
+  attr_accessor :name
+
+  # Base directory where Liquibase XML files will be stored
+  # @return [String]
+  attr_accessor :dir
+
+  # Migration XML files pattern
+  # @return [String]
+  attr_accessor :pattern
+
+  def initialize(*args, &task_block)
+    super()
+    @name = args.shift || :liquicheck
+    @dir = 'liquibase'
+    @pattern = '*/*.xml'
+    desc 'Check the quality of Liquibase XML files' unless ::Rake.application.last_description
+    task(name, *args) do |_, task_args|
+      RakeFileUtils.send(:verbose, true) do
+        yield(*[self, task_args].slice(0, task_block.arity)) if block_given?
+        run
+      end
+    end
+  end
+
+  private
+
+  def run
+    raise "Option 'dir' is mandatory" if !@dir || @dir.empty?
+    raise "Option 'pattern' is mandatory" if !@pattern || @pattern.empty?
+    errors = {}
+    Dir[File.join(File.expand_path(File.join(Dir.pwd, @dir)), @pattern)].each do |file|
+      doc = Nokogiri::XML(File.open(file))
+      doc.remove_namespaces!
+      path = doc.at_xpath('databaseChangeLog')&.attr('logicalFilePath')&.to_s
+      on(errors, file) do
+        must_have(path, 'logicalFilePath is empty')
+        must_equal(
+          path,
+          File.basename(file),
+          "logicalFilePath #{path.inspect} does not equal the xml file name #{File.basename(file).inspect}"
+        )
+      end
+      doc.xpath('databaseChangeLog/changeSet').each do |node|
+        id = node.attr('id')&.to_s
+        author = node.attr('author')&.to_s
+        context = node.attr('context')&.to_s
+        on(errors, file) do
+          must_have(id, 'ID is empty')
+          must_match(id, /[-a-z]+/, "ID #{id.inspect} has not suffix in #{context} context") if context
+        end
+        on(errors, file) do
+          must_have(author, 'author is empty')
+          must_match(
+            author,
+            /\A[-_ A-Za-z0-9]+\z/,
+            "author #{author.inspect} has illegal symbols"
+          )
+        end
+        on(errors, file) do
+          must_have(id, 'ID is empty')
+          must_have(path, 'logicalFilePath is empty')
+          must_match(
+            path.gsub(/[-_.a-z]/, ''),
+            /\A#{id.gsub(/[-a-z]/, '')}\z/,
+            "ID #{id.inspect} is not the beginning of a logicalFilePath #{path.inspect}"
+          )
+        end
+      end
+    end
+    return if errors.empty?
+    puts 'There are such errors in the Liquibase XML files.'
+    errors.each do |f, e|
+      puts "In file '#{f}':"
+      e.uniq.each do |msg|
+        puts "  * #{msg}"
+      end
+      puts
+    end
+    exit(1)
+  end
+
+  def on(errors, file, &)
+    yield if block_given?
+  rescue MustError => e
+    (errors[file] ||= []) << e.message
+  end
+
+  def must_have(prop, msg)
+    (raise MustError, msg) if prop.nil? || prop.empty?
+  end
+
+  def must_equal(lprop, rprop, msg)
+    (raise MustError, msg) if lprop != rprop
+  end
+
+  def must_match(prop, regex, msg)
+    (raise MustError, msg) unless prop.match?(regex)
+  end
+
+  MustError = Class.new(StandardError)
+  private_constant :MustError
+end

data/lib/pgtk/version.rb

@@ -11,5 +11,5 @@ require_relative '../pgtk'
 # License:: MIT
 module Pgtk
   # Current version of the library.
-  VERSION = '0.27.0'
+  VERSION = '0.28.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pgtk
 version: !ruby/object:Gem::Version
-  version: 0.27.0
+  version: 0.28.0
 platform: ruby
 authors:
 - Yegor Bugayenko
@@ -156,6 +156,7 @@ files:
 - lib/pgtk.rb
 - lib/pgtk/impatient.rb
 - lib/pgtk/liquibase_task.rb
+- lib/pgtk/liquicheck_task.rb
 - lib/pgtk/pgsql_task.rb
 - lib/pgtk/pool.rb
 - lib/pgtk/retry.rb