facebook-cli 1.6.5 → 1.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 72a03921f7c2402bbbd1d00b355af91ea0ff73c1
-  data.tar.gz: 6bd6a91404c78fda14e0c279de752707ccd8c88c
+SHA256:
+  metadata.gz: 6e453ec054ccf4ef2a901ca0c570ce758b3cfcaf64ef7cb5cc42c0e4944919d0
+  data.tar.gz: 6bbbf180804564a3d7a2e7a8b263b91a6d2ca67ab8151266f1345859c0d1edc6
 SHA512:
-  metadata.gz: a621ff5e7aff3d16b1fba6ef61124a0087ecac1590390da666651e3b562e4cfad473bd6b3d4927553102b9e2fc191d8e9347772142f2251329d430cd371202f7
-  data.tar.gz: 8f30408b9453d17fc192df93abe02c9d72ffc49b4a26a5453cfeddfe545447871508b11774890886240a3bd8c9fa948865c9d7da5365b96f0cf04bfcce1c8621
+  metadata.gz: 87cb74cf0854847d6f3dffbb0cde58ac16b999b041542e61c6f7b0433b1872e2c7b27adecacb030cdb2057596cad3b00702776c4ae8824f7f49be3b3f60eec73
+  data.tar.gz: 16cdb09af9a35b37b0b3a6d7a170927a6fb19de7e3467f502fb9a4139e63314e3162d8bda4d62467d217f0b7068d4250fceeb0a1f12add92fad638113e12482e

data/lib/fbcli.rb

@@ -42,7 +42,7 @@ def save_config
 end
 
 pre do |global_options, command|
-  # Make options officially global
+  # Make global options officially global
   $global_options = global_options
 
   # Exit gracefully when terminating due to a broken pipe
@@ -71,6 +71,7 @@ Run `#{APP_NAME} config` for setup instructions.
   true
 end
 
+# Trap exceptions bubbling up from GLI and provide an alternative handler
 on_error do |exception|
   puts exception.message
 
@@ -202,37 +203,42 @@ command :logout do |c|
   end
 end
 
-desc "Make a Facebook API request"
+desc "Make a direct Facebook API request"
 arg_name "request"
 long_desc %(
-  This is similar to the online tool:
-
-    https://developers.facebook.com/tools/explorer
-
   For example, try:
 
-    #{APP_NAME} api "165795193558366?fields=name,about,website"
-
-  To view the list of valid fields you can request, ask for the metadata:
+    #{APP_NAME} api "me?fields=name,email,birthday"
 
-    #{APP_NAME} api "165795193558366?metadata=1"
+  To view the list of fields that can be queried:
 
-  Moreover, you can extract a value from the response using --get. For example:
+    #{APP_NAME} api "me?metadata=1"
 
-    #{APP_NAME} api --get name 165795193558366
+  Retrieve a specific value using --get:
 
-  Use JsonPath language to retrieve nested values. For example:
+    #{APP_NAME} api --get name me
 
-    #{APP_NAME} api --get "metadata.fields..name" "165795193558366?metadata=1"
+  Retrieve nested values using the JsonPath query language:
 
-  Some valid requests may not be honored or return incomplete results due to
-  insufficient permissions, which were established during the authentication
-  process.
+    #{APP_NAME} api --get "metadata.fields..name" "me?metadata=1"
 )
 command :api do |c|
-  c.flag [:get], :desc => "Extract a particular value from the JSON response"
+  c.flag [:get], :desc => "Extract a value from the JSON response by means of a JsonPath query"
   c.switch [:raw], :desc => 'Output unformatted JSON', :negatable => false
   c.action do |global_options, options, args|
+    # If no query provided, offer guidance
+    if args[0].nil? || args[0].empty?
+      # TODO: Show usage instructions
+      #
+      #  GLI provides a function help_now! which normally prints usage instructions and exits,
+      #  however the way it triggers that eventuality is by raising an option parser exception,
+      #  which in turn results in the default handler printing usage instructions. Unfortunately,
+      #  since facebook-cli provides an alternative exception handler and breaks that functionality,
+      #  it will take further engineering to effect the desired behavior.
+
+      exit_now! "See documentation: #{APP_NAME} help api"
+    end
+
     res = FBCLI::raw_request args[0]
 
     # Extract value(s) using JsonPath
@@ -246,7 +252,7 @@ command :api do |c|
       end
     end
 
-    # Nicely format JSON result if not --raw
+    # Nicely format JSON result if --raw flag is not set
     unless options['raw']
       # It appears that Hash and Koala::Facebook::API::GraphCollection objects
       # are JSON, while Array results are not.
@@ -299,75 +305,6 @@ command :links do |c|
   end
 end
 
-TO_FLAG_DESC = 'ID or alias of page or group to post to (use "me" for timeline)'
-TO_COMMAND_DESC = 'to your timeline, a page or a group'
-
-desc "Post a message or image " + TO_COMMAND_DESC
-arg_name "message"
-long_desc %(
-  Facebook recommends: photos should be less than 4 MB and saved as JPG, PNG, GIF or TIFF files.
-)
-command :post do |c|
-  c.flag [:to], :desc => TO_FLAG_DESC, :default_value => 'me'
-  c.flag [:i, :image], :desc => 'File or URL of image to post'
-  c.action do |global_options, options, args|
-    if not options['image'].nil?
-      full_post_id = FBCLI::publish_image options['to'], args[0], options['image']
-    else
-      full_post_id = FBCLI::publish_post options['to'], args[0]
-    end
-
-    puts "Your post: #{link_to_post full_post_id}"
-  end
-end
-
-desc "Post a video " + TO_COMMAND_DESC
-arg_name "message"
-long_desc %(
-  Facebook recommends: aspect ratio must be between 9x16 and 16x9. The following formats are
-  supported:
-
-  3g2, 3gp, 3gpp, asf, avi, dat, divx, dv, f4v, flv, m2ts, m4v,
-  mkv, mod, mov, mp4, mpe, mpeg, mpeg4, mpg, mts, nsv, ogm, ogv, qt, tod,
-  ts, vob, and wmv
-)
-command :postvideo do |c|
-  c.flag [:to], :desc => TO_FLAG_DESC, :default_value => 'me'
-  c.flag [:v, :video], :desc => 'File or URL of video'
-  c.flag [:t, :title], :desc => 'Title'
-  c.action do |global_options, options, args|
-    video_id = FBCLI::publish_video options['to'], args[0], options['video'], options['title']
-    puts "Your post: #{link video_id}"
-    puts "Edit your video: #{link "video/edit/?v=#{video_id}"}"
-    puts
-    puts "It might take a few minutes for your video to become available."
-  end
-end
-
-desc "Post a link " + TO_COMMAND_DESC
-arg_name "url"
-command :postlink do |c|
-  c.flag [:to], :desc => TO_FLAG_DESC, :default_value => 'me'
-  c.flag [:m, :message], :desc => 'Main message'
-  c.flag [:n, :name], :desc => 'Link name'
-  c.flag [:d, :description], :desc => 'Link description'
-  c.flag [:c, :caption], :desc => 'Link caption'
-  c.flag [:i, :image], :desc => 'Link image URL'
-  c.action do |global_options, options, args|
-    link_metadata = {
-      "name" => options['name'],
-      "link" => args[0],
-      "caption" => options['caption'],
-      "description" => options['description'],
-      "picture" => options['image']
-    }
-
-    full_post_id = FBCLI::publish_post options['to'], options['message'], link_metadata
-
-    puts "Your post: #{link_to_post full_post_id}"
-  end
-end
-
 desc "List pages you have 'Liked'"
 command :likes do |c|
   c.action do
@@ -378,23 +315,7 @@ command :likes do |c|
   end
 end
 
-desc "List people you are friends with (some limitations)"
-long_desc %(
-  As of Graph API v2.0 Facebook no longer provides access to your full friends list.
-  As an alternative, we now request 'taggable_friends' which only includes friends
-  you are allowed to tag.
-
-  See: https://developers.facebook.com/docs/apps/faq#faq_1694316010830088
-)
-command :friends do |c|
-  c.action do
-    FBCLI::page_items 'taggable_friends' do |item|
-      puts item['name']
-    end
-  end
-end
-
-desc "List posts on your profile"
+desc "List posts on your timeline"
 command :feed do |c|
   c.action do
     FBCLI::page_items "feed", '- - -' do |item|
@@ -406,23 +327,6 @@ command :feed do |c|
   end
 end
 
-desc "List stories you are tagged in"
-command :tagged do |c|
-  c.switch [:date], :desc => 'Include date you were tagged on'
-  c.action do |global_options, options|
-    FBCLI::page_items 'tagged', '- - -' do |item|
-      if item["story"]
-        puts "### #{item["story"]}"
-        puts
-      end
-      puts item["message"] if item.has_key?("message")
-      puts
-      puts link_to_post item["id"]
-      puts "Tagged on: #{date_str(item["tagged_time"])}" if options['date']
-    end
-  end
-end
-
 handlePhoto = Proc.new do |item|
   puts "#{item["name"]}\n\n" unless not item.key?("name")
   puts link "#{item["id"]}"
@@ -463,86 +367,4 @@ command :videosof do |c|
   end
 end
 
-def list_events(past = false)
-  now = Time.new
-
-  filter = lambda { |item|
-    starts = Time.parse(item['start_time'])
-    not ((past and starts < now) ^ (not past and starts > now))
-  }
-
-  FBCLI::page_items "events", '- - -', filter do |item|
-    starts = Time.parse(item['start_time'])
-
-    unless item['end_time'].nil?
-      ends = Time.parse(item['end_time'])
-      duration = ends - starts
-    end
-
-    puts "#{item['name']} (#{item['id']})"
-    puts
-    puts "Location: #{item['place']['name']}" unless item['place'].nil?
-    puts "Date: #{date_str(item['start_time'])}"
-    puts "Duration: #{duration / 3600} hours" if defined?(duration) and not duration.nil?
-    puts "RSVP: #{item['rsvp_status'].sub(/unsure/, 'maybe')}"
-    puts
-    puts link "events/#{item['id']}"
-  end
-end
-
-desc "List your upcoming events"
-command :events do |c|
-  c.action do
-    list_events
-  end
-end
-
-desc "List your past events"
-command :pastevents do |c|
-  c.action do
-    list_events true
-  end
-end
-
-desc "Show event details"
-arg_name "[ids...]"
-command :event do |c|
-  c.action do |global_options, options, args|
-    args.each_with_index do |id, index|
-      FBCLI::request_object(
-        id,
-        :fields => 'name,description,place,owner,start_time,end_time,attending_count,declined_count,maybe_count,is_canceled'
-      ) do |item|
-        starts = Time.parse(item['start_time'])
-
-        unless item['end_time'].nil?
-          ends = Time.parse(item['end_time'])
-          duration = ends - starts
-        end
-
-        puts "#{item['name']} (#{item['id']})"
-
-        puts
-        puts "Location: #{item['place']['name']}" unless item['place'].nil?
-        puts "Date: #{date_str(item['start_time'])}" + (item['is_canceled'] ? " [CANCELED]" : "")
-        puts "Duration: #{duration / 3600} hours" if defined?(duration) and not duration.nil?
-        puts "Created by: #{item['owner']['name']}"
-        puts
-        puts "Attending: #{item['attending_count']}"
-        puts "Maybe: #{item['maybe_count']}"
-        puts "Declined: #{item['declined_count']}"
-        puts
-        puts link "events/#{item['id']}"
-
-        if not (item['description'].nil? || item['description'].empty?)
-          puts
-          puts item['description']
-        end
-
-        puts "- - -" unless index == args.size - 1
-      end
-    end
-  end
-end
-
 exit run(ARGV)

data/lib/fbcli/api.rb

@@ -93,28 +93,4 @@ Run: #{APP_NAME} login
       items = items.next_page
     end
   end
-
-  def self.publish_post(target, msg, link_metadata = {})
-    result = api_call lambda { |api|
-      api.put_wall_post(msg, link_metadata, target)
-    }
-
-    result['id']
-  end
-
-  def self.publish_image(target, msg, image_file_or_url)
-    result = api_call lambda { |api|
-      api.put_picture(image_file_or_url, {:message => msg}, target)
-    }
-
-    result['post_id']
-  end
-
-  def self.publish_video(target, msg, video_file_or_url, title = nil)
-    result = api_call lambda { |api|
-      api.put_video(video_file_or_url, {:title => title, :description => msg}, target)
-    }
-
-    result['id']
-  end
 end

data/lib/fbcli/auth.rb

@@ -1,17 +1,18 @@
 require 'net/http'
 require 'uri'
 require 'webrick'
+require 'webrick/https'
 require 'json'
 
 module FBCLI
-  API_VERSION = "2.10"
+  API_VERSION = "3.1"
 
   def self.login(app_id, app_secret, local_host, local_port)
-    redirect_uri = "http://#{local_host}:#{local_port}/"
+    redirect_uri = "https://#{local_host}:#{local_port}/"
 
     uri = "https://www.facebook.com/dialog/oauth?client_id=#{app_id}" +
       "&redirect_uri=#{redirect_uri}" +
-      "&scope=user_likes,user_friends,user_posts,user_photos,user_videos,user_events,publish_actions"
+      "&scope=user_likes,user_posts,user_photos,user_videos"
 
     puts <<-EOM
 Open this URL in a web browser and allow access to the Facebook Graph on behalf of your user account:
@@ -24,11 +25,21 @@ Waiting to receive authorization code on port #{local_port}...
 
     server = WEBrick::HTTPServer.new(
       :Port => local_port,
-      :SSLEnable => false,
+      :SSLEnable => true,
+      :SSLCertName => [ %w[CN localhost] ],
       :Logger => WEBrick::Log.new(File.open(File::NULL, 'w')),
       :AccessLog => []
     )
 
+    # TODO: WEBrick generates a self-signed SSL certificate with serial number 1, which
+    #       causes Firefox to complain with SEC_ERROR_REUSED_ISSUER_AND_SERIAL on the
+    #       second authentication attempt.
+    #
+    #       See: https://github.com/ruby/webrick/blob/6e9081b/lib/webrick/ssl.rb#L112
+    #
+    #       Providing a self-signed certificate to WEBrick during instantiation is one
+    #       way to surmount this inconvenience.
+
     access_token = nil
 
     server.mount_proc '/' do |req, res|

data/lib/fbcli/version.rb

@@ -1,3 +1,3 @@
 module FBCLI
-  VERSION = '1.6.5'
+  VERSION = '1.7.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: facebook-cli
 version: !ruby/object:Gem::Version
-  version: 1.6.5
+  version: 1.7.1
 platform: ruby
 authors:
 - Ildar Sagdejev
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-10-31 00:00:00.000000000 Z
+date: 2018-08-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: koala
@@ -98,7 +98,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.11
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: Facebook command line utility