Add basic Python library

Author: LinkofOrigin

libraries/python/.gitignore

@@ -1,4 +1,10 @@
+# Ignore implementation testing files
+main.py
+requirements*
+
+#
 # Sourced from: https://github.com/github/gitignore/blob/main/Python.gitignore
+#
 
 # Byte-compiled / optimized / DLL files
 __pycache__/

libraries/python/README.md

@@ -0,0 +1,42 @@
+# Python Library for IGDB
+
+A Python library for interacting with IGDB - a database of video game data. This library assists with authentication via Twitch and making requests to IGDB.
+
+## Usage
+
+First you will need to acquire credentials from the Twitch API in order to call IGDB. Once you have a valid API token, you can call IGDB for data.
+
+### Examples
+
+Get an API token from Twitch and prepare to build an IGDB request.
+print("Getting secrets from file/env")
+
+```python
+# Setup your imports as needed
+from igdb_api import igdb
+from twitch import twitch_oauth
+import json
+
+#...
+
+def test_igdb():
+    # Retrieve your secrets from a secure environment!
+    client_id = 'CLIENT_ID'
+    client_secret = 'CLIENT_SECRET'
+
+    # Utilize Twitch's OAuth API to acquire an access token
+    twitch = twitch_oauth.TwitchOauth()
+    token_response = twitch.request_oauth_token(client_id, client_secret)
+    oauth_token = token_response["access_token"]
+
+    # Prepare to make a request to IGDB using your client ID and newly-acquired access token
+    api = igdb.IGDB(client_id, oauth_token)
+    
+    # Get the name and release date of a single game returned from the API
+    endpoint = "games"
+    query = "fields name, release_dates; limit 1;"
+
+    # Make the API request -> returns a JSON object
+    api_response = api.make_request(endpoint, query)
+    print(api_response)
+```

libraries/python/igdb_api/__init__.py

@@ -0,0 +1,55 @@
+# Note that IGDB provides their own Python implementation of this library,
+# so my implementation is largely based on theirs: https://github.com/twitchtv/igdb-api-python/blob/master/src/igdb/wrapper.py
+
+from requests import post
+
+API_ROOT = "https://api.igdb.com"
+API_VERSION = "v4"
+
+class IGDB:
+    def __init__(self, client_id: str, api_token: str):
+        self.client_id = client_id
+        self.api_token = api_token
+    
+    
+    def make_request(self, endpoint: str, query: str) -> bytes:
+        print("Attempting to make request to IGDB")
+        endpoint_url = IGDB.build_endpoint_url(endpoint)
+        request_params = self.build_request_params(query)
+        
+        print(f"url={endpoint_url} | params={request_params}")
+        response = post(endpoint_url, **request_params)
+        response.raise_for_status()
+        
+        print("Successfully retrieved response from IGDB!")
+        
+        return response.json()
+    
+    
+    def build_request_params(self, query: str) -> dict:
+        request = {}
+        request['headers'] = self.build_headers_for_request()
+        request['data'] = query
+        return request
+    
+    
+    @staticmethod
+    def build_endpoint_url(endpoint: str) -> str:
+        base_url = IGDB.get_base_url()
+        endpoint_url = "/".join([base_url, endpoint])
+        return endpoint_url
+    
+    
+    @staticmethod
+    def get_base_url() -> str:
+        base_url = "/".join([API_ROOT, API_VERSION])
+        return base_url
+    
+    
+    def build_headers_for_request(self) -> dict:
+        headers = {
+            "Client-ID": self.client_id,
+            "Authorization": f"Bearer {self.api_token}",
+            "Accept": "application/json",
+        }
+        return headers

libraries/python/igdb_api/igdb.py

@@ -0,0 +1,64 @@
+
+from requests import post, get
+
+TWITCH_API_ROOT = "https://id.twitch.tv/"
+TWITCH_API_OAUTH_TOKEN = "oauth2/token"
+TWITCH_API_OAUTH_VALIDATE = "oauth2/validate"
+
+class TwitchOauth:
+    
+    def request_oauth_token(self, client_id: str, client_secret: str) -> dict:
+        print("Attempting to retrieve a new access token")
+        params = {
+            "client_id": client_id,
+            "client_secret": client_secret,
+            "grant_type": "client_credentials",
+        }
+        
+        headers = {
+            "Content-Type": "application/json; charset=UTF-8",
+        }
+        
+        request_params = {
+            "headers": headers,
+            "params": params,
+        }
+        
+        token_url = TwitchOauth.build_token_url()
+        response = post(token_url, **request_params)
+        response.raise_for_status()
+        
+        print("Successfully retrieved new access token!")
+        response_data = response.json()
+        return response_data
+    
+    
+    def validate_access_token(self, token) -> dict:
+        print("Attempting to validate access token")
+        headers = {
+            "Authorization": f"Oauth {token}",
+        }
+        
+        request_params = {
+            "headers": headers,
+        }
+        
+        token_url = TwitchOauth.build_token_url()
+        response = get(token_url, **request_params)
+        response.raise_for_status()
+        
+        print("Validated access token")
+        response_data = response.json()
+        return response_data
+    
+    
+    @staticmethod
+    def build_token_url() -> str:
+        oauth_token_url = "".join([TWITCH_API_ROOT, TWITCH_API_OAUTH_TOKEN])
+        return oauth_token_url
+    
+    
+    @staticmethod
+    def build_validate_url() -> str:
+        validate_url = "".join([TWITCH_API_ROOT, TWITCH_API_OAUTH_VALIDATE])
+        return validate_url