formatic 0.2.12 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a7e3e2484fd61fe3a436e68d059689803fc339553b243c95ccfcd6f0dd4f7a40
-  data.tar.gz: cd26ab984cb09ef2552a2cf2efb86edfa89d6839edc12dee8fa2c4479c7b746f
+  metadata.gz: 2e8931dc635b9f82d078e614fe974173add25c068d5269c28531fe947c3be596
+  data.tar.gz: e73abb6b3045ca45d0546a17967e60f6aec03489a48381240447a3e0a3d63bc4
 SHA512:
-  metadata.gz: 9dd0bc7504620621b5bc3104fc335aba51268d495f8e143b53d9e348ed26736bd47ea02c4a683ce379583be5f9fc89e1c8715b0ecd06244ca84983357e9a3a5f
-  data.tar.gz: d1b8430e512ca12718da806cb9d5ab65750944d45aa03bcd5b4f9bebb8b15171c491c9f15529d6a71a54216bb7a2e3f6d2cb43cec96c7d38f11d9ea4c0e71659
+  metadata.gz: e4e0ec1a1dc71da29321efee225c7a3ca3aa4dc4fd15bd885ff8d80a0e903cd62879ddd5078d742e9ca9a66a2efb1517db0b3855dc8ef2ac843fa51d145abe81
+  data.tar.gz: 6bd89feb80068a835b453ef11af4df9635f3094347f090c45f3e21b3029f7f3b44dbe52b1ceebbf403a664d5b8f942d86f1f09493eabaf129f1d1b55f053a048

data/CHANGELOG.md

@@ -1,4 +1,10 @@
-## [Unreleased]
+## [0.4.0] 2026-08-05
+
+- `Formatic::File` now raises at render time when `attribute_name` does not exist on the model, so typos like `header_logo_for_light` (instead of the model's `header_logo_for_dark`) surface immediately instead of silently dropping the upload. The check is skipped when a manual `value:` is passed, the form builder has no object, or the object is not an ActiveModel/ActiveRecord record.
+
+## [0.3.0] 2026-08-04
+
+- Make VS Code snippet symlinking atomic so concurrent app boots no longer race into `Errno::EEXIST`
 
 ## [0.2.12] 2026-07-24
 

data/app/components/formatic/file.rb

@@ -27,6 +27,12 @@ module Formatic
             </div>
 
             <%= f.file_field attribute_name, class: "js-formatic-file__input", direct_upload:, multiple:, accept:, data: %>
+
+            <%- if (file = current_file) -%>
+              <div class="c-formatic-file__current">
+                <%= link_to 'Download', file, target: :_blank %>
+              </div>
+            <%- end -%>
           </div>
         <% end %>
       <% end %>
@@ -36,8 +42,27 @@ module Formatic
       { entries: entries_json }.merge(manual_data)
     end
 
+    def before_render
+      validate_attribute_name!
+    end
+
     private
 
+    def validate_attribute_name!
+      # A manually passed value means `attribute_name` is just a param name,
+      # not necessarily a method on the model.
+      return if manual_value != :_fetch_from_record
+      return if f.nil? || f.object.nil?
+
+      # Only enforce this for real ActiveModel/ActiveRecord records.
+      # Custom objects (e.g. slugs) are not expected to respond to it.
+      return unless f.object.respond_to?(:model_name)
+      return if f.object.respond_to?(attribute_name)
+
+      raise ArgumentError,
+            "attribute `#{attribute_name}` does not exist on #{f.object.class}."
+    end
+
     def attachments
       return [] if value.blank?
 
@@ -66,5 +91,15 @@ module Formatic
         }
       end.to_json
     end
+
+    # The currently attached file, if there is exactly one.
+    # Multiple files are not shown here, see `Formatic::Files`.
+    def current_file
+      return if multiple
+      return unless attachments.size == 1
+
+      attachment = attachments.first
+      attachment if attachment.present?
+    end
   end
 end

data/lib/formatic/engine.rb

@@ -28,8 +28,7 @@ module Formatic
         target = vscode_dir.join('formatic.code-snippets')
         source = Engine.root.join('vscode/formatic.code-snippets')
 
-        FileUtils.rm_f(target.to_s)
-        FileUtils.ln_s(source, target, force: true)
+        VscodeSnippets.install(target, source)
       end
     end
 

data/lib/formatic/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Formatic
-  VERSION = '0.2.12'
+  VERSION = '0.4.0'
 end

data/lib/formatic/vscode_snippets.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require 'tmpdir'
+
+module Formatic
+  # Installs the gem's VS Code snippets as a symlink inside the host
+  # application's `.vscode` directory.
+  #
+  # This runs in every process that boots the host application (Spring
+  # preloader, Puma workers, rake tasks, ...), so those processes race each
+  # other. A non-atomic remove-then-create (`FileUtils.ln_s(force: true)`)
+  # lets two processes both pass the "does it exist?" check before either
+  # creates the link, so one of them dies with `Errno::EEXIST` on
+  # `symlink(2)`.
+  #
+  # To stay race-free the link is created under a temporary name in the
+  # system temp directory and then `rename(2)`-ed over the target, which
+  # atomically replaces whatever is already there.
+  #
+  # NOTE: `Formatic::File` (a ViewComponent) shadows `File` inside this
+  # module, so we refer to Ruby's file class as `::File`.
+  module VscodeSnippets
+    class << self
+      def install(target, source)
+        target = target.to_s
+        source = source.to_s
+
+        return if already_linked?(target, source)
+
+        install_atomically(target, source)
+      end
+
+      private
+
+      def install_atomically(target, source)
+        tmp = ::File.join(Dir.tmpdir, "formatic-#{Process.pid}-#{Thread.current.object_id}.tmp")
+        FileUtils.rm_f(tmp)
+        ::File.symlink(source, tmp)
+        ::File.rename(tmp, target)
+      rescue Errno::EXDEV
+        replace(target, source)
+      ensure
+        FileUtils.rm_f(tmp) if tmp
+      end
+
+      def already_linked?(target, source)
+        ::File.symlink?(target) && ::File.readlink(target) == source
+      end
+
+      def replace(target, source)
+        FileUtils.rm_f(target)
+        ::File.symlink(source, target)
+      end
+    end
+  end
+end

data/lib/formatic.rb

@@ -9,6 +9,7 @@ require 'dry/initializer'
 require 'formatic/version'
 require 'formatic/css'
 require 'formatic/safe_join'
+require 'formatic/vscode_snippets'
 require 'formatic/templates/select'
 require 'formatic/templates/wrapper'
 require 'formatic/choices/countries'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: formatic
 version: !ruby/object:Gem::Version
-  version: 0.2.12
+  version: 0.4.0
 platform: ruby
 authors:
 - halo
@@ -198,6 +198,7 @@ files:
 - lib/formatic/templates/select.rb
 - lib/formatic/templates/wrapper.rb
 - lib/formatic/version.rb
+- lib/formatic/vscode_snippets.rb
 - lib/formatic/wrappers/alternative_attribute_name.rb
 - lib/formatic/wrappers/error_messages.rb
 - lib/formatic/wrappers/required.rb