aws-sdk-s3 1.199.0 → 1.199.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ffda0f4ecb81969c1c783ca56f099b78bc0353a07874164983d1d39cedeaef64
-  data.tar.gz: f9ecf4f1772d4f071b4e845fc30095a57ebe3eacfa2d5e46219514e09a46e6bb
+  metadata.gz: 8efe40f953e63f4a396ff665d16447df9efd68b748c5a3e84df1eb3e5f409c86
+  data.tar.gz: e1960dc386627ee1fafd1d49c8f28af41e79a99c301bc6d45886ecebe7dfe65c
 SHA512:
-  metadata.gz: 6aac2b06b2fcc2e59b7f8264438098d40674cefb8399bfab2b775f284cabc14f82e9b124836fead306e102a20b400f789f192d34e7f388fcb83d4659a839c083
-  data.tar.gz: a22e4f47897670b4f83145c6ddc294ab3f5e1dc00d19596490fb653dcf8810d8e21a131c29b74c2a78863a54a3b4f6f006459dffa58cc046e61fc99f5bba997e
+  metadata.gz: 90ab3030dae414f3a8dc714a38f2d460d44c44142371e5d4505a645f141e25b23386014d5c1f0c0a5378b013dbcf9c600aececa9f43abae78a40baa27a539770
+  data.tar.gz: 13e4abf112361ada24e89c75bdfcbc2484eefedc7364ab6eeb0b4a00b3f8744588d4ccca123081515f36470e1770a09bb97e9d922aaeb6799e97dfbfdced50be

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.199.1 (2025-09-25)
+------------------
+
+* Issue - Update `TransferManager#download_file` and `Object#download_file` documentation regarding temporary file usage and failure handling for different destination types.
+
 1.199.0 (2025-09-08)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.199.0
+1.199.1

data/lib/aws-sdk-s3/client.rb

@@ -21735,7 +21735,7 @@ module Aws::S3
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-s3'
-      context[:gem_version] = '1.199.0'
+      context[:gem_version] = '1.199.1'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-s3/customizations/object.rb

@@ -491,7 +491,13 @@ module Aws
       # @param [String, Pathname, File, Tempfile] destination
       #   Where to download the file to. This can either be a String or Pathname to the file, an open File object,
       #   or an open Tempfile object. If you pass an open File or Tempfile object, then you are responsible for
-      #   closing it after the download completes.
+      #   closing it after the download completes. Download behavior varies by destination type:
+      #
+      #   * **String/Pathname paths**: Downloads to a temporary file first, then atomically moves to the final
+      #    destination. This prevents corruption of any existing file if the download fails.
+      #   * **File/Tempfile objects**: Downloads directly to the file object without using temporary files.
+      #    You are responsible for managing the file object's state and closing it after the download completes.
+      #    If the download fails, the file object may contain partial data.
       #
       # @param [Hash] options
       #   Additional options for {Client#get_object} and #{Client#head_object} may be provided.

data/lib/aws-sdk-s3/transfer_manager.rb

@@ -48,7 +48,13 @@ module Aws
       # @param [String, Pathname, File, Tempfile] destination
       #   Where to download the file to. This can either be a String or Pathname to the file, an open File object,
       #   or an open Tempfile object. If you pass an open File or Tempfile object, then you are responsible for
-      #   closing it after the download completes.
+      #   closing it after the download completes. Download behavior varies by destination type:
+      #
+      #   * **String/Pathname paths**: Downloads to a temporary file first, then atomically moves to the final
+      #    destination. This prevents corruption of any existing file if the download fails.
+      #   * **File/Tempfile objects**: Downloads directly to the file object without using temporary files.
+      #    You are responsible for managing the file object's state and closing it after the download completes.
+      #    If the download fails, the file object may contain partial data.
       #
       # @param [String] bucket
       #   The name of the S3 bucket to upload to.

data/lib/aws-sdk-s3.rb

@@ -75,7 +75,7 @@ module Aws::S3
   autoload :ObjectVersion, 'aws-sdk-s3/object_version'
   autoload :EventStreams, 'aws-sdk-s3/event_streams'
 
-  GEM_VERSION = '1.199.0'
+  GEM_VERSION = '1.199.1'
 
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-s3
 version: !ruby/object:Gem::Version
-  version: 1.199.0
+  version: 1.199.1
 platform: ruby
 authors:
 - Amazon Web Services