x 0.16.0 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc174269cbe283b3f360fee2c9a443272d0c1d3aab08cf609d552f22323dabc7
-  data.tar.gz: a2f50383c52f0e499f8afe275ce100cd9ca6f8231bd5fdd1f18c1bfdd7bf5191
+  metadata.gz: 4df136d018c47058c7524faada6292a1464b34f2f0e98f2a76e8491630b28d1c
+  data.tar.gz: f7101280a194f40bef57a82e9670cd6ddf409e80b7563072384b8f8c7687cb63
 SHA512:
-  metadata.gz: d9d9d70a98d38037f5a9606ec4770bc1fb79b7201a4c6f0a3d6a8a7e9360d360730d42606059fe40365ef008bab229cafe14feef5c3558518528afe2c15f6676
-  data.tar.gz: bceff542ee42df84cc8b96df31e311db88bafb7ecec138c2caf7c07d2c106c535750c1cdc603d22e1743586798f79f9d624c9073dee282093f89dc305e886286
+  metadata.gz: 24599b2cb2604a711a1a810cb21b0631ce26519dcee977e12bf494fdde1be55c08bf4e2716b6c281918010847e8c1bd72cd236a44f0343ece70a66f4a908ab1f
+  data.tar.gz: 84cdf631377ed38f0400a0f82d6dc42609839eeb4ba81d77526017af8541365152adb4f3e73f2722ae2645a494cf697976c1ae85039c9bd2b82edb1efe97136f

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## [0.17.0] - 2025-12-02
+* Add MediaUploader.upload_binary method (9f2f108)
+* Don't forward filename during media upload (492214d)
+
 ## [0.16.0] - 2025-06-24
 * Remove media_type parameter from non-chunked upload and append methods (f1f38b5)
 * Fix media upload (dcb418a)

data/README.md

@@ -23,7 +23,8 @@ Or, if Bundler is not being used to manage dependencies:
 
 ## Usage
 
-First, obtain X credentials from <https://developer.x.com>.
+> [!NOTE]
+> First, obtain X credentials from <https://developer.x.com>.
 
 ```ruby
 require "x"

data/lib/x/connection.rb

@@ -13,7 +13,7 @@ module X
     DEFAULT_OPEN_TIMEOUT = 60 # seconds
     DEFAULT_READ_TIMEOUT = 60 # seconds
     DEFAULT_WRITE_TIMEOUT = 60 # seconds
-    DEFAULT_DEBUG_OUTPUT = File.open(File::NULL, "w")
+    DEFAULT_DEBUG_OUTPUT = File.open(IO::NULL, "w")
     NETWORK_ERRORS = [
       Errno::ECONNREFUSED,
       Errno::ECONNRESET,

data/lib/x/media_upload_validator.rb

@@ -0,0 +1,17 @@
+module X
+  module MediaUploadValidator
+    module_function
+
+    MEDIA_CATEGORIES = %w[dm_gif dm_image dm_video subtitles tweet_gif tweet_image tweet_video].freeze
+
+    def validate_file_path!(file_path:)
+      raise "File not found: #{file_path}" unless File.exist?(file_path)
+    end
+
+    def validate_media_category!(media_category:)
+      return if MEDIA_CATEGORIES.include?(media_category.downcase)
+
+      raise ArgumentError, "Invalid media_category: #{media_category}. Valid values: #{MEDIA_CATEGORIES.join(", ")}"
+    end
+  end
+end

data/lib/x/media_uploader.rb

@@ -1,6 +1,7 @@
 require "json"
 require "securerandom"
 require "tmpdir"
+require_relative "media_upload_validator"
 
 module X
   module MediaUploader
@@ -8,8 +9,7 @@ module X
 
     MAX_RETRIES = 3
     BYTES_PER_MB = 1_048_576
-    MEDIA_CATEGORIES = %w[dm_gif dm_image dm_video subtitles tweet_gif tweet_image tweet_video].freeze
-    DM_GIF, DM_IMAGE, DM_VIDEO, SUBTITLES, TWEET_GIF, TWEET_IMAGE, TWEET_VIDEO = MEDIA_CATEGORIES
+    DM_GIF, DM_IMAGE, DM_VIDEO, SUBTITLES, TWEET_GIF, TWEET_IMAGE, TWEET_VIDEO = MediaUploadValidator::MEDIA_CATEGORIES
     DEFAULT_MIME_TYPE = "application/octet-stream".freeze
     MIME_TYPES = %w[image/gif image/jpeg video/mp4 image/png application/x-subrip image/webp].freeze
     GIF_MIME_TYPE, JPEG_MIME_TYPE, MP4_MIME_TYPE, PNG_MIME_TYPE, SUBRIP_MIME_TYPE, WEBP_MIME_TYPE = MIME_TYPES
@@ -18,15 +18,21 @@ module X
     PROCESSING_INFO_STATES = %w[failed succeeded].freeze
 
     def upload(client:, file_path:, media_category:, boundary: SecureRandom.hex)
-      validate!(file_path:, media_category:)
-      upload_body = construct_upload_body(file_path:, media_category:, boundary:)
+      MediaUploadValidator.validate_file_path!(file_path:)
+      upload_binary(client:, content: File.binread(file_path), media_category:, boundary:)
+    end
+
+    def upload_binary(client:, content:, media_category:, boundary: SecureRandom.hex)
+      MediaUploadValidator.validate_media_category!(media_category:)
+      upload_body = construct_upload_body(content:, media_category:, boundary:)
       headers = {"Content-Type" => "multipart/form-data; boundary=#{boundary}"}
       client.post("media/upload", upload_body, headers:)&.fetch("data")
     end
 
     def chunked_upload(client:, file_path:, media_category:, media_type: infer_media_type(file_path, media_category),
       boundary: SecureRandom.hex, chunk_size_mb: 1)
-      validate!(file_path:, media_category:)
+      MediaUploadValidator.validate_file_path!(file_path:)
+      MediaUploadValidator.validate_media_category!(media_category:)
       media = init(client:, file_path:, media_type:, media_category:)
       chunk_size = chunk_size_mb * BYTES_PER_MB
       append(client:, file_paths: split(file_path, chunk_size), media:, boundary:)
@@ -51,14 +57,6 @@ module X
 
     private
 
-    def validate!(file_path:, media_category:)
-      raise "File not found: #{file_path}" unless File.exist?(file_path)
-
-      return if MEDIA_CATEGORIES.include?(media_category.downcase)
-
-      raise ArgumentError, "Invalid media_category: #{media_category}. Valid values: #{MEDIA_CATEGORIES.join(", ")}"
-    end
-
     def infer_media_type(file_path, media_category)
       case media_category.downcase
       when TWEET_GIF, DM_GIF then GIF_MIME_TYPE
@@ -87,7 +85,7 @@ module X
     def append(client:, file_paths:, media:, boundary: SecureRandom.hex)
       threads = file_paths.map.with_index do |file_path, index|
         Thread.new do
-          upload_body = construct_upload_body(file_path:, segment_index: index, boundary:)
+          upload_body = construct_upload_body(content: File.binread(file_path), segment_index: index, boundary:)
           headers = {"Content-Type" => "multipart/form-data; boundary=#{boundary}"}
           upload_chunk(client:, media_id: media["id"], upload_body:, file_path:, headers:)
         end
@@ -110,14 +108,14 @@ module X
       Dir.delete(dirname) if Dir.empty?(dirname)
     end
 
-    def construct_upload_body(file_path:, media_category: nil, segment_index: nil, boundary: SecureRandom.hex)
+    def construct_upload_body(content:, media_category: nil, segment_index: nil, boundary: SecureRandom.hex)
       body = ""
       body += "--#{boundary}\r\nContent-Disposition: form-data; name=\"segment_index\"\r\n\r\n#{segment_index}\r\n" if segment_index
       body += "--#{boundary}\r\nContent-Disposition: form-data; name=\"media_category\"\r\n\r\n#{media_category}\r\n" if media_category
       "#{body}--#{boundary}\r\n" \
-        "Content-Disposition: form-data; name=\"media\"; filename=\"#{File.basename(file_path)}\"\r\n" \
+        "Content-Disposition: form-data; name=\"media\"\r\n" \
         "Content-Type: #{DEFAULT_MIME_TYPE}\r\n\r\n" \
-        "#{File.binread(file_path)}\r\n" \
+        "#{content}\r\n" \
         "--#{boundary}--\r\n"
     end
   end

data/lib/x/oauth_authenticator.rb

@@ -1,5 +1,5 @@
 require "base64"
-require "cgi"
+require "cgi/escape"
 require "json"
 require "openssl"
 require "securerandom"

data/lib/x/request_builder.rb

@@ -38,14 +38,13 @@ module X
 
     def add_authentication(request:, authenticator:)
       authenticator.header(request).each do |key, value|
-        request.add_field(key, value)
+        request[key] = value
       end
     end
 
     def add_headers(request:, headers:)
       DEFAULT_HEADERS.merge(headers).each do |key, value|
-        request.delete(key)
-        request.add_field(key, value)
+        request[key] = value
       end
     end
 

data/lib/x/version.rb

@@ -1,5 +1,5 @@
 require "rubygems/version"
 
 module X
-  VERSION = Gem::Version.create("0.16.0")
+  VERSION = Gem::Version.create("0.17.0")
 end

data/sig/x.rbs

@@ -245,7 +245,6 @@ module X
   module MediaUploader
     MAX_RETRIES: Integer
     BYTES_PER_MB: Integer
-    MEDIA_CATEGORIES: Array[String]
     DM_GIF: String
     DM_IMAGE: String
     DM_VIDEO: String
@@ -266,12 +265,12 @@ module X
     extend MediaUploader
 
     def upload: (client: Client, file_path: String, media_category: String, ?boundary: String) -> untyped
+    def upload_binary: (client: Client, content: String, media_category: String, ?boundary: String) -> untyped
     def chunked_upload: (client: Client, file_path: String, media_category: String, ?media_type: String, ?boundary: String, ?chunk_size_mb: Integer) -> untyped
     def await_processing: (client: Client, media: untyped) -> untyped
     def await_processing!: (client: Client, media: untyped) -> untyped
 
     private
-    def validate!: (file_path: String, media_category: String) -> nil
     def infer_media_type: (String file_path, String media_category) -> String
     def split: (String file_path, Integer chunk_size) -> Array[String]
     def init: (client: Client, file_path: String, media_type: String, media_category: String) -> untyped
@@ -279,6 +278,14 @@ module X
     def upload_chunk: (client: Client, media_id: String, upload_body: String, file_path: String, ?headers: Hash[String, String]) -> Integer?
     def cleanup_file: (String file_path) -> Integer?
     def finalize: (client: Client, media: untyped) -> untyped
-    def construct_upload_body: (file_path: String, ?media_category: String, ?segment_index: Integer, ?boundary: String) -> String
+    def construct_upload_body: (content: String, ?media_category: String, ?segment_index: Integer, ?boundary: String) -> String
+  end
+
+  module MediaUploadValidator
+    MEDIA_CATEGORIES: Array[String]
+    extend MediaUploadValidator
+
+    def validate_file_path!: (file_path: String) -> nil
+    def validate_media_category!: (media_category: String) -> nil
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: x
 version: !ruby/object:Gem::Version
-  version: 0.16.0
+  version: 0.17.0
 platform: ruby
 authors:
 - Erik Berlin
@@ -59,6 +59,7 @@ files:
 - lib/x/errors/too_many_requests.rb
 - lib/x/errors/unauthorized.rb
 - lib/x/errors/unprocessable_entity.rb
+- lib/x/media_upload_validator.rb
 - lib/x/media_uploader.rb
 - lib/x/oauth_authenticator.rb
 - lib/x/rate_limit.rb