twitch_oauth2 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3dafbbd8897dad15761967a8ff1d9842438948cc88c753955e1d3c121b0fb4f8
-  data.tar.gz: 1cad9f6de68da7ab3f0052aab03f57dac98122b0e542dae33f75a29d7a379462
+  metadata.gz: 2d1f094b1681b2963cb183234ade2f76b29b32b719c9fd35a591ceede9574238
+  data.tar.gz: a29358eda7e23e9bcfeeff0dd8c0398e59cd7343045fba050609daf18d47934f
 SHA512:
-  metadata.gz: e0736d7951b1ad4c0faa6b8b582fd22966096a8bd7b038996e104c0414ae80903f27653adf8e9b6a71c663c6f795cc138ae544905ff45067b8d9f26fb61f6990
-  data.tar.gz: 94e1bad7e2b47eaf0d2dce14e73f7a08a1525e0b9bffa788789f66a428a4bbe9e18e71b338dd3de4a7d1cc8db4a792329096ab0f6e691354c47b655821153c2b
+  metadata.gz: 8e0786a7b94aad31eff0f7dcc9c0c4600c0dcb229592864b9d74cc73482ca984179194eeb3fc29218df16f1d17133e13289064f6ea4e273e4615ceacdb59d64d
+  data.tar.gz: e37c722c4afbe51870734fac69e9af8e133ee9fd7dea600c2297b3e20b3be72f4b6a67ac64ceff20a8798d68cab841f8d44a1b212de7bef1fd8a33119c7a3dda

data/CHANGELOG.md

@@ -2,8 +2,14 @@
 
 ## master (unreleased)
 
+## 0.3.0 (2020-12-05)
+
 ## 0.2.0 (2020-11-05)
 
+*   Add an ability to generate Application tokens.
+    Useful for the actual, Helix, Twitch API.
+*   Update dependencies.
+
 ## 0.1.0 (2020-05-23)
 
 *   Initial release

data/README.md

@@ -71,8 +71,16 @@ You can pass nothing to `#check_tokens`, then client will generate new ones.
 If you've specified `:token_type` as `:application` or have not specify it at all (default),
 there will be an Application Access Token (without refresh token).
 
-Otherwise, for User Access Token you will be asked to open a Twitch link in a browser
-and login as user for whom tokens are intended.
+Otherwise, for User Access Token here will be raised a `TwitchOAuth2::Error` with Twitch link
+inside `#metadata[:link]`.
+
+If you have a web-application with N users, you can redirect them to this link
+and use `redirect_uri` to your application for callbacks.
+
+Otherwise, if you have something like CLI tool, you can print instructions with a link for user.
+
+Then you can use `#token(token_type: :user, code: 'a code from params in redirect uri')`
+and get your `:access_token` and `:refresh_token`.
 
 #### Reusing tokens
 

data/lib/twitch_oauth2/client.rb

@@ -46,26 +46,29 @@ module TwitchOAuth2
 			refresh(refresh_token: refresh_token).slice(:access_token, :refresh_token)
 		end
 
-		private
+		def token(token_type:, code: nil)
+			response = CONNECTION.post(
+				'token',
+				client_id: @client_id,
+				client_secret: @client_secret,
+				code: code,
+				grant_type: grant_type_by_token_type(token_type),
+				redirect_uri: @redirect_uri
+			)
 
-		def flow(token_type:)
-			code = request_code if token_type == :user
+			return response.body if response.success?
 
-			token(code: code, token_type: token_type).slice(:access_token, :refresh_token)
+			raise Error, response.body[:message]
 		end
 
-		def request_code
-			link = authorize
+		private
 
-			puts <<~TEXT
-				1. Open URL in your browser:
-					#{link}
-				2. Login to Twitch.
-				3. Copy the `code` parameter from redirected URL.
-				4. Insert below:
-			TEXT
+		def flow(token_type:)
+			if token_type == :user
+				raise Error.new('Use `error.metadata[:link]` for getting new tokens', link: authorize)
+			end
 
-			$stdin.gets.chomp
+			token(token_type: token_type).slice(:access_token, :refresh_token)
 		end
 
 		def authorize
@@ -83,21 +86,6 @@ module TwitchOAuth2
 			raise Error, response.body[:message]
 		end
 
-		def token(code:, token_type:)
-			response = CONNECTION.post(
-				'token',
-				client_id: @client_id,
-				client_secret: @client_secret,
-				code: code,
-				grant_type: grant_type_by_token_type(token_type),
-				redirect_uri: @redirect_uri
-			)
-
-			return response.body if response.success?
-
-			raise Error, response.body[:message]
-		end
-
 		def grant_type_by_token_type(token_type)
 			case token_type
 			when :user then :authorization_code

data/lib/twitch_oauth2/error.rb

@@ -1,6 +1,14 @@
 # frozen_string_literal: true
 
 module TwitchOAuth2
+	## Error during Twitch OAuth2 operations
 	class Error < StandardError
+		attr_reader :metadata
+
+		def initialize(message, metadata = {})
+			super message
+
+			@metadata = metadata
+		end
 	end
 end

data/lib/twitch_oauth2/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TwitchOAuth2
-	VERSION = '0.2.0'
+	VERSION = '0.3.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: twitch_oauth2
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Alexander Popov
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-11-04 00:00:00.000000000 Z
+date: 2020-12-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -72,14 +72,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.5.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.5.0
 - !ruby/object:Gem::Dependency
   name: toys
   requirement: !ruby/object:Gem::Requirement
@@ -128,14 +128,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.19.0
+        version: 0.20.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.19.0
+        version: 0.20.0
 - !ruby/object:Gem::Dependency
   name: vcr
   requirement: !ruby/object:Gem::Requirement
@@ -156,14 +156,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.93.1
+        version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.93.1
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: rubocop-performance
   requirement: !ruby/object:Gem::Requirement
@@ -184,14 +184,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.44'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.44'
+        version: '2.0'
 description: |
   Twitch authentication with OAuth 2.
   Result tokens can be used for API libraries, chat libraries