formatic 0.2.12 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a7e3e2484fd61fe3a436e68d059689803fc339553b243c95ccfcd6f0dd4f7a40
-  data.tar.gz: cd26ab984cb09ef2552a2cf2efb86edfa89d6839edc12dee8fa2c4479c7b746f
+  metadata.gz: 6e76d4fb54356f3c1617b84931834bb46e25dbdb8b9923d5449452c72a43fff5
+  data.tar.gz: aa825faad29917f0aaf406e849d50c4b202613d1853927e3d2236488e8a767c2
 SHA512:
-  metadata.gz: 9dd0bc7504620621b5bc3104fc335aba51268d495f8e143b53d9e348ed26736bd47ea02c4a683ce379583be5f9fc89e1c8715b0ecd06244ca84983357e9a3a5f
-  data.tar.gz: d1b8430e512ca12718da806cb9d5ab65750944d45aa03bcd5b4f9bebb8b15171c491c9f15529d6a71a54216bb7a2e3f6d2cb43cec96c7d38f11d9ea4c0e71659
+  metadata.gz: 1da9feda2b01a0e4154db1b2efb67904abf8a799c0c518caa83d135edb283e3b534342734acb2a24cf1fadb317e8cc09ecf7c802ee99c475caa339642a2e2fe8
+  data.tar.gz: d95a0967fe128dc408d3dd67e4ffc984b65b0b75362ed6b0b3e92bbde94d0fe61506b77bea87a1a5e79637824e96aa949a29f28cd8ff876f143653002674bced

data/CHANGELOG.md

@@ -1,4 +1,6 @@
-## [Unreleased]
+## [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 %>
@@ -66,5 +72,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.3.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.3.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