method

atomic_write

Ruby on Rails latest stable (v7.1.3.2) - 0 notes - Class: ActiveSupport::CoreExtensions::File::Atomic

1.0.0
1.1.6
1.2.6
2.0.3
2.1.0
2.2.1 (0)
2.3.8 (0)
3.0.0
3.0.9
3.1.0
3.2.1
3.2.8
3.2.13
4.0.2
4.1.8
4.2.1
4.2.7
4.2.9
5.0.0.1
5.1.7
5.2.3
6.0.0
6.1.3.1
6.1.7.7
7.0.0
7.1.3.2
7.1.3.4
What's this?

Method deprecated or moved

This method is deprecated or moved on the latest stable version. The last existing version (v2.3.8) is shown here.

These similar methods exist in v7.1.3.2:

File#atomic_write

atomic_write(file_name, temp_dir = Dir.tmpdir) public

Write to a file atomically. Useful for situations where you don’t want other processes or threads to see half-written files.

  File.atomic_write("important.file") do |file|
    file.write("hello")
  end

If your temp directory is not on the same filesystem as the file you’re trying to write, you can provide a different temporary directory.

  File.atomic_write("/data/something.important", "/data/tmp") do |f|
    file.write("hello")
  end

Show source

# File activesupport/lib/active_support/core_ext/file/atomic.rb, line 18
        def atomic_write(file_name, temp_dir = Dir.tmpdir)
          require 'tempfile' unless defined?(Tempfile)
          require 'fileutils' unless defined?(FileUtils)

          temp_file = Tempfile.new(basename(file_name), temp_dir)
          yield temp_file
          temp_file.close

          begin
            # Get original file permissions
            old_stat = stat(file_name)
          rescue Errno::ENOENT
            # No old permissions, write a temp file to determine the defaults
            check_name = join(dirname(file_name), ".permissions_check.#{Thread.current.object_id}.#{Process.pid}.#{rand(1000000)}")
            open(check_name, "w") { }
            old_stat = stat(check_name)
            unlink(check_name)
          end

          # Overwrite original file with temp file
          FileUtils.mv(temp_file.path, file_name)

          # Set correct permissions on new file
          chown(old_stat.uid, old_stat.gid, file_name)
          chmod(old_stat.mode, file_name)
        end

atomic_write

Related methods

Method deprecated or moved