opossum 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 721a81517304c17e172662c5fbd1e055dd3d218658749d04efd02191cb866eb6
-  data.tar.gz: 006cdb6681a963740d03d62dd566f2a3323027556dacc8591afc6c3e8732fcc6
+  metadata.gz: df8e444fc778cd27c93ecb9883823ab6efb78ca246de662197c541c07d09b374
+  data.tar.gz: 464802dcd3a9a0451ad5a91c6d742e84c74e3be304e23dac96b6300a7c0faf59
 SHA512:
-  metadata.gz: 23a6aa7fe4861ca4c62eb3a293fe4d507c2b33d479253b1340cddf561f97a43827170fa29d4b7a8f3db2b72fc739a3423fea49645d88ede37f0b443e5fd47170
-  data.tar.gz: 7ce15a3f0382aa0b57671c6aa62fc53f1dec2c214e52a90bfec640f2ef2d8fb209d64d42c26abc5f28d2bbc01090979f6ca25136078e0d6a3772fd55ba3402cb
+  metadata.gz: 4002dbb64d04fee6b4e59b97f597c9ddc627b03952f7e8bc9330cab6895d217e345e34047a7251e7336453e39e0e38e29ab5e348ca12e91945390338e420d221
+  data.tar.gz: 4047063fac5fd46c4fb3edeb450fc81c6c13bbbf3712a50088ad66d90b7f7a36768e33d44aafe9dcc9c5630e38a80f62e8e48c8be51b32297bb0d8a8a890dbf1

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [0.5.0] - 2026-10-12
+
+### Added
+- **Alt text** - `Publisher#publish_media` accepts `alt_text:`
+  - A `String` for a single image, or an `Array` parallel to `media_url` for a carousel
+  - Sent as `alt_text` on `IMAGE` containers only (Instagram does not support it on videos, reels or stories); blank values are omitted
+
 ## [0.4.0] - 2026-10-06
 
 ### Added

data/README.md

@@ -121,6 +121,20 @@ result = publisher.publish_media(
   caption: 'Photo collection from my trip ✈️ #travel #memories'
 )
 
+# Publish image with alt text (accessibility; images only)
+result = publisher.publish_media(
+  media_url: 'https://example.com/image.jpg',
+  media_type: 'IMAGE',
+  alt_text: 'Team photo at the rally'
+)
+
+# Publish carousel with per-image alt text (array parallel to media_url, nil to skip one)
+result = publisher.publish_media(
+  media_url: ['https://example.com/image1.jpg', 'https://example.com/image2.jpg'],
+  media_type: 'CAROUSEL',
+  alt_text: ['Team photo at the rally', nil]
+)
+
 # Publish a story (media_format picks image_url vs video_url; default is VIDEO)
 result = publisher.publish_media(
   media_url: 'https://example.com/story.jpg',

data/lib/opossum/publisher.rb

@@ -14,10 +14,14 @@ module Opossum
 
     # media_format applies to STORIES only: "IMAGE" sends the url as image_url,
     # "VIDEO" (the default) as video_url. Other media types ignore it.
-    def publish_media(media_url:, media_type: "IMAGE", caption: nil, media_format: nil)
+    #
+    # alt_text is sent only for image containers (Instagram ignores it on
+    # videos, reels and stories): a String for a single image, or an Array
+    # parallel to media_url for a carousel (nil entries are skipped).
+    def publish_media(media_url:, media_type: "IMAGE", caption: nil, media_format: nil, alt_text: nil)
       path = "#{INSTAGRAM_GRAPH_API_ENDPOINT}/#{GRAPH_API_VERSION}/#{ig_id}/media_publish"
       media_container_id = prepare_media_container(media_url: media_url, media_type: media_type, caption: caption,
-                                                   media_format: media_format)
+                                                   media_format: media_format, alt_text: alt_text)
 
       ApiHelper.post(
         path: path,
@@ -29,19 +33,20 @@ module Opossum
 
     attr_reader :ig_id
 
-    def prepare_media_container(media_url:, media_type:, caption:, media_format: nil)
+    def prepare_media_container(media_url:, media_type:, caption:, media_format: nil, alt_text: nil)
       if media_url.is_a?(Array)
-        prepare_carousel_media(media_urls: media_url, media_type: media_type, caption: caption)
+        prepare_carousel_media(media_urls: media_url, media_type: media_type, caption: caption,
+                               alt_texts: Array(alt_text))
       else
         create_media_container(media_url: media_url, media_type: media_type, caption: caption,
-                               media_format: media_format)
+                               media_format: media_format, alt_text: alt_text)
       end
     end
 
-    def prepare_carousel_media(media_urls:, media_type:, caption:)
-      threads = media_urls.map do |url|
+    def prepare_carousel_media(media_urls:, media_type:, caption:, alt_texts: [])
+      threads = media_urls.each_with_index.map do |url, index|
         Thread.new do
-          create_media_container(media_url: url, is_carousel_item: true, caption: caption)
+          create_media_container(media_url: url, is_carousel_item: true, caption: caption, alt_text: alt_texts[index])
         end
       end
 
@@ -50,7 +55,7 @@ module Opossum
       create_media_container(media_url: children_ids, media_type: media_type, caption: caption)
     end
 
-    # options: is_carousel_item:, upload_type:, media_format:
+    # options: is_carousel_item:, upload_type:, media_format:, alt_text:
     def create_media_container(media_url:, media_type: "IMAGE", caption: nil, **options)
       path = "#{INSTAGRAM_GRAPH_API_ENDPOINT}/#{GRAPH_API_VERSION}/#{ig_id}/media"
       body = build_media_container_body(media_url: media_url, media_type: media_type, caption: caption, **options)
@@ -67,9 +72,14 @@ module Opossum
       set_media_url_field(body, media_url, media_type, options[:media_format])
       body[:is_carousel_item] = options[:is_carousel_item] if options[:is_carousel_item]
       body[:upload_type] = options[:upload_type] if options[:upload_type]
+      body[:alt_text] = options[:alt_text] if alt_text_applicable?(media_type, options[:alt_text])
       body
     end
 
+    def alt_text_applicable?(media_type, alt_text)
+      media_type == "IMAGE" && !alt_text.nil? && !alt_text.to_s.strip.empty?
+    end
+
     def set_media_url_field(body, media_url, media_type, media_format = nil)
       case media_type
       when "IMAGE"

data/lib/opossum/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Opossum
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: opossum
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Vadym Kruchyna
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-06 00:00:00.000000000 Z
+date: 2026-10-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday