esa 3.6.0 → 3.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd5b8f8b058d9e8a56821b7752001b7709a8fea436c8eef36adaf40d2988f45e
-  data.tar.gz: 90705ca3054b7b355c31ef681de863e75827eede50d0190a8012ffeee843e087
+  metadata.gz: 31ac99673b27154dd0f51e26e9b2df21cc5ae9748836882d783fb20313844f60
+  data.tar.gz: ab2481808f8e74884def974efdcb432263917608e0e8effa6233eaff51eee09e
 SHA512:
-  metadata.gz: a3d96a863c3b25b57efdb097f3a35e9b7c5f0fad853dd61b215a1405992ddb3d136212e41f76c0e5e4a8abffba5e8f4f585ba5ead4f1cf2507b92ae08fce26a2
-  data.tar.gz: a3653a3abb018835a52baa5a3e711f293e27891883d7c76858a2de028183d66504b3ac5e585bb32b4965c4e50941f4f4bd8ef5dafa8240feaead6ef5921610fb
+  metadata.gz: d3bb3fddea7149f744e344eaf9113a67cf3cbf2032dbfa9b14255657909bb3172431f9d100170e788f5744eb7593eb617b93661b73cf9791b2c85aaf3e217e0e
+  data.tar.gz: e03f488a818d740f1a303512ec5c9871372313e66c3a656354f98aa7962b3be942b6d5ec2a510356b983a1ae76103b0b6623e26d0c2990a76e4d95ac642bdeca

data/CHANGELOG.md

@@ -1,6 +1,12 @@
 ## Unreleased
 
-nothing
+Nothing
+
+## 3.7.0 (2026-08-04)
+
+- add: [Add create_attachment instead of upload_attachment](https://github.com/esaio/esa-ruby/pull/102)
+  - **deprecated**: `#upload_attachment` has been deprecated. Use `#create_attachment` instead. 
+- ci: [CI: Use latest bundler for ruby-head](https://github.com/esaio/esa-ruby/pull/103)
 
 ## 3.6.0 (2026-06-17)
 

data/README.md

@@ -202,7 +202,17 @@ client.create_emoji(code: 'alias_code', origin_code: 'team_emoji')
 client.delete_emoji('team_emoji')
 #=> DELETE /v1/teams/foobar/emojis/team_emoji
 
-# Upload Attachment(beta)
+# Upload Attachment
+client.create_attachment('/Users/foo/Desktop/foo.png')                 # Path
+client.create_attachment(File.open('/Users/foo/Desktop/foo.png'))      # File
+client.create_attachment('http://example.com/foo.png')                 # Remote URL
+client.create_attachment(['http://example.com/foo.png', cookie_str])   # Remote URL + Cookie
+client.create_attachment(['http://example.com/foo.png', headers_hash]) # Remote URL + Headers
+client.create_attachment('/Users/foo/Desktop/foo.png', name: 'bar.png') # Path + Name
+#=> POST /v1/teams/foobar/attachments
+#=> { "attachment" => { "url" => "https://img.esa.io/uploads/...", "name" => "foo.png", "size" => 12345, "content_type" => "image/png" } }
+
+# Upload Attachment(beta): deprecated, use create_attachment instead
 client.upload_attachment('/Users/foo/Desktop/foo.png')                 # Path
 client.upload_attachment(File.open('/Users/foo/Desktop/foo.png'))      # File
 client.upload_attachment('http://example.com/foo.png')                 # Remote URL

data/lib/esa/api_methods.rb

@@ -196,8 +196,23 @@ module Esa
       end
     end
 
-    # beta
+    def create_attachment(path_or_file_or_url, params = {}, headers = nil)
+      file = file_from(path_or_file_or_url)
+      content_type = params.delete(:content_type) || content_type_from_file(file) || 'application/octet-stream'
+
+      form_data = { file: Faraday::FilePart.new(file, content_type) }
+      form_data[:name] = params[:name] if params[:name]
+
+      send_multipart_post("/v1/teams/#{current_team!}/attachments", form_data, headers)
+    end
+
+    # deprecated: Use #create_attachment instead
     def upload_attachment(path_or_file_or_url, params = {}, headers = nil)
+      unless @upload_attachment_deprecation_warned
+        warn '[DEPRECATION] `upload_attachment` is deprecated. Use `create_attachment` instead.'
+        @upload_attachment_deprecation_warned = true
+      end
+
       file = file_from(path_or_file_or_url)
       setup_params_for_upload(params, file)
 

data/lib/esa/client.rb

@@ -43,8 +43,12 @@ module Esa
       send_request(:delete, path, params, headers)
     end
 
-    def send_request(method, path, params = nil, headers = nil)
-      response = esa_connection.send(method, path, params, headers)
+    def send_multipart_post(path, params = nil, headers = nil)
+      send_request(:post, path, params, headers, connection: multipart_connection)
+    end
+
+    def send_request(method, path, params = nil, headers = nil, connection: esa_connection)
+      response = connection.send(method, path, params, headers)
       raise TooManyRequestError if retry_on_rate_limit_exceeded && response.status == 429 # too_many_requests
       Esa::Response.new(response)
     rescue TooManyRequestError
@@ -71,6 +75,16 @@ module Esa
       end
     end
 
+    def multipart_connection
+      @multipart_connection ||= Faraday.new(faraday_options) do |c|
+        faraday_middlewares.each { |faraday_middleware| c.use faraday_middleware }
+        c.request :multipart
+        c.request :url_encoded
+        c.response :json
+        c.adapter Faraday.default_adapter
+      end
+    end
+
     def s3_connection
       @s3_connection ||= Faraday.new do |c|
         faraday_middlewares.each { |faraday_middleware| c.use faraday_middleware }

data/lib/esa/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Esa
-  VERSION = '3.6.0'
+  VERSION = '3.7.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: esa
 version: !ruby/object:Gem::Version
-  version: 3.6.0
+  version: 3.7.0
 platform: ruby
 authors:
 - fukayatsu
@@ -201,7 +201,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.11
+rubygems_version: 4.0.16
 specification_version: 4
 summary: esa API v1 client library, written in Ruby
 test_files: []