Add GitHub connector (move-coop#326)

* Add GitHub connector

* GitHub connector review updates

- Wraps GitHub 404 exception in custom Parsons error
- Defaults to loading all list items unless a page is specified
- Documentation and test updates

docs/github.rst

@@ -0,0 +1,52 @@
+GitHub
+======
+
+`GitHub <https://github.com>`_ is an online tool for software collaboration.
+
+.. note::
+   API Credentials
+      - If you have a GitHub account you can use your normal username and password to authenticate with the API.
+      - You can also use `a personal access token <https://docs.github.com/en/github/authenticating-to-github/creating-a-personal-access-token>`_.
+
+**********
+Quickstart
+**********
+
+**Get repo data**
+
+.. code-block:: python
+
+  from parsons import GitHub
+
+  github = GitHub()
+
+  # Get repo by its full name (account/name)
+  parsons_repo = github.get_repo("move-coop/parsons")
+
+**Get repo issues in a ``Table``**
+
+.. code-block:: python
+
+  from parsons import GitHub
+
+  github = GitHub()
+
+  # Get the first page of a repo's issues as a Table
+  parsons_issues_table = github.list_repo_issues("move-coop/parsons")
+
+**Download the contents of a repo file**
+
+.. code-block:: python
+
+  from parsons import GitHub
+
+  github = GitHub()
+
+  # Download Parsons README.md to local "/tmp/README.md"
+  parsons_readme_path = github.download_file("move-coop/parsons", "README.md", local_path="/tmp/README.md")
+
+===
+API
+===
+.. autoclass:: parsons.GitHub
+   :inherited-members:

docs/index.rst

@@ -178,6 +178,7 @@ Indices and tables
    databases
    facebook_ads
    freshdesk
+   github
    google
    hustle
    mailchimp

parsons/__init__.py

@@ -46,6 +46,7 @@
     from parsons.action_network.action_network import ActionNetwork
     from parsons.pdi.pdi import PDI
     from parsons.azure.azure_blob_storage import AzureBlobStorage
+    from parsons.github.github import GitHub
 
     __all__ = [
         'VAN',
@@ -86,6 +87,7 @@
         'ActionNetwork',
         'PDI',
         'AzureBlobStorage',
+        'GitHub',
     ]
 
 # Define the default logging config for Parsons and its submodules. For now the

parsons/github/__init__.py

@@ -0,0 +1,5 @@
+from parsons.github.github import GitHub
+
+__all__ = [
+    'GitHub'
+]