feed2gram 1.2.3 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24a46cff098342888e3997e1dadfc34a6e0526f979ea59b7b2e0687ecc1051e7
-  data.tar.gz: 63f1559288645c2bb02ddfbe45aa6edd55e5f76437f582f8aec9a12a2c1630fe
+  metadata.gz: 73e7d2df466144a3e956cc38742d783cce241a65894beaa90e7b332ee1b99ea6
+  data.tar.gz: 9b58a6e07f42adcae0b86969f01d84df77480e2db7831a6b98dd48ab67159ac1
 SHA512:
-  metadata.gz: e5eb07918977ad2d034609efbc2372ce3af65f9d75ef6d3766a3eb5db938b955fa3ebe5828091ffc56d0179a138fd433b06d314b3f58e537c71edb5e25ce6ba1
-  data.tar.gz: ad34cbae69b4148ecd5acb953018ef8bbd6c75e61e2fca50514f47a5ac31d061e167ed801e8182d5a735da93a91181b0a8f35175710203d7fa2e0f3a321f09ee
+  metadata.gz: a46c7e7ca41c516c88ed3f12fee71506a5b24f280dd784d53c787cc910027bebb3b37fda1f364ad6b8dd84e9d5460ee569c4e7ff3a2eb480195b3ce6a6ddb8a4
+  data.tar.gz: 4a1c63c08f0ddf6693e587f2a2bd78c94e1638cd68471f54a50cd1d1df4c67ac8fbb876a402ac9b8d63e018f20ad5c415ce90b0d487bfc26b1950524c3f07054

data/CHANGELOG.md

@@ -1,3 +1,13 @@
+## [1.3.0]
+
+* Add undocumented methods for using the gem as an API. I leave figuring out its
+usage as an exercise to the reader
+
+## [1.2.4]
+
+* When uploads fail, output a message that includes the error code
+(and the URL to look them up)
+
 ## [1.2.3]
 
 * Add a retry option after IG continues to fail to download videos correctly. See `RETRIES_AFTER_UPLOAD_TIMEOUT` (default 5 retries)

data/README.md

@@ -1,4 +1,7 @@
-# feed2gram
+# feed2gram - Syndicate your site's photos, videos, and carousels to Instagram
+
+**feed2gram is for automating Instagram posts, for posting to Threads, see
+[feed2thread](https://github.com/searls/feed2thread)**
 
 I've joined the [POSSE](https://indieweb.org/POSSE) and publish as much as I can
 to [justin.searls.co](https://justin.searls.co) and syndicate it elsewhere.  I'm
@@ -169,7 +172,7 @@ We publish a Docker image [using GitHub
 actions](https://github.com/searls/feed2gram/blob/main/.github/workflows/main.yml)
 tagged as `latest` for every new commit to the `main` branch, as well as with a
 release tag tracking every release of the gem on
-[rubygems.org](https://rubygems.org). The images are hosted [here on GitHub's
+[rubygems.org](https://rubygems.org/gems/feed2gram). The images are hosted [here on GitHub's
 container
 registry](https://github.com/searls/feed2gram/pkgs/container/feed2gram)
 

data/example/Gemfile

@@ -2,5 +2,6 @@ source "https://rubygems.org"
 
 gem "rackup"
 gem "sinatra"
+gem "standard"
 
 gem "feed2gram", path: ".."

data/lib/feed2gram/publishes_posts.rb

@@ -31,6 +31,79 @@ module Feed2Gram
       }
     end
 
+    # Pseudo-public "API mode"
+    def create_single_media_container(post, config)
+      media = post.medias.first
+      Http.post("/#{config.instagram_id}/media", {
+        :media_type => post.media_type,
+        :caption => post.caption,
+        :access_token => config.access_token,
+        :cover_url => media.cover_url,
+        media.video? ? :video_url : :image_url => media.url
+      }.compact)[:id]
+    end
+
+    # Pseudo-public "API mode"
+    def create_carousel_media_container(media, config)
+      res = Http.post("/#{config.instagram_id}/media", {
+        :media_type => media.media_type,
+        :is_carousel_item => true,
+        :access_token => config.access_token,
+        media.video? ? :video_url : :image_url => media.url
+      }.compact)
+      res[:id]
+    end
+
+    # Pseudo-public "API mode"
+    def create_carousel_container(post, media_containers, config)
+      Http.post("/#{config.instagram_id}/media", {
+        caption: post.caption,
+        media_type: post.media_type,
+        children: media_containers.join(","),
+        access_token: config.access_token
+      })[:id]
+    end
+
+    # Pseudo-public "API mode"
+    def upload_finished?(container_id, config)
+      res = Http.get("/#{container_id}", {
+        fields: "status_code,status",
+        access_token: config.access_token
+      })
+
+      if res[:status_code] == "FINISHED"
+        true
+      elsif res[:status_code] == "IN_PROGRESS"
+        false
+      else
+        raise <<~MSG
+          Unexpected status code (#{res[:status_code]}) uploading container: #{container_id}"
+
+          API sent back this: #{res[:status]}
+
+          Error codes can be looked up here: https://developers.facebook.com/docs/instagram-platform/instagram-graph-api/reference/error-codes/
+        MSG
+      end
+    end
+
+    # Pseudo-public "API mode"
+    def publish_container(container_id, config)
+      res = Http.post("/#{config.instagram_id}/media_publish", {
+        creation_id: container_id,
+        access_token: config.access_token
+      })
+      res[:id]
+    end
+
+    # Pseudo-public "API mode"
+    def get_media_permalink(media_id, config)
+      res = Http.get("/#{media_id}", {
+        fields: "permalink",
+        access_token: config.access_token
+      })
+      res[:permalink]
+    end
+
     private
 
     def retry_if_upload_times_out(times_remaining, post, options, &blk)
@@ -49,55 +122,35 @@ module Feed2Gram
       media = post.medias.first
 
       puts "Creating media resource for URL - #{media.url}" if options.verbose
-      container_id = Http.post("/#{config.instagram_id}/media", {
-        :media_type => post.media_type,
-        :caption => post.caption,
-        :access_token => config.access_token,
-        :cover_url => media.cover_url,
-        media.video? ? :video_url : :image_url => media.url
-      }.compact)[:id]
+      container_id = create_single_media_container(post, config)
 
       if media.video?
         wait_for_media_to_upload!(media.url, container_id, config, options)
       end
 
       puts "Publishing media for URL - #{media.url}" if options.verbose
-      Http.post("/#{config.instagram_id}/media_publish", {
-        creation_id: container_id,
-        access_token: config.access_token
-      })
+      publish_container(container_id, config)
       Result.new(post: post, status: :posted)
     end
 
     def publish_carousel(post, config, options)
       media_containers = post.medias.take(10).map { |media|
         puts "Creating media resource for URL - #{media.url}" if options.verbose
-        res = Http.post("/#{config.instagram_id}/media", {
-          :media_type => media.media_type,
-          :is_carousel_item => true,
-          :access_token => config.access_token,
-          media.video? ? :video_url : :image_url => media.url
-        }.compact)
-        res[:id]
+        create_carousel_media_container(media, config)
       }
-      post.medias.select(&:video?).zip(media_containers).each { |media, container_id|
-        wait_for_media_to_upload!(media.url, container_id, config, options)
+      post.medias.zip(media_containers).each { |media, container_id|
+        if media.video?
+          wait_for_media_to_upload!(media.url, container_id, config, options)
+        end
       }
 
       puts "Creating carousel media resource for post - #{post.url}" if options.verbose
-      carousel_id = Http.post("/#{config.instagram_id}/media", {
-        caption: post.caption,
-        media_type: post.media_type,
-        children: media_containers.join(","),
-        access_token: config.access_token
-      })[:id]
+      carousel_id = create_carousel_container(post, media_containers, config)
+
       wait_for_media_to_upload!(post.url, carousel_id, config, options)
 
       puts "Publishing carousel media for post - #{post.url}" if options.verbose
-      Http.post("/#{config.instagram_id}/media_publish", {
-        creation_id: carousel_id,
-        access_token: config.access_token
-      })
+      publish_container(carousel_id, config)
       Result.new(post: post, status: :posted)
     end
 
@@ -110,18 +163,16 @@ module Feed2Gram
           raise FacebookSucksAtDownloadingFilesError
         end
 
-        res = Http.get("/#{container_id}", {
-          fields: "status_code",
-          access_token: config.access_token
-        })
-        puts "Upload status #{res[:status_code]} after waiting #{wait_attempts * SECONDS_PER_UPLOAD_CHECK} seconds for IG to download #{url}" if options.verbose
-        if res[:status_code] == "FINISHED"
-          break
-        elsif res[:status_code] == "IN_PROGRESS"
-          wait_attempts += 1
-          sleep SECONDS_PER_UPLOAD_CHECK
-        else
-          warn "Unexpected status code (#{res[:status_code]}) uploading: #{url}"
+        begin
+          puts "Uploading after waiting #{wait_attempts * SECONDS_PER_UPLOAD_CHECK} seconds for IG to download #{url}" if options.verbose
+          if upload_finished?(container_id, config)
+            break
+          else
+            wait_attempts += 1
+            sleep SECONDS_PER_UPLOAD_CHECK
+          end
+        rescue => e
+          warn e.message
           break
         end
       end

data/lib/feed2gram/refreshes_token.rb

@@ -1,10 +1,22 @@
 module Feed2Gram
   class RefreshesToken
     def refresh!(config, options)
+      puts "Refreshing Facebook OAuth token" if options.verbose
+      new_access_token = call(config)
+      return unless new_access_token
+
+      config.access_token = new_access_token
+      config.access_token_refreshed_at = Time.now.utc
+
+      puts "Updating Facebook OAuth token in: #{options.config_path}" if options.verbose
+      File.write(options.config_path, config.as_yaml)
+    end
+
+    # "API mode"
+    def call(config)
       return unless config.access_token_refreshed_at.nil? ||
         config.access_token_refreshed_at < Time.now - (60 * 60)
 
-      puts "Refreshing Facebook OAuth token" if options.verbose
       data = Http.get("/oauth/access_token", {
         grant_type: "fb_exchange_token",
         client_id: config.facebook_app_id,
@@ -12,11 +24,7 @@ module Feed2Gram
         fb_exchange_token: config.access_token
       })
 
-      config.access_token = data[:access_token]
-      config.access_token_refreshed_at = Time.now.utc
-
-      puts "Updating Facebook OAuth token in: #{options.config_path}" if options.verbose
-      File.write(options.config_path, config.as_yaml)
+      data[:access_token]
     end
   end
 end

data/lib/feed2gram/version.rb

@@ -1,3 +1,3 @@
 module Feed2Gram
-  VERSION = "1.2.3"
+  VERSION = "1.3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: feed2gram
 version: !ruby/object:Gem::Version
-  version: 1.2.3
+  version: 1.3.0
 platform: ruby
 authors:
 - Justin Searls
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-05-07 00:00:00.000000000 Z
+date: 2024-10-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -77,7 +77,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.6
+rubygems_version: 3.5.11
 signing_key:
 specification_version: 4
 summary: Reads an Atom feed and posts its entries to Instagram