better_structure_sql 0.1.0

data/lib/better_structure_sql/configuration.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+module BetterStructureSql
+  # Configuration management for BetterStructureSql
+  #
+  # Provides centralized settings for dump behavior, feature toggles,
+  # file output options, and schema versioning settings.
+  class Configuration
+    attr_accessor :search_path,
+                  :replace_default_dump,
+                  :replace_default_load,
+                  :include_extensions,
+                  :include_functions,
+                  :include_triggers,
+                  :include_views,
+                  :include_materialized_views,
+                  :include_rules,
+                  :include_comments,
+                  :include_domains,
+                  :include_sequences,
+                  :include_custom_types,
+                  :enable_schema_versions,
+                  :schema_versions_limit,
+                  :schemas,
+                  :indent_size,
+                  :add_section_spacing,
+                  :sort_tables,
+                  :max_lines_per_file,
+                  :overflow_threshold,
+                  :generate_manifest,
+                  :adapter
+
+    attr_reader :output_path, :postgresql
+
+    # Sets the output path for schema dump
+    #
+    # @param value [String, Pathname] Path to output file or directory
+    # @return [String] The configured path as a string
+    def output_path=(value)
+      @output_path = value.to_s
+    end
+
+    def initialize
+      @output_path = 'db/structure.sql'
+      @search_path = '"$user", public'
+      @replace_default_dump = false
+      @replace_default_load = false
+      @include_extensions = true
+      @include_functions = true
+      @include_triggers = true
+      @include_views = true
+      @include_materialized_views = true
+      @include_rules = false
+      @include_comments = false
+      @include_domains = true
+      @include_sequences = true
+      @include_custom_types = true
+      @enable_schema_versions = false
+      @schema_versions_limit = 10
+      @schemas = ['public']
+      @indent_size = 2
+      @add_section_spacing = true
+      @sort_tables = true
+      @max_lines_per_file = 500
+      @overflow_threshold = 1.1
+      @generate_manifest = true
+      @adapter = :auto
+      @postgresql = Adapters::PostgresqlConfig.new
+    end
+
+    # Validates configuration settings
+    #
+    # @raise [Error] If any configuration setting is invalid
+    # @return [void]
+    def validate!
+      validate_output_path!
+      validate_schema_versions_limit!
+      validate_indent_size!
+      validate_schemas!
+      validate_max_lines_per_file!
+      validate_overflow_threshold!
+      validate_adapter!
+    end
+
+    private
+
+    def validate_output_path!
+      raise Error, 'output_path cannot be blank' if output_path.nil? || output_path.strip.empty?
+    end
+
+    def validate_schema_versions_limit!
+      return if schema_versions_limit.is_a?(Integer) && schema_versions_limit >= 0
+
+      raise Error, 'schema_versions_limit must be a non-negative integer'
+    end
+
+    def validate_indent_size!
+      return if indent_size.is_a?(Integer) && indent_size.positive?
+
+      raise Error, 'indent_size must be a positive integer'
+    end
+
+    def validate_schemas!
+      return if schemas.is_a?(Array) && schemas.any?
+
+      raise Error, 'schemas must be a non-empty array'
+    end
+
+    def validate_max_lines_per_file!
+      return if max_lines_per_file.is_a?(Integer) && max_lines_per_file.positive?
+
+      raise Error, 'max_lines_per_file must be a positive integer'
+    end
+
+    def validate_overflow_threshold!
+      return if overflow_threshold.is_a?(Numeric) && overflow_threshold >= 1.0
+
+      raise Error, 'overflow_threshold must be >= 1.0'
+    end
+
+    def validate_adapter!
+      valid_adapters = %i[auto postgresql mysql sqlite]
+
+      return if valid_adapters.include?(adapter)
+
+      raise Error, "Invalid adapter: #{adapter}. Valid options: #{valid_adapters.join(', ')}"
+    end
+  end
+end

data/lib/better_structure_sql/database_version.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module BetterStructureSql
+  # Database version detection abstraction.
+  # Delegates to the appropriate adapter for version detection.
+  module DatabaseVersion
+    class << self
+      # Detects database version using the appropriate adapter
+      #
+      # @param connection [ActiveRecord::ConnectionAdapters::AbstractAdapter] Database connection
+      # @return [String] Database version string
+      def detect(connection = ActiveRecord::Base.connection)
+        adapter = Adapters::Registry.adapter_for(
+          connection,
+          adapter_override: BetterStructureSql.configuration.adapter
+        )
+        adapter.database_version
+      end
+
+      # For backward compatibility with PgVersion
+      def parse_version(version_string)
+        # Parse version string directly (PostgreSQL format)
+        # Example: "PostgreSQL 15.1 on x86_64" → "15.1"
+        match = version_string.match(/(\d+\.\d+(\.\d+)?)/)
+        match ? match[1] : 'unknown'
+      end
+
+      # Extracts major version number from version string
+      #
+      # @param version_string [String] Version string (e.g., "15.1.0")
+      # @return [Integer] Major version number
+      def major_version(version_string)
+        version_string.split('.').first.to_i
+      end
+
+      # Extracts minor version number from version string
+      #
+      # @param version_string [String] Version string (e.g., "15.1.0")
+      # @return [Integer] Minor version number
+      def minor_version(version_string)
+        parts = version_string.split('.')
+        parts.length > 1 ? parts[1].to_i : 0
+      end
+    end
+  end
+end

data/lib/better_structure_sql/dependency_resolver.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module BetterStructureSql
+  # Resolves dependencies between database objects for correct ordering
+  #
+  # Uses topological sorting to ensure objects are created in dependency order,
+  # handling circular dependencies gracefully.
+  class DependencyResolver
+    attr_reader :objects, :dependencies
+
+    def initialize
+      @objects = []
+      @dependencies = Hash.new { |h, k| h[k] = [] }
+    end
+
+    # Adds an object and its dependencies to the resolver
+    #
+    # @param name [String] Object name
+    # @param type [Symbol] Object type (e.g., :table, :view, :function)
+    # @param depends_on [Array<String>] Names of objects this depends on
+    # @return [void]
+    def add_object(name, type, depends_on: [])
+      @objects << { name: name, type: type }
+      @dependencies[name] = Array(depends_on)
+    end
+
+    # Resolves dependencies and returns objects in correct order
+    #
+    # @return [Array<String>] Object names in dependency order
+    def resolve
+      sorted = []
+      visited = Set.new
+      temp_mark = Set.new
+
+      @objects.each do |obj|
+        visit(obj[:name], visited, temp_mark, sorted) unless visited.include?(obj[:name])
+      end
+
+      sorted
+    end
+
+    private
+
+    def visit(name, visited, temp_mark, sorted)
+      if temp_mark.include?(name)
+        # Circular dependency detected - return to allow best-effort ordering
+        return
+      end
+
+      return if visited.include?(name)
+
+      temp_mark.add(name)
+
+      @dependencies[name].each do |dep|
+        visit(dep, visited, temp_mark, sorted) if @objects.any? { |o| o[:name] == dep }
+      end
+
+      temp_mark.delete(name)
+      visited.add(name)
+      sorted << name
+    end
+  end
+end