feed2gram 1.2.4 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3cafa61ecf677b96b07c3d83aa855d165dcbeb95c34c550b335ae605e6103734
-  data.tar.gz: 6bb6d2b824e81d738e28cdf143e4278a0979e1a40b03d064e04370478a12328a
+  metadata.gz: 73e7d2df466144a3e956cc38742d783cce241a65894beaa90e7b332ee1b99ea6
+  data.tar.gz: 9b58a6e07f42adcae0b86969f01d84df77480e2db7831a6b98dd48ab67159ac1
 SHA512:
-  metadata.gz: 47f0207f0c8da0e90ef63b176f5a1c9bbff08d9da467028b58a1bb4a54177d2b72ce9a8419d0b00372e53b0ae4180051cd95cb69de0f2373b5b029db55581359
-  data.tar.gz: 98af19289a16b92af530000d32275aa5a471a70024c0fa88b7749bcb4e07046f2eafed9f041f9f35b3072af2e130c81ee403f7468a6400ea04926afc48be983b
+  metadata.gz: a46c7e7ca41c516c88ed3f12fee71506a5b24f280dd784d53c787cc910027bebb3b37fda1f364ad6b8dd84e9d5460ee569c4e7ff3a2eb480195b3ce6a6ddb8a4
+  data.tar.gz: 4a1c63c08f0ddf6693e587f2a2bd78c94e1638cd68471f54a50cd1d1df4c67ac8fbb876a402ac9b8d63e018f20ad5c415ce90b0d487bfc26b1950524c3f07054

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+## [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

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,24 +163,16 @@ module Feed2Gram
           raise FacebookSucksAtDownloadingFilesError
         end
 
-        res = Http.get("/#{container_id}", {
-          fields: "status_code,status",
-          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 <<~MSG
-            Unexpected status code (#{res[:status_code]}) uploading: #{url}"
-
-            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
+        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.4"
+  VERSION = "1.3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: feed2gram
 version: !ruby/object:Gem::Version
-  version: 1.2.4
+  version: 1.3.0
 platform: ruby
 authors:
 - Justin Searls
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-08-14 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.14
+rubygems_version: 3.5.11
 signing_key:
 specification_version: 4
 summary: Reads an Atom feed and posts its entries to Instagram