rails_lens 0.2.0 → 0.2.3

data/lib/rails_lens/schema/adapters/sqlite3.rb

@@ -8,7 +8,15 @@ module RailsLens
           'SQLite'
         end
 
-        def generate_annotation(_model_class)
+        def generate_annotation(model_class)
+          if model_class && ModelDetector.view_exists?(model_class)
+            generate_view_annotation(model_class)
+          else
+            generate_table_annotation(model_class)
+          end
+        end
+
+        def generate_table_annotation(_model_class)
           lines = []
           lines << "table = \"#{table_name}\""
           lines << "database_dialect = \"#{database_dialect}\""
@@ -22,6 +30,27 @@ module RailsLens
           lines.join("\n")
         end
 
+        def generate_view_annotation(model_class)
+          lines = []
+          lines << "view = \"#{table_name}\""
+          lines << "database_dialect = \"#{database_dialect}\""
+
+          # Fetch all view metadata in a single query
+          view_info = fetch_view_metadata
+
+          if view_info
+            lines << "view_type = \"#{view_info[:type]}\"" if view_info[:type]
+            lines << "updatable = #{view_info[:updatable]}"
+          end
+
+          lines << ''
+
+          add_columns_toml(lines)
+          add_view_dependencies_toml(lines, view_info)
+
+          lines.join("\n")
+        end
+
         protected
 
         def format_column(column)
@@ -90,6 +119,90 @@ module RailsLens
             Rails.logger.debug { "SQLite error fetching pragmas: #{e.message}" }
           end
         end
+
+        def add_view_dependencies_toml(lines, view_info)
+          return unless view_info && view_info[:dependencies]
+
+          dependencies = view_info[:dependencies]
+          return if dependencies.empty?
+
+          lines << ''
+          lines << "view_dependencies = [#{dependencies.map { |d| "\"#{d}\"" }.join(', ')}]"
+        end
+
+        # SQLite-specific view methods
+        public
+
+        # Fetch all view metadata in a single consolidated query
+        def fetch_view_metadata
+          result = connection.exec_query(<<~SQL.squish, 'SQLite View Metadata')
+            SELECT sql FROM sqlite_master#{' '}
+            WHERE type = 'view' AND name = '#{connection.quote_string(table_name)}'
+            LIMIT 1
+          SQL
+
+          return nil if result.rows.empty?
+
+          definition = result.rows.first&.first&.strip
+          return nil unless definition
+
+          # Parse dependencies from the SQL definition
+          tables = []
+          definition.scan(/(?:FROM|JOIN)\s+(\w+)/i) do |match|
+            table_name_match = match[0]
+            # Exclude the view itself and common SQL keywords
+            if !table_name_match.downcase.in?(%w[select where order group having limit offset]) &&
+               tables.exclude?(table_name_match) &&
+               table_name_match != table_name
+              tables << table_name_match
+            end
+          end
+
+          {
+            type: 'regular',  # SQLite only supports regular views
+            updatable: false, # SQLite views are generally read-only
+            dependencies: tables.sort
+          }
+        rescue ActiveRecord::StatementInvalid, SQLite3::Exception => e
+          Rails.logger.debug { "Failed to fetch view metadata for #{table_name}: #{e.message}" }
+          nil
+        end
+
+        # Legacy methods - kept for backward compatibility but now use consolidated query
+        def view_type
+          @view_metadata ||= fetch_view_metadata
+          @view_metadata&.dig(:type)
+        end
+
+        def view_updatable?
+          @view_metadata ||= fetch_view_metadata
+          @view_metadata&.dig(:updatable) || false
+        end
+
+        def view_dependencies
+          @view_metadata ||= fetch_view_metadata
+          @view_metadata&.dig(:dependencies) || []
+        end
+
+        def view_definition
+          result = connection.exec_query(<<~SQL.squish, 'SQLite View Definition')
+            SELECT sql FROM sqlite_master#{' '}
+            WHERE type = 'view' AND name = '#{connection.quote_string(table_name)}'
+            LIMIT 1
+          SQL
+
+          result.rows.first&.first&.strip
+        rescue ActiveRecord::StatementInvalid, SQLite3::Exception
+          nil
+        end
+
+        def view_refresh_strategy
+          nil # SQLite doesn't have materialized views
+        end
+
+        def view_last_refreshed
+          nil # SQLite doesn't have materialized views
+        end
       end
     end
   end

data/lib/rails_lens/schema/annotation_manager.rb

@@ -112,8 +112,8 @@ module RailsLens
             next
           end
 
-          # Skip models without tables or with missing tables
-          unless model.table_exists?
+          # Skip models without tables or with missing tables (but not abstract classes)
+          unless model.abstract_class? || model.table_exists?
             results[:skipped] << model.name
             warn "Skipping #{model.name} - table does not exist" if options[:verbose]
             next

data/lib/rails_lens/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsLens
-  VERSION = '0.2.0'
+  VERSION = '0.2.3'
 end

data/lib/rails_lens/view_metadata.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+module RailsLens
+  # Extracts and manages metadata for database views and materialized views
+  class ViewMetadata
+    attr_reader :model_class, :connection, :table_name
+
+    def initialize(model_class)
+      @model_class = model_class
+      @connection = model_class.connection
+      @table_name = model_class.table_name
+      @adapter_name = connection.adapter_name.downcase
+      @adapter = create_adapter
+    end
+
+    def view_type
+      return nil unless view_exists?
+
+      @adapter&.view_type
+    end
+
+    def view_exists?
+      ModelDetector.view_exists?(model_class)
+    end
+
+    def materialized_view?
+      view_type == 'materialized'
+    end
+
+    def regular_view?
+      view_type == 'regular'
+    end
+
+    def updatable?
+      return false unless view_exists?
+
+      @adapter&.view_updatable? || false
+    rescue ActiveRecord::StatementInvalid, ActiveRecord::ConnectionNotDefined
+      false
+    end
+
+    def dependencies
+      return [] unless view_exists?
+
+      @adapter&.view_dependencies || []
+    rescue ActiveRecord::StatementInvalid, ActiveRecord::ConnectionNotDefined
+      []
+    end
+
+    def refresh_strategy
+      return nil unless materialized_view?
+
+      @adapter&.view_refresh_strategy
+    end
+
+    def last_refreshed
+      return nil unless materialized_view?
+
+      @adapter&.view_last_refreshed
+    rescue ActiveRecord::StatementInvalid, ActiveRecord::ConnectionNotDefined
+      nil
+    end
+
+    def view_definition
+      return nil unless view_exists?
+
+      @adapter&.view_definition
+    rescue ActiveRecord::StatementInvalid, ActiveRecord::ConnectionNotDefined
+      nil
+    end
+
+    def to_h
+      {
+        view_type: view_type,
+        updatable: updatable?,
+        dependencies: dependencies,
+        refresh_strategy: refresh_strategy,
+        last_refreshed: last_refreshed,
+        view_definition: view_definition
+      }.compact
+    end
+
+    private
+
+    def create_adapter
+      case @adapter_name
+      when 'postgresql'
+        Schema::Adapters::Postgresql.new(connection, table_name)
+      when 'mysql', 'mysql2'
+        Schema::Adapters::Mysql.new(connection, table_name)
+      when 'sqlite', 'sqlite3'
+        Schema::Adapters::Sqlite3.new(connection, table_name)
+      else
+        nil
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails_lens
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.3
 platform: ruby
 authors:
 - Abdelkader Boudih
@@ -219,6 +219,8 @@ files:
 - lib/rails_lens/providers/performance_notes_provider.rb
 - lib/rails_lens/providers/schema_provider.rb
 - lib/rails_lens/providers/section_provider_base.rb
+- lib/rails_lens/providers/view_notes_provider.rb
+- lib/rails_lens/providers/view_provider.rb
 - lib/rails_lens/railtie.rb
 - lib/rails_lens/rake_bootstrapper.rb
 - lib/rails_lens/route/annotator.rb
@@ -237,6 +239,7 @@ files:
 - lib/rails_lens/tasks/routes.rake
 - lib/rails_lens/tasks/schema.rake
 - lib/rails_lens/version.rb
+- lib/rails_lens/view_metadata.rb
 homepage: https://github.com/seuros/rails_lens
 licenses:
 - MIT