Add basic fetching, url/parameter/headers building

sources.py

@@ -1,6 +1,9 @@
 import abc
-from typing import Callable, List
+from datetime import date, datetime
+from pprint import pprint
+from typing import Any, Callable, Dict, List, Optional
 
+import requests
 from decouple import config
 
 from models import Commit
@@ -18,10 +21,44 @@ class CommitSource(abc.ABC):
 class Gitlab(CommitSource):
     """Serves as the commit source for GitLab."""
 
+    USERNAME_CONSTANT: str = 'GITLAB_USERNAME'
     API_KEY_CONSTANT: str = 'GITLAB_API_KEY'
 
     def __init__(self) -> None:
         self.__api_key: str = config(self.API_KEY_CONSTANT)
+        self.__username: str = config(self.USERNAME_CONSTANT)
+
+    @property
+    def url(self) -> str:
+        """Returns the request URL from which events will be sourced."""
+        return f"https://gitlab.com/api/v4/users/{self.__username}/events"
+
+    @property
+    def headers(self) -> Dict[str, str]:
+        """Returns the required headers for authoring API requests."""
+        return {
+            'PRIVATE-TOKEN': self.__api_key
+        }
 
     def fetch(self, check_function: Callable) -> List[Commit]:
-        pass
+        self.events(page=3)
+
+        return []
+
+    def events(self, action: Optional[str] = None, target_type: Optional[str] = None, before: Optional[date] = None,
+               after: Optional[date] = None, sort: Optional[str] = None, page: Optional[int] = None,
+               per_page: Optional[int] = None) -> List[Any]:
+        """Fetches events from GitLab's API given parameters"""
+
+        params = {'action': action, 'target_type': target_type, 'sort': sort, 'page': page, 'per_page': per_page}
+        if before: params['before'] = before.strftime('%Y-%m-%d')
+        if after: params['after'] = after.strftime('%Y-%m-%d')
+
+        params = {k: v for k, v in params.items() if v is not None}
+        response = requests.get(self.url, params=params, headers=self.headers)
+
+        pprint(params)
+
+        pprint(response.json())
+
+        return response.json()