facebook-cli 1.6.1 → 1.6.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e73b653e961bb1c35903f400db8e71aa06d851e2
-  data.tar.gz: 2ef15430d063b9304b261981dc9603ceb22affb6
+  metadata.gz: 60d9c30c9452a91ea1f4a0dba2cfe4dbdc5aacab
+  data.tar.gz: ae1e56f576696173b59041215d60adabe4a58f8d
 SHA512:
-  metadata.gz: d34aed99693ee1f0a23aaba1bbfcc45535bf81f039f7783891118e8cb8c3c496a4ecee1412a74e3cd8a3230f8d8f0a05891f951e6c565cd886e44bbe44ac825e
-  data.tar.gz: f20b080c1116bf8d9314671756051a769d614e6ac7bf65c7c1cdd1ad46383652bb690e218853a802f254866c5f60c6b1f30c3e287a2d110f77ebaafae3d52106
+  metadata.gz: 18895ae4f97d5bb7a7f7716c3b123a07c6de1acfec8e5ee9804569f3bc08bfc87d56a42069e688cbf50f9806b21180809c5bf9ab6cbbd6a1376ce0aee8380f0c
+  data.tar.gz: f924eb53d4120dfd9b5fd9020652cf0192d34c9f873654406ec6a45ed728bbcb007f84c2fc47d0bebd3380135b20ed81de94f82724820f1680812cfac1683593

data/lib/fbcli.rb

@@ -16,7 +16,7 @@ program_desc "Facebook command line interface"
 version FBCLI::VERSION
 
 flag [:token], :desc => 'Provide Facebook access token', :required => false
-flag [:pages, :p], :desc => 'Max pages', :required => false, :type => Integer, :default_value => -1
+flag [:pages, :p], :desc => 'Maximum number of pages of results to retrieve', :required => false, :type => Integer, :default_value => -1
 
 def link(path)
   "https://www.facebook.com/#{path}"
@@ -84,10 +84,16 @@ You must create and configure a Facebook application to interact with the Graph
 
 - Create a new application at: https://developers.facebook.com/apps
 - In the Settings tab:
-  - Click "Add Platform" and select "Website"
-  - Set "Site URL" to "http://localhost"
   - Under "App Domains" add "localhost"
-  - Click "Save"
+  - Select a "Category" (any one will do)
+  - Click "Add Platform" and select "Website"
+  - Set "Site URL" to "http://localhost/"
+  - Click "Save Changes"
+- Under "PRODUCTS" in the left sidebar:
+  - Click "+ Add Product"
+  - Under "Client OAuth Settings", set "Use Strict Mode for Redirect URIs" to "No"
+  - Under "Valid OAuth redirect URIs", add: "http://localhost:3333/"
+  - Click "Save Changes"
 - In the "App Review" tab:
   - Flip the switch to make your app live
 - In the "Dashboard" tab:
@@ -122,33 +128,58 @@ command :config do |c|
 end
 
 desc "Request Facebook permissions and receive an API access token"
+long_desc %(
+  Print a URL that launches a request to Facebook to allow the app you've created (by
+  following the setup instructions) to perform Facebook Graph actions on your behalf,
+  and start an HTTP server to listen for the authorization code.
+
+  Upon receiving the authorization code, immediately trade it in for an access
+  token and save it to a configuration file.
+
+  See: https://www.oauth.com/oauth2-servers/access-tokens/
+
+  Attention: if you choose to listen for the authorization token on a port number
+  different from the default value, make sure that in your app settings the same
+  port is specified under:
+
+    PRODUCTS > Facebook Login > Client OAuth Settings > Valid OAuth redirect URIs
+)
 command :login do |c|
-  c.flag [:port], :desc => 'Local TCP port to serve Facebook login redirect page', :default_value => '3333'
+  c.flag [:port], :desc => 'Local TCP port to listen for authorization code', :default_value => '3333'
   c.switch [:info], :desc => 'Show information about the current access token and exit', :negatable => false
   c.action do |global_options, options|
     if options['info']
-      begin
-        FBCLI::request_token_info do |data|
-          puts "Your access token was issued on: #{date_str(data['issued_at'])}"
-          puts
-          puts "It is valid until: #{date_str(data['expires_at'])}"
+      if $config['access_token'].nil?
+        puts "Either provide an access token via the --token parameter or obtain one by running:"
+        puts
+        puts "  #{APP_NAME} login"
+      else
+        begin
+          puts "Your access token: #{$config['access_token']}"
           puts
-          puts "Permissions:\n  - #{data['scopes'].join("\n  - ")}"
+
+          FBCLI::request_token_info do |data|
+            puts "It was issued on: #{date_str(data['issued_at'])}"
+            puts
+            puts "It is valid until: #{date_str(data['expires_at'])}"
+            puts
+            puts "Permissions:\n  - #{data['scopes'].join("\n  - ")}"
+          end
+        rescue
+          puts "Your access token does not appear to be valid or may have expired."
         end
-      rescue
-        puts "Your access token does not appear to be valid for this application."
       end
     else
-      token = FBCLI::listen_for_auth_code(options['port'], $config['app_id'], $config['app_secret'])
+      token = FBCLI::login($config['app_id'], $config['app_secret'], options['port'])
 
       if not token.nil?
         $config['access_token'] = token
 
         save_config
 
-        puts "Your access token: #{token}"
+        puts "Your access token has been saved to #{CONFIG_FILE}"
         puts
-        puts "To find out when it is scheduled to expire, run:"
+        puts "To see it and find out when it is scheduled to expire, run:"
         puts
         puts "  #{APP_NAME} login --info"
         puts

data/lib/fbcli/auth.rb

@@ -6,9 +6,11 @@ require 'json'
 module FBCLI
   API_VERSION = "2.10"
 
-  def self.listen_for_auth_code(port, app_id, app_secret)
+  def self.login(app_id, app_secret, local_port)
+    redirect_uri = "http://localhost:#{local_port}/"
+
     uri = "https://www.facebook.com/dialog/oauth?client_id=#{app_id}" +
-      "&redirect_uri=http://localhost:#{port}/" +
+      "&redirect_uri=#{redirect_uri}" +
       "&scope=user_likes,user_friends,user_posts,user_photos,user_videos,user_events,publish_actions"
 
     puts <<-EOM
@@ -16,12 +18,12 @@ Open this URL in a web browser and allow access to the Facebook Graph on behalf
 
 #{uri}
 
-Waiting to receive authorization code on port #{port}...
+Waiting to receive authorization code on port #{local_port}...
 
     EOM
 
     server = WEBrick::HTTPServer.new(
-      :Port => port,
+      :Port => local_port,
       :SSLEnable => false,
       :Logger => WEBrick::Log.new(File.open(File::NULL, 'w')),
       :AccessLog => []
@@ -33,7 +35,10 @@ Waiting to receive authorization code on port #{port}...
       key, value = req.query_string.split '=', 2
 
       if key == "code"
-        access_token = get_access_token(port, app_id, value, app_secret)
+        puts "Received authorization code. Exchanging it for an access token..."
+        puts
+
+        access_token = get_access_token(app_id, value, app_secret, redirect_uri)
       else
         puts "Received unexpected request: #{req.query_string}"
       end
@@ -52,10 +57,15 @@ Waiting to receive authorization code on port #{port}...
     access_token
   end
 
-  def self.get_access_token(port, app_id, auth_code, app_secret)
+  def self.get_access_token(app_id, auth_code, app_secret, redirect_uri)
+    # The redirect_uri doesn't play the same role as in capturing the auth code, however
+    # it must match the one used in the previous case, otherwise the server will reject
+    # the request.
+    #
+    # See: https://www.oauth.com/oauth2-servers/access-tokens/authorization-code-request/
     auth_uri = "https://graph.facebook.com/v#{API_VERSION}/oauth/access_token?" +
       "client_id=#{app_id}" +
-      "&redirect_uri=http://localhost:#{port}/" +
+      "&redirect_uri=#{redirect_uri}" +
       "&client_secret=#{app_secret}" +
       "&code=#{auth_code}"
 

data/lib/fbcli/facebook.rb

@@ -48,9 +48,9 @@ Run: #{APP_NAME} login
     }
   end
 
-  def self.request_token_info
+  def self.request_token_info(access_token = $config['access_token'])
     api_call lambda { |api|
-      api.debug_token $config['access_token'] do |res|
+      api.debug_token access_token do |res|
         yield res['data']
       end
     }

data/lib/fbcli/version.rb

@@ -1,3 +1,3 @@
 module FBCLI
-  VERSION = '1.6.1'
+  VERSION = '1.6.2'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: facebook-cli
 version: !ruby/object:Gem::Version
-  version: 1.6.1
+  version: 1.6.2
 platform: ruby
 authors:
 - Ildar Sagdejev
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-10-05 00:00:00.000000000 Z
+date: 2017-10-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: koala