iostreams 0.17.1 → 0.17.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7b91433de5d43d10f489ab1034e9ddc79913e580a856333a4edf975b64b494ca
-  data.tar.gz: 1d2940ff36fa882774cf3b11bb5a4d5a8a27c6511eabc938088eda006f5d1863
+  metadata.gz: 72fd57ac6ba81c64ac1dd5526bcf2b0aa491ef55eff38d1709a037874d8659d1
+  data.tar.gz: a953ad1389cd98740112f847c656d24956ce259f3dfa1309aa216354a93762a1
 SHA512:
-  metadata.gz: 2b6a0a299ada19de5fb9bf32f54201c12623b1a3fd59d30732cffe04dc8825f0d4d35dc3f895765dd16d10d2e7a5a6e0c51c069b382beac5a271b222c7bafa30
-  data.tar.gz: 5fc609c806c825e3230264942eb19d7ae0982e2d7afdafe218542d6b19706dcd7a979e0db541d15f3f1a3b62f698e9b5fc273489c9c605e719cc81e0f23477f6
+  metadata.gz: 9a5f33b69593ee071aa850a74f2c0c67c05000e1ecf730bc1be91a116786b820b408788f41802e86711eb2d3fbd861f739c5353ad9809ae17ab8b90a1f57954f
+  data.tar.gz: 100e625316b55badbad403bcd58c146381ad343b427a9c68780424f4d738867d0fbb5fe1ad480cb1dce399c9f7d6e68b25055c38b569471da0bdfc811c7cdcbc

data/lib/io_streams/s3.rb

@@ -15,7 +15,7 @@ module IOStreams
     end
 
     def self.load_dependencies
-      return unless defined?(::Aws::S3::Resource)
+      return if defined?(::Aws::S3::Resource)
 
       require 'aws-sdk-s3'
     rescue LoadError => exc

data/lib/io_streams/s3/writer.rb

@@ -2,6 +2,71 @@ module IOStreams
   module S3
     class Writer
       # Write to AWS S3
+      #
+      # Arguments:
+      #
+      # uri: [String]
+      #   Prefix must be: `s3://`
+      #   followed by bucket name,
+      #   followed by path and file_name (key).
+      #   Examples:
+      #     s3://my-bucket-name/file_name.txt
+      #     s3://my-bucket-name/some_path/file_name.csv
+      #
+      # region: [String]
+      #   AWS Region.
+      #   Default: ENV['AWS_REGION'], or supplied by ruby driver
+      #
+      # thread_count: [Integer]
+      #   The number of parallel multipart uploads
+      #   Default: 10
+      #
+      # tempfile: [Boolean]
+      #   Normally read data is stored in memory when building the parts in order to complete
+      #   the underlying multipart upload. By passing `:tempfile => true` data read will be
+      #   temporarily stored on disk reducing the memory footprint vastly.
+      #   Default: false
+      #
+      # part_size: [Integer]
+      #   Define how big each part size but the last should be.
+      #   Default: 5 * 1024 * 1024
+      #
+      # Other possible options extracted from AWS source code:
+      #   # See: https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/S3/Client.html#create_multipart_upload-instance_method
+      #
+      #   acl: "private", # accepts private, public-read, public-read-write, authenticated-read, aws-exec-read, bucket-owner-read, bucket-owner-full-control
+      #   cache_control: "CacheControl",
+      #   content_disposition: "ContentDisposition",
+      #   content_encoding: "ContentEncoding",
+      #   content_language: "ContentLanguage",
+      #   content_type: "ContentType",
+      #   expires: Time.now,
+      #   grant_full_control: "GrantFullControl",
+      #   grant_read: "GrantRead",
+      #   grant_read_acp: "GrantReadACP",
+      #   grant_write_acp: "GrantWriteACP",
+      #   metadata: {
+      #     "MetadataKey" => "MetadataValue",
+      #   },
+      #   server_side_encryption: "AES256", # accepts AES256, aws:kms
+      #   storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE
+      #   website_redirect_location: "WebsiteRedirectLocation",
+      #   sse_customer_algorithm: "SSECustomerAlgorithm",
+      #   sse_customer_key: "SSECustomerKey",
+      #   sse_customer_key_md5: "SSECustomerKeyMD5",
+      #   ssekms_key_id: "SSEKMSKeyId",
+      #   ssekms_encryption_context: "SSEKMSEncryptionContext",
+      #   request_payer: "requester", # accepts requester
+      #   tagging: "TaggingHeader",
+      #   object_lock_mode: "GOVERNANCE", # accepts GOVERNANCE, COMPLIANCE
+      #   object_lock_retain_until_date: Time.now,
+      #   object_lock_legal_hold_status: "ON", # accepts ON, OFF
+      #
+      # Raises [MultipartUploadError] If an object is being uploaded in
+      #   parts, and the upload can not be completed, then the upload is
+      #   aborted and this error is raised.  The raised error has a `#errors`
+      #   method that returns the failures that caused the upload to be
+      #   aborted.
       def self.open(uri, region: nil, **args, &block)
         raise(ArgumentError, 'file_name must be a URI string') unless uri.is_a?(String)
 

data/lib/io_streams/version.rb

@@ -1,3 +1,3 @@
 module IOStreams
-  VERSION = '0.17.1'
+  VERSION = '0.17.2'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: iostreams
 version: !ruby/object:Gem::Version
-  version: 0.17.1
+  version: 0.17.2
 platform: ruby
 authors:
 - Reid Morrison
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-04-03 00:00:00.000000000 Z
+date: 2019-07-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -128,7 +128,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.2
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Input and Output streaming for Ruby.