better_structure_sql 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 067320c86a8a8e2064c41dd5ac93acd1d89652213a61f9efed61a2b946c44660
-  data.tar.gz: f31e6dc7cb21647d8836f8f81da99097ed1c536db1b0adb7af33cf511ee401d1
+  metadata.gz: ef64a880cabbca1d370188561e604a27ecc2e8bd1040b68b123f9cf281b462ee
+  data.tar.gz: c4d5d2e7e366a0f768a8bc2933453958b10f46e72d5f168ea45af91d5b05473b
 SHA512:
-  metadata.gz: 581f226ac09dd57a6ab5f058615bcd1aba7e5eaca5abb01c62e3431b6c72ec7c9fe47422cf5e1bc8e5a336df4e64de386dbf7841cd4a2f6fafcd76feb50b575f
-  data.tar.gz: cd77d7dd9898c14ea6cfad1fa528de9b1cfb83d15d4d98253a9229ac7fb6fe84ad1b884cd9bfda7d815fd3cb87260ba559e3c7f44f33ee14a60661dce2e732cb
+  metadata.gz: 1d70b3713af668a419e7c9c5fcd66f516b36a50ec31e94b174b893207a7f2017e6ec273942345f191aa8860ab3f517d678eec04d62a32f25d36752c8a89a1b20
+  data.tar.gz: 39fcdb892436045a1579eeea41398fcf8ceb4b28407a192885d4aece4881b170e75724534b6cab30d7f0b58826aa1f5d03a7378f592cbf8d54f248ac98b080df

data/CHANGELOG.md

@@ -13,6 +13,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Fixed
 
+## [0.2.2] - 2025-11-23
+
+### Fixed
+- Web UI now properly displays multi-file schema content for files under 1MB
+- Optimized schema version show page to avoid loading ZIP archives unnecessarily
+- Improved memory efficiency by explicitly selecting only needed columns
+- Better error messages distinguishing "too large" from "not available" content
+
+## [0.2.1] - 2025-11-20
+
+### Changed
+- Improved schema version web UI with content hash display (first 8 characters)
+- Increased view limit for better visibility of stored schema versions
+
 ## [0.2.0] - 2025-11-20
 
 ### Added

data/README.md

@@ -16,7 +16,7 @@
 
 </div>
 
-> **⚠️ Beta Notice**: Version 0.2.0 is feature-complete and production-ready for **PostgreSQL**. Multi-database support (MySQL, SQLite) is implemented but considered experimental. APIs are stable but may see minor refinements before v1.0. We welcome feedback and contributions!
+> **⚠️ Beta Notice**: Version 0.2.2 is feature-complete and production-ready for **PostgreSQL**. Multi-database support (MySQL, SQLite) is implemented but considered experimental. APIs are stable but may see minor refinements before v1.0. We welcome feedback and contributions!
 
 ## ✨ Why BetterStructureSql?
 

data/app/controllers/better_structure_sql/schema_versions_controller.rb

@@ -11,8 +11,9 @@ module BetterStructureSql
   class SchemaVersionsController < ApplicationController
     # Maximum file size to load into memory (2MB)
     MAX_MEMORY_SIZE = 2.megabytes
-    # Maximum file size to display in browser (200KB)
-    MAX_DISPLAY_SIZE = 200.kilobytes
+    # Maximum file size to display in browser (1MB)
+    # Large enough for most schemas but keeps browser responsive
+    MAX_DISPLAY_SIZE = 1.megabyte
 
     # Lists stored schema versions with pagination
     #
@@ -25,7 +26,7 @@ module BetterStructureSql
       # Load only metadata for listing (no content or zip_archive)
       @schema_versions = SchemaVersion
                          .select(:id, :pg_version, :format_type, :output_mode, :created_at,
-                                 :content_size, :file_count)
+                                 :content_size, :file_count, :content_hash)
                          .order(created_at: :desc)
                          .limit(100)
     end
@@ -40,20 +41,26 @@ module BetterStructureSql
     # @raise [ActiveRecord::RecordNotFound] if schema version not found
     # GET /better_structure_sql/schema_versions/:id
     def show
-      # Load metadata first
+      # Load metadata first (no content or ZIP to minimize memory usage)
       @schema_version = SchemaVersion
                         .select(:id, :pg_version, :format_type, :output_mode, :created_at,
-                                :content_size, :line_count, :file_count)
+                                :content_size, :line_count, :file_count, :content_hash)
                         .find(params[:id])
 
-      # Only load content for small single-file versions
-      if @schema_version.output_mode == 'single_file' && @schema_version.content_size <= MAX_DISPLAY_SIZE
-        @schema_version = SchemaVersion.find(params[:id]) # Load with content
-      elsif @schema_version.output_mode == 'multi_file'
-        # Load content to extract manifest
-        full_version = SchemaVersion.select(:id, :content).find(params[:id])
-        @manifest = extract_manifest_from_content(full_version.content)
+      # Only load content for small files to display inline
+      # For large files, metadata is sufficient
+      if @schema_version.content_size <= MAX_DISPLAY_SIZE
+        # Reload full record with content column
+        # Note: We don't select zip_archive to avoid loading large binary data
+        @schema_version = SchemaVersion.select(
+          :id, :pg_version, :format_type, :output_mode, :created_at,
+          :content_size, :line_count, :file_count, :content_hash, :content
+        ).find(params[:id])
       end
+
+      # NOTE: Manifest extraction intentionally skipped to avoid loading
+      # potentially large ZIP archives into memory. Manifest is primarily
+      # useful for tooling and can be extracted from the download if needed.
     rescue ActiveRecord::RecordNotFound
       render plain: 'Schema version not found', status: :not_found
     end
@@ -176,37 +183,6 @@ module BetterStructureSql
       end
     end
 
-    # Extracts embedded manifest JSON from multi-file schema content
-    #
-    # Manifest is stored between MANIFEST_JSON_START and MANIFEST_JSON_END markers
-    # as SQL comments. Parses and returns the manifest hash.
-    #
-    # @param content [String] the schema content containing embedded manifest
-    # @return [Hash, nil] parsed manifest hash or nil if not found/invalid
-    def extract_manifest_from_content(content)
-      # Manifest is embedded in content between MANIFEST_JSON_START and MANIFEST_JSON_END markers
-      return nil unless content.include?('MANIFEST_JSON_START')
-
-      # Extract JSON from between markers, removing comment prefixes
-      start_marker = '-- MANIFEST_JSON_START'
-      end_marker = '-- MANIFEST_JSON_END'
-
-      start_pos = content.index(start_marker)
-      end_pos = content.index(end_marker)
-
-      return nil unless start_pos && end_pos
-
-      manifest_section = content[(start_pos + start_marker.length)..(end_pos - 1)]
-      manifest_json = manifest_section.lines
-                                      .map { |line| line.sub(/^--\s?/, '') }
-                                      .join
-
-      JSON.parse(manifest_json)
-    rescue JSON::ParserError => e
-      Rails.logger.debug { "Failed to parse manifest: #{e.message}" }
-      nil
-    end
-
     # Streams large file content from database in chunks
     #
     # Sets appropriate headers for streaming downloads and disables proxy buffering.

data/app/views/better_structure_sql/schema_versions/index.html.erb

@@ -27,6 +27,7 @@
             <thead class="table-light">
               <tr>
                 <th scope="col" class="text-center" style="width: 80px;">ID</th>
+                <th scope="col" style="width: 120px;">Hash</th>
                 <th scope="col" style="width: 120px;">Format</th>
                 <th scope="col" style="width: 150px;">Mode</th>
                 <th scope="col" style="width: 180px;">PostgreSQL</th>
@@ -42,6 +43,11 @@
                   <td class="text-center fw-bold text-muted">
                     #<%= version.id %>
                   </td>
+                  <td>
+                    <code class="text-muted small" title="<%= version.content_hash %>">
+                      <%= version.content_hash[0..7] %>
+                    </code>
+                  </td>
                   <td>
                     <%= format_type_badge(version.format_type) %>
                   </td>

data/app/views/better_structure_sql/schema_versions/show.html.erb

@@ -93,6 +93,18 @@
             </p>
           </div>
         </div>
+
+        <div class="row mt-3">
+          <div class="col-md-12">
+            <h6 class="text-muted mb-1">
+              <i class="bi bi-fingerprint"></i>
+              Content Hash (MD5)
+            </h6>
+            <p class="mb-0">
+              <code class="text-muted"><%= @schema_version.content_hash %></code>
+            </p>
+          </div>
+        </div>
       </div>
     </div>
 
@@ -109,7 +121,7 @@
           Download File
         <% end %>
       </a>
-      <% if @schema_version.respond_to?(:content) && @schema_version.content.present? %>
+      <% if @schema_version.content.present? %>
         <button type="button" class="btn btn-outline-secondary btn-lg" onclick="copyToClipboard()">
           <i class="bi bi-clipboard"></i>
           Copy to Clipboard
@@ -118,19 +130,16 @@
     </div>
 
     <!-- Multi-file Info -->
-    <% if @schema_version.multi_file? && @manifest %>
+    <% if @schema_version.multi_file? %>
       <div class="alert alert-info mb-4">
         <h6 class="alert-heading">
           <i class="bi bi-info-circle"></i>
           Multi-File Schema
         </h6>
-        <p class="mb-2">This schema was generated in multi-file format with <%= @schema_version.file_count %> files across organized directories.</p>
-        <% if @manifest['directories'] %>
-          <p class="mb-0 small">
-            <strong>Directories:</strong>
-            <%= @manifest['directories'].keys.sort.join(', ') %>
-          </p>
-        <% end %>
+        <p class="mb-0">
+          This schema was generated in multi-file format with <%= @schema_version.file_count %> files across organized directories.
+          Download the ZIP archive to explore the directory structure and individual files.
+        </p>
       </div>
     <% end %>
 
@@ -146,14 +155,18 @@
         </h5>
       </div>
       <div class="card-body p-0">
-        <% if @schema_version.respond_to?(:content) && @schema_version.content.present? %>
+        <% if @schema_version.content.present? %>
           <pre class="code-block m-0" id="schema-content"><%= @schema_version.content %></pre>
         <% else %>
           <div class="alert alert-warning m-3">
             <i class="bi bi-exclamation-triangle"></i>
-            <strong>File too large to display</strong>
+            <strong>Content not loaded</strong>
             <p class="mb-0 mt-2">
-              This schema file is too large to display in the browser (limit: 200 KB).
+              <% if @schema_version.content_size && @schema_version.content_size > 1048576 %>
+                This schema file is too large to display in the browser (limit: 1 MB, actual size: <%= number_to_human_size(@schema_version.content_size) %>).
+              <% else %>
+                The schema content is not available for inline display.
+              <% end %>
               Please use the "Download" button above to download and view it locally.
             </p>
           </div>

data/lib/better_structure_sql/version.rb

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

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: better_structure_sql
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.2
 platform: ruby
 authors:
 - sebyx07
 bindir: exe
 cert_chain: []
-date: 2025-11-20 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pg
@@ -294,7 +294,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.7.2
 specification_version: 4
 summary: Clean database schema dumps for Rails (PostgreSQL, MySQL, SQLite) without
   external tool dependencies