schema-evolution-manager 0.9.57 → 0.9.58

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ece8bcecc0151f8979530da79102bdf066a3cc1dfae14cd07074c0ae497cee8f
-  data.tar.gz: e7af8d5f30e83690323fde18ed2cd78d0f557303545d30eb466e491c0748886f
+  metadata.gz: 5a59b34cee82db218b0008110f365a64567ec8dcbaa9f59a0fcd30acce9586f0
+  data.tar.gz: 5a6066de334be67b4915debfc0670e27c56d40eeb008c60bbc2348da8be37603
 SHA512:
-  metadata.gz: bdfa161a91f7c86f29ff39fe2fb339468b43fa02ece9139ceecd523e875408a2b4dcbf6b92204f43a0dbe353efcca2c77d4d6bfd1c174c15a09b51df5c5c551b
-  data.tar.gz: 5f593c267b185fdaf0dcf7bd3f31bddc0dc1bd099c245abcaf833cad29c10c7209487c24f0862b17ac09295c0d2c431ea0c5ef30db52d28816cfb183fb890a0c
+  metadata.gz: 21fe48093f5386013d3eed04dec8a9ebd512a670608a6b5a663b2c68c0b9af3fedb910577a58c3e3abe8098d3e66ac76cc25019cad0ebaa47e22014aa061c10c
+  data.tar.gz: 447e2949614cb4f2c332f317596195b796ff811016d8d6259b42a351e59b8a04c324b8bbb8bae3e8248b9a521bb3ba719db4d35676ea2ad1ebbc011ce6984caf

data/README.md

@@ -133,7 +133,7 @@ There are three ways to install schema evolution manager:
 
         git clone git@github.com:mbryzek/schema-evolution-manager.git
         cd schema-evolution-manager
-        git checkout 0.9.57
+        git checkout 0.9.58
         ruby ./configure.rb
         sudo ./install.rb
 

data/bin/sem-apply

@@ -34,6 +34,16 @@ begin
   if count == 0
     puts "  All scripts have been previously applied"
   end
+
+  version_file = "./VERSION"
+  if !util.dry_run? && File.exist?(version_file)
+    version = IO.read(version_file).strip
+    if !version.empty?
+      if SchemaEvolutionManager::Versions.new(db).record!(version)
+        puts "  Recorded schema version #{version}"
+      end
+    end
+  end
 rescue SchemaEvolutionManager::ScriptError => e
   puts ""
   puts "ERROR applying script: %s" % e.path

data/bin/sem-dist

@@ -55,6 +55,7 @@ else
   end
 end
 SchemaEvolutionManager::Library.git_assert_tag_exists(tag)
+SchemaEvolutionManager::Versions.validate_version!(tag)
 
 changes = SchemaEvolutionManager::Library.git_changes(:tag => tag)
 repo_path = SchemaEvolutionManager::Library.normalize_path(`pwd`.strip)
@@ -77,6 +78,7 @@ SchemaEvolutionManager::Library.with_temp_file do |tmp|
 
   SchemaEvolutionManager::Library.system_or_error("cp -R %s %s" % [File.join(repo_path, "scripts"), File.join(tmpdir, "scripts")])
   File.open(File.join(tmpdir, "CHANGES"), "w") { |out| out << changes }
+  File.open(File.join(tmpdir, "VERSION"), "w") { |out| out << tag }
 
   # Clear extended attributes to avoid tar warnings on Linux
   SchemaEvolutionManager::Library.system_or_error("xattr -cr #{tmpdir} 2>/dev/null || true")

data/bin/sem-info

@@ -17,6 +17,12 @@
 #    Output information on the next tag. Defaults to micro
 #    version increment from latest tag
 #
+#  sem-info db version --url <database url>
+#    Display the latest recorded deployed schema version
+#
+#  sem-info db scripts --url <database url>
+#    Display the applied script filenames
+#
 # Description
 #
 #   Utility script to pull information from the schema-evolution-manager
@@ -31,6 +37,9 @@ command = ARGV.shift.to_s.strip
 if command == "tag"
   puts SchemaEvolutionManager::SemInfo.tag(ARGV)
 
+elsif command == "db"
+  SchemaEvolutionManager::SemInfo.db(ARGV)
+
 elsif command == "version"
   puts SchemaEvolutionManager::SemInfo.version(ARGV)
 

data/lib/schema-evolution-manager/migration_file.rb

@@ -77,21 +77,22 @@ module SchemaEvolutionManager
     # -- sem.attribute.name = value
     #
     # and yields each matching row with |name, value|
+    #
+    # Read in binary mode so the shell locale (e.g. LANG=C in a minimal
+    # Docker image) cannot tag UTF-8 bytes as US-ASCII and cause String#strip
+    # to raise Encoding::CompatibilityError. Attribute lines are strict ASCII;
+    # scrubbing invalid bytes on non-attribute lines is harmless.
     def each_property
-      IO.readlines(path).each do |l|
-        begin
-          stripped = l.strip.encode("UTF-8")
-          if stripped.match(/^\-\-\s+sem\.attribute\./)
-            stripped.sub!(/^\-\-\s+sem\.attribute\./, '')
-            name, value = stripped.split(/\=/, 2).map(&:strip)
-            yield name, value
-          end
-        rescue Encoding::InvalidByteSequenceError
-          # Ignore - attributes must be in ascii
+      File.foreach(path, mode: "rb") do |raw|
+        line = raw.force_encoding("UTF-8")
+        line = line.scrub unless line.valid_encoding?
+        stripped = line.strip
+        if stripped.match(/^\-\-\s+sem\.attribute\./)
+          stripped.sub!(/^\-\-\s+sem\.attribute\./, '')
+          name, value = stripped.split(/\=/, 2).map(&:strip)
+          yield name, value
         end
       end
-    rescue Encoding::InvalidByteSequenceError
-      # Ignore - file must be in ascii in order to parse attributes
     end
 
   end

data/lib/schema-evolution-manager/scripts.rb

@@ -79,6 +79,16 @@ module SchemaEvolutionManager
       @db.psql_command(command)
     end
 
+    # Returns the sorted list of filenames already applied to this database.
+    def applied
+      if @db.schema_schema_evolution_manager_exists?
+        sql = "select filename from %s.%s order by filename" % [Db.schema_name, @table_name]
+        @db.psql_command(sql).strip.split
+      else
+        []
+      end
+    end
+
     private
     # Fetch the list of scripts that have already been applied to this
     # database.

data/lib/schema-evolution-manager/sem_info.rb

@@ -6,6 +6,32 @@ module SchemaEvolutionManager
       SchemaEvolutionManager::SemVersion::VERSION.dup
     end
 
+    def SemInfo.db(args)
+      valid = ['version', 'scripts']
+      subcommand = args.shift.to_s.strip
+
+      if !valid.include?(subcommand)
+        if subcommand.empty?
+          puts "ERROR: Missing db subcommand. Must be one of: %s" % valid.join(", ")
+        else
+          puts "ERROR: Invalid db subcommand[%s]. Must be one of: %s" % [subcommand, valid.join(", ")]
+        end
+        exit(4)
+      end
+
+      db_args = SchemaEvolutionManager::Args.new(args.join(" "), :optional => ['url', 'host', 'user', 'name', 'port', 'set'])
+      db = SchemaEvolutionManager::Db.from_args(db_args)
+
+      if subcommand == "version"
+        version = SchemaEvolutionManager::Versions.new(db).latest
+        puts version unless version.nil?
+      elsif subcommand == "scripts"
+        SchemaEvolutionManager::Scripts.new(db, SchemaEvolutionManager::Scripts::SCRIPTS).applied.each do |filename|
+          puts filename
+        end
+      end
+    end
+
     def SemInfo.tag(args)
       valid = ['exists', 'latest', 'next']
 

data/lib/schema-evolution-manager/versions.rb

@@ -0,0 +1,62 @@
+module SchemaEvolutionManager
+
+  # Records and reads the released repository version applied to a database.
+  # The version is written at apply time and the latest row (max id) is the
+  # deployed schema version.
+  class Versions
+
+    if !defined?(MAX_VERSION_LENGTH)
+      MAX_VERSION_LENGTH = 100
+    end
+
+    # Validates a version string. Raises RuntimeError with an actionable
+    # message if invalid; returns the version if valid.
+    def Versions.validate_version!(version)
+      Preconditions.assert_class(version, String)
+      stripped = version.strip
+      if stripped.empty?
+        raise "Version cannot be blank"
+      end
+      if stripped.length > MAX_VERSION_LENGTH
+        raise "Version '%s' is %d chars; max %d" % [stripped, stripped.length, MAX_VERSION_LENGTH]
+      end
+      # Strict whitelist: letters, digits, and . _ + - only. Covers semver
+      # (including pre-release/build metadata) and rejects anything unsafe
+      # (whitespace, quotes, SQL metacharacters, etc.).
+      unless stripped.match(/\A[A-Za-z0-9._+-]+\z/)
+        raise "Version '%s' is invalid; only letters, digits, and . _ + - are allowed" % stripped
+      end
+      stripped
+    end
+
+    def initialize(db)
+      @db = Preconditions.assert_class(db, Db)
+    end
+
+    # Inserts the version only if it differs from the latest recorded value.
+    # Returns true if a row was inserted, false if unchanged.
+    def record!(version)
+      clean = Versions.validate_version!(version)
+      return false if latest == clean
+      @db.psql_command("insert into %s.versions (version) values ('%s')" % [Db.schema_name, clean])
+      true
+    end
+
+    # Latest recorded version, or nil if none recorded / table absent.
+    def latest
+      return nil unless versions_table_exists?
+      value = @db.psql_command("select version from %s.versions order by id desc limit 1" % Db.schema_name).strip
+      value.empty? ? nil : value
+    end
+
+    private
+
+    def versions_table_exists?
+      return false unless @db.schema_schema_evolution_manager_exists?
+      sql = "select count(*) from information_schema.tables where table_schema = '%s' and table_name = 'versions'" % Db.schema_name
+      @db.psql_command(sql).to_i > 0
+    end
+
+  end
+
+end

data/lib/schema-evolution-manager.rb

@@ -18,6 +18,7 @@ load File.join(lib_dir, 'ask.rb')
 load File.join(lib_dir, 'version.rb')
 load File.join(lib_dir, 'args.rb')
 load File.join(lib_dir, 'scripts.rb')
+load File.join(lib_dir, 'versions.rb')
 load File.join(lib_dir, 'connection_data.rb')
 load File.join(lib_dir, 'db.rb')
 load File.join(lib_dir, 'apply_util.rb')

data/scripts/20260717-000000.sql

@@ -0,0 +1,27 @@
+-- Records the released repository version applied to this database. The latest
+-- row (max id) is the deployed schema version. Written at apply time by sem-apply
+-- from the VERSION file baked into the distribution by sem-dist.
+--
+-- Existence-guarded via to_regclass so the script is idempotent. The original
+-- table_exists() helper cannot be used here: it is dropped at the end of the
+-- first bootstrap script (scripts/20130318-105434.sql).
+
+set search_path to schema_evolution_manager;
+
+do $$
+begin
+  if to_regclass('schema_evolution_manager.versions') is null then
+
+    create table schema_evolution_manager.versions (
+      id           bigserial,
+      version      varchar(100) not null,
+      created_at   timestamp with time zone default now() not null
+    );
+
+    alter table schema_evolution_manager.versions add constraint versions_id_pk primary key(id);
+
+    comment on table schema_evolution_manager.versions is
+      'Records the released repository version applied to this database. Latest row (max id) is the deployed schema version.';
+
+  end if;
+end$$;

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: schema-evolution-manager
 version: !ruby/object:Gem::Version
-  version: 0.9.57
+  version: 0.9.58
 platform: ruby
 authors:
 - Michael Bryzek
 bindir: bin
 cert_chain: []
-date: 2025-12-11 00:00:00.000000000 Z
+date: 2026-07-17 00:00:00.000000000 Z
 dependencies: []
 description: '["Michael Bryzek"]'
 email: mbryzek@alum.mit.edu
@@ -48,8 +48,10 @@ files:
 - lib/schema-evolution-manager/sem_version.rb
 - lib/schema-evolution-manager/template.rb
 - lib/schema-evolution-manager/version.rb
+- lib/schema-evolution-manager/versions.rb
 - scripts/20130318-105434.sql
 - scripts/20130318-105456.sql
+- scripts/20260717-000000.sql
 - template/README.md
 - template/dev.rb
 homepage: https://github.com/gilt/schema-evolution-manager