Initial commit for license feature

Issue: #433

Added ability to retrieve license by name

Added integration test for MIT license

Added ability to retrieve repository's license

Author: itsmemattchung

github3/github.py

@@ -25,6 +25,7 @@
 from .structs import SearchIterator
 from .users import User, Key
 from .notifications import Thread
+from .licenses import License
 from uritemplate import URITemplate
 
 
@@ -699,6 +700,26 @@ def keys(self, number=-1, etag=None):
         url = self._build_url('user', 'keys')
         return self._iter(int(number), url, Key, etag=etag)
 
+    def license(self, name):
+        """Retrieve the license specified by the name.
+
+        :param string name: (required), name of license
+        :returns: :class:`License <github3.licenses.License>`
+        """
+
+        url = self._build_url('licenses', name)
+        json = self._json(self._get(url, headers=License.CUSTOM_HEADERS), 200)
+        return self._instance_or_null(License, json)
+
+    def licenses(self, number=-1, etag=None):
+        """Iterate over open source licenses.
+
+        :returns: generator of :class:`License <github3.licenses.License>`
+        """
+        url = self._build_url('licenses')
+        return self._iter(int(number), url, License, etag=etag,
+                          headers=License.CUSTOM_HEADERS)
+
     def login(self, username=None, password=None, token=None,
               two_factor_callback=None):
         """Logs the user into GitHub for protected API calls.

github3/licenses.py

@@ -0,0 +1,38 @@
+# -*- coding: utf-8 -*-
+"""
+github3.licenses
+================
+
+This module contains the classes relating to licenses
+
+See also: https://developer.github.com/v3/licenses/
+"""
+from __future__ import unicode_literals
+
+from .models import GitHubCore
+
+
+class License(GitHubCore):
+
+    CUSTOM_HEADERS = {
+        'Accept': 'application/vnd.github.drax-preview+json'
+    }
+
+    def _update_attributes(self, license):
+        # name of license
+        self.name = license.get('name')
+
+        # permission of license
+        self.permitted = license.get('permitted')
+
+        # category of license
+        self.category = license.get('category')
+
+        # forbidden
+        self.forbidden = license.get('forbidden')
+
+        # featured
+        self.featured = license.get('featured')
+
+    def _repr(self):
+        return '<License [{0}]>'.format(self.name)

github3/repos/repo.py

@@ -28,6 +28,7 @@
 from .contents import Contents, validate_commmitter
 from .deployment import Deployment
 from .hook import Hook
+from ..licenses import License
 from .pages import PagesBuild, PagesInfo
 from .status import Status
 from .stats import ContributorStats
@@ -107,6 +108,7 @@ def _update_attributes(self, repo):
         self.id = repo.get('id', 0)
         #: Language property.
         self.language = repo.get('language', '')
+
         #: Mirror property.
         self.mirror_url = repo.get('mirror_url', '')
 
@@ -1410,6 +1412,15 @@ def latest_pages_build(self):
         json = self._json(self._get(url), 200)
         return self._instance_or_null(PagesBuild, json)
 
+    def license(self):
+        """Get the contents of a license for the repo
+
+        :returns: :class:`License <github3.licenses.License>`
+        """
+        url = self._build_url('license', base_url=self._api)
+        json = self._json(self._get(url, headers=License.CUSTOM_HEADERS), 200)
+        return self._instance_or_null(License, json)
+
     @requires_auth
     def mark_notifications(self, last_read=''):
         """Mark all notifications in this repository as read.

tests/cassettes/GitHub_license.json

@@ -0,0 +1 @@
+{"http_interactions": [{"request": {"body": {"string": "", "encoding": "utf-8"}, "headers": {"Accept-Encoding": "gzip, deflate", "Accept": "application/vnd.github.drax-preview+json", "User-Agent": "github3.py/1.0.0a2", "Accept-Charset": "utf-8", "Connection": "keep-alive", "Content-Type": "application/json"}, "method": "GET", "uri": "https://api.github.com/licenses/mit"}, "response": {"body": {"string": "", "base64_string": "H4sIAAAAAAAAA2VUXY+jRhD8Ky2ediXOft831sbrUTBYGN9mtZwiDGMzCWbIzHB7VpT/nurB9l4SyZKZpj+qqov5K/hDXoKn4KxcEAZ9dZY4bERBiaplbyWCo+kQa50b7NN8Xg1qdlKuHQ+zWp/n3ZRm51ODo6zcaGQTPDkzyhBV5+63zwaor1utrayudf/rMcfARtraqMEp3WNwRIM0Z2Wt+i7pWkaurRwpS7bVxlHVN+Q0gpIGrXo3I+Gok86iVA+dpEYj5+Ja1Z/oA+DpokdDtW7kdByMxhCqnDPqMPJg35NT9ejoozKm6t1lBnB15eRJG2jWj10XBuqMAWfZu+qKd2GggaSKnPzh6Kgw/sFdBlVXXXchVrihRCzidBeTNrfHmfvhHkn1noTR2pE+TigtoNZyAsugaj1cfJbvjyx+vukC8pMOPHdGuRy6CsXvF1mZbxNXTq9HYwCZOOyZvh9BhrH9lMRHegBEfrCPt1E836hT66jVXSONZVWM/HNUfu/vgerrbmzkl3ti8C0M/A6dmzJgnLM0taq6L6O32Fk36giFWELLDlD2vgkc7Xi4EsRhMOo7BPaVaHzU5qCaRsIq70Gvv3SqOqhOuQu/POiGzV2A8k+epgccHsu+7Bd3Lg/1402lTy04ZXs1HywBv7XSyMOFTmwH2YR0NFKyMHVbmZMM2YUwGjvWokAfXKV6Nl3l11b2fl3sW310cBVsAvErazXEQEMYtR7vZvLmsXAP4JfB7lpSBo9+ToOPqERzv//by7tljWQFaxY0hK14Izfzs6M7hW14uSfD8T5tyeaBrKEHG5LfCv9Lz23gLdg2pPt2EPxcTchc5rCLlR2AoYUC+Ks/b/h8EqOf/HAVynLko9Xnf3NRQHQcTY+hkIYpawjnZ/4ua3f75I+66/QHs6t13yjvoSdeHa+9OmhcG5+e7bXDjTWh4EXc7hYIcX1lW3yodJBX1TAZGiP0SQkUx4N1sAAcjBvH+JH/pTrzENYx7bJV8RrlMYkdbfPsq1jGS+wz2iFQBiG9imKd7QtCTh6lxRtlK4rSN/pFpMuQ4l+3ebzbUZaXvdhsExEjKNJFsl+K9IWeUZhmuK4FPI2+RUY889pLxChc0SbOF2u0jp5FIoq3sOxXoki56yrLKaJtlBdisU+inLb7fJvhZorSJfqmIl3lGBNv4rTArZoiRvFXHGi3jpKEZ5V9tAeBnCHSItu+5eJlXdA6S5Yxgs8xsEXPSTzNAq9FEolNSMtoE70wvpwytAE9zpsA0us65hhPjPBbFCJLmckiS4scxxBE8+Je+yp2cUhRLnasySrPNuDImqIE/dEFhWk8tWG9vUj3xSCFz3vwvqGhZRwlaIYlpRPLWzb2Gvz9D1l3uoM3BwAA", "encoding": "utf-8"}, "headers": {"vary": "Accept", "x-github-media-type": "github.drax-preview; format=json", "x-xss-protection": "1; mode=block", "x-content-type-options": "nosniff", "etag": "W/\"7752486ec4302376f72db7e4afb52535\"", "cache-control": "public, max-age=60, s-maxage=60", "status": "200 OK", "x-ratelimit-remaining": "57", "x-served-by": "bae57931a6fe678a3dffe9be8e7819c8", "access-control-expose-headers": "ETag, Link, X-GitHub-OTP, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-OAuth-Scopes, X-Accepted-OAuth-Scopes, X-Poll-Interval", "transfer-encoding": "chunked", "x-github-request-id": "D54E579D:7FBF:192B58FD:5645E41F", "access-control-allow-credentials": "true", "date": "Fri, 13 Nov 2015 13:22:39 GMT", "access-control-allow-origin": "*", "content-security-policy": "default-src 'none'", "content-encoding": "gzip", "strict-transport-security": "max-age=31536000; includeSubdomains; preload", "server": "GitHub.com", "x-ratelimit-limit": "60", "x-frame-options": "deny", "content-type": "application/json; charset=utf-8", "x-ratelimit-reset": "1447424220"}, "status": {"message": "OK", "code": 200}, "url": "https://api.github.com/licenses/mit"}, "recorded_at": "2015-11-13T13:22:38"}], "recorded_with": "betamax/0.5.0"}

tests/cassettes/GitHub_licenses.json

@@ -0,0 +1 @@
+{"http_interactions": [{"request": {"body": {"string": "", "encoding": "utf-8"}, "headers": {"Accept-Encoding": "gzip, deflate", "Accept": "application/vnd.github.drax-preview+json", "User-Agent": "github3.py/1.0.0a2", "Accept-Charset": "utf-8", "Connection": "keep-alive", "Content-Type": "application/json"}, "method": "GET", "uri": "https://api.github.com/licenses?per_page=100"}, "response": {"body": {"string": "", "base64_string": "H4sIAAAAAAAAA61Vy27CMBD8FctnkvC4caO0QkiAqgKXlh6M2RCrzkO2k6qt+u91CNROhKsE9RZNVjOznvX65Qu/wQceY37MuDfy+7iHExKDRmarLVqAlCDQDBIQhKPHfM8ZRQtGIZGAiqo+F1yXR0plchwEJGP+kako3/s0jQNdX9bKwBIIgahcwAGPQ8IlfPcuJvLkXG5cbCJAWwtuJ2YTOdWudvwfrRpip3bMlOlxOd9czlSD7TqsCAy/Erl1kCQjNAJvaOc5OWG/4VX/2onV6FyaZdc1wXKAXMfZRd0Qu6SJUEwqRhsNn9HbWq5TOoNkkpog5+tp5yArAif/Xh68oUc5ySUYobv1PbqgaIfXLM44CxkcdrizgYbCn05GV51cUO1kBe/aQir05xMUTN7syFJyOgI9cQN7xB8oZ5leTI09VdW0G3XD6ZQ9bbKhP+i0Kqv6dh4sAacJcnV7TcIQROq8dV32tSXgNKGnrn7llukn45w0A+hy2w2nU5bSfj33qdAvCisATdM4ThOJnstTKHTu+u3QuJCEt96shr1p4PUHL8cx5S4HAAA=", "encoding": "utf-8"}, "headers": {"vary": "Accept", "x-github-media-type": "github.drax-preview; format=json", "x-xss-protection": "1; mode=block", "x-content-type-options": "nosniff", "etag": "W/\"6ac24bbbf9b265b86e5c9e11718d16f0\"", "cache-control": "public, max-age=60, s-maxage=60", "status": "200 OK", "x-ratelimit-remaining": "56", "x-served-by": "8a5c38021a5cd7cef7b8f49a296fee40", "access-control-expose-headers": "ETag, Link, X-GitHub-OTP, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-OAuth-Scopes, X-Accepted-OAuth-Scopes, X-Poll-Interval", "transfer-encoding": "chunked", "x-github-request-id": "D54E579D:7FC0:1DB80D74:5645DB0C", "access-control-allow-credentials": "true", "date": "Fri, 13 Nov 2015 12:43:56 GMT", "access-control-allow-origin": "*", "content-security-policy": "default-src 'none'", "content-encoding": "gzip", "strict-transport-security": "max-age=31536000; includeSubdomains; preload", "server": "GitHub.com", "x-ratelimit-limit": "60", "x-frame-options": "deny", "content-type": "application/json; charset=utf-8", "x-ratelimit-reset": "1447420294"}, "status": {"message": "OK", "code": 200}, "url": "https://api.github.com/licenses?per_page=100"}, "recorded_at": "2015-11-13T12:43:55"}], "recorded_with": "betamax/0.5.0"}

tests/cassettes/Repository_license.json

@@ -0,0 +1 @@
+{"http_interactions": [{"request": {"body": {"string": "", "encoding": "utf-8"}, "headers": {"Accept-Encoding": "gzip, deflate", "Accept": "application/vnd.github.v3.full+json", "User-Agent": "github3.py/1.0.0a2", "Accept-Charset": "utf-8", "Connection": "keep-alive", "Content-Type": "application/json"}, "method": "GET", "uri": "https://api.github.com/repos/sigmavirus24/github3.py"}, "response": {"body": {"string": "", "base64_string": "H4sIAAAAAAAAA62YzW7rNhCFX8XQto5pSfZNIqC47art7i7STTcGLdEWEUkUSMqGI+Tde0hKluSL+icsEBixzPl4OJyhZtgGPAuS+DlcPofhPKhoyYIk2HOdN9t4UZ+CebBrimLT/aD4vqQHLhsVrchklDhWTAZJGxRizyswxkNBMdNEq+VLvJwH9EA1lZtGFhiXa12rhBD3UC0ctVFMpqLSrNKLVJSkIc74++HXGLS97BgGG+DBBavmHccZA6bIhaBcl8WFBDe1NbkYvBNFIY6gXIq+NRE5WxpPWgqv9l+kwLIlQucMvsOSPo0juNKPi7JWLTZQ6Q3PDEdhQyTLHhbW2UGW2f/PlkhWCwtstiqVvNZcVI8LnFiDJuSeVvyDfo0GawWIkfa4FGsFa3ZALD5u7sxaUkt+oOnJuEaylPEDnP1F5IU9iPpUm7T9G0FhXM8129CsNGm4o4Vin/PATq8xyD6YI+vujf5pmmfsvKuY8MdJ56KaFXwrqTzNdkLOOHJW7miKWJ0dcYzMEK6zP7j+s9nOfv/x18FkL8a9n5VczVzr/EkyTuUY0o09uYpAegIASe/s5MUx9i3BZ5dPKVKdboWkWtw6NK4LnIBaMv5qYkkzWnoJtwCAciH8PGkBAHGlGnZXaF9fuOUo0udP1ZRbd+TdkzXX0Y4ArVThnK8Y8/LgGdKS/lRGOlRp7oftGS1x/9ndpnsvqcYemG0htl4cvCiJhbRE5dS9h/TGV52hGsYEKtnOW6phnKFaeu63lWkgZyReghpb76WzZ5C282hBq31D937UMwS7bl7Ve/pxs4i5njsDBUhToUm+bfwPuYFjlLraAfnu59IBM0BtQXK9zLnhgFFhY11QlvxWXXCd2CEmYf8/YE2cXqLN99tlzG25htGS4Ux2h35H9/Fud+r3OsdzdO2AV0j0DNL+UlOdm5MLU9VUMh/RHYK0W4pia7FYtDmjtqwumfTMYEcAiso0R9Xoo7PtGah6Sqpttb4zMjNU74WgmZdvzxAA3Tb6aHWE8f7X6EO9BFrAmFjygiktKr8zdqCM2ZXQfMfTezqW6+k2AbXfFa9SNqdFMUfUap5yxDFqbbOLKDiZn4ccAcvANYDrVAqGkPbyumSO0RLXaaaSoRHJNlSjgYiWYfS0jJ/C+C18TdYvyTr+Bytp6mwyZv0Uhvh7C6MkfklW38yYulH5COOGRG9RnCzDZPVqhuAE7EIQ/+GKAZ+41vipvx+1FObWAIZK5YPhb4NZ8h/3H51ZWiCWLoL+/jkPl6+l26aQmouS1SgTupuU8yrj+rSApzO0X5lI1QI9MDEr4x8Y+vr6Ek8KglQ0FfZjFUXz4Eg1ale8escP+0Li3PSZqanauDQNEi0b01XiyXAMjB4e+Tsfek+MMpJVb+a6uG66cP2Mc5NLKbobogppixuAmlXdbL2wNS6sXP+WWKPRkCAxP/Yr6RaWsR1tCr1x9TRWkqERKESNpVRMH9EJ9mSLG1chnbbo2+e/9Bwe9DETAAA=", "encoding": "utf-8"}, "headers": {"vary": "Accept", "x-github-media-type": "github.v3; param=full; format=json", "x-xss-protection": "1; mode=block", "x-content-type-options": "nosniff", "etag": "W/\"25a41f3e74b6d959ea171661f578641f\"", "cache-control": "public, max-age=60, s-maxage=60", "status": "200 OK", "x-ratelimit-remaining": "48", "x-served-by": "13d09b732ebe76f892093130dc088652", "access-control-expose-headers": "ETag, Link, X-GitHub-OTP, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-OAuth-Scopes, X-Accepted-OAuth-Scopes, X-Poll-Interval", "transfer-encoding": "chunked", "x-github-request-id": "D54E579D:146C7:17229172:5645ECEB", "access-control-allow-credentials": "true", "last-modified": "Wed, 11 Nov 2015 12:38:46 GMT", "date": "Fri, 13 Nov 2015 14:00:11 GMT", "access-control-allow-origin": "*", "content-security-policy": "default-src 'none'", "content-encoding": "gzip", "strict-transport-security": "max-age=31536000; includeSubdomains; preload", "server": "GitHub.com", "x-ratelimit-limit": "60", "x-frame-options": "deny", "content-type": "application/json; charset=utf-8", "x-ratelimit-reset": "1447424220"}, "status": {"message": "OK", "code": 200}, "url": "https://api.github.com/repos/sigmavirus24/github3.py"}, "recorded_at": "2015-11-13T14:00:11"}, {"request": {"body": {"string": "", "encoding": "utf-8"}, "headers": {"Accept-Encoding": "gzip, deflate", "Accept": "application/vnd.github.drax-preview+json", "User-Agent": "github3.py/1.0.0a2", "Accept-Charset": "utf-8", "Connection": "keep-alive", "Content-Type": "application/json"}, "method": "GET", "uri": "https://api.github.com/repos/sigmavirus24/github3.py/license"}, "response": {"body": {"string": "", "base64_string": "H4sIAAAAAAAAA7VWa2+bSBT9K5U/tzX40ZZI1aqDAUNiJwzMYCNLFa8AZcAo+BFS9b/vGeKu2qyqVSvtJ2Bm7rnnnHssz9dRE9XZ6Gp0Y+vG2jNGr0dtdCh+WuiKCN9ZpmaxMv/w/p2aZdP36Xx2/15Lp/G7+yybxbP5VMPWB00FQlc+AVKdziavR8cHgeLicGi7q/E4asu3eXkojvHbZF+PH7J23427Mq+jU/lw7Caz8fPu9G3bj5N9c8iaQze+cPvrIbv/mGanTOxbdCkOtfj8M/wP0L8CjcU+Hl9AvgMDDJUvsH6LKsrHErkb/4ZN6f7ciH2Uvmj8EJ0vHh277OFiwmDXrzT9W86hb+VQ70uRQdwFAwus5lW0WStJLcp0Q9t4Msu3wbyyl/wp9Egbl+QpnvJ+O2HP65bTxrXZZx6pd008dQ5Jf87TiVAinZySkkyjDd2jQrE/tYd4QtuwFl+2z8idbZk9UM/hxjnsGpxUwsDNk6VzSmtRyffUKopUJ0pksTystS62tGkUzBvbWp/imrapJU5xs8p3zXbjCNkj3Ljv9Hz/eFMSLwxom0xpHwWO+v1kPNnmyURTk3otJEoIZDDf8Cf06cMNLaJgJvti1yzjaTicSpYCKOk+1T9dx7WmRMFa3Ay8xNMObB7Rx80l9naiHUML+gPtmPSkiOtBBVDCU2w9nuDNMeyJdPlLbJktege8v8n3/a8YSz7bWhyhcC5RklrJv/PdNeGG9PBVlRP5HdaS8675U9aSs9QtjvaS7kPv03VoaV/SQBVxQ4vB63LQfoqndh5PcWaDZ2AqmHW7DR6la0swn4ZtaHHkK8Us84uCF1MrZ9erfpbzwcV5EQfDxOD1RS9mW8isHbabKpfTsS1kQSZ2SNCHPESCkU2ZYHnuDN21dgArnLq4N6VPSE8l2aX4DcBnuKrIDi2m+BRPQiWdDGmdDkl9zvRyfQ6D9ZBpiYSZ91DSPyd5licW7+NAPCUT6cfsWhfU3jUeX+VM0SxupoRVLB++TeeOV8KgzM1dUeXcKEzbMDmed6wk+dYwfdsQ/q5x+iR32dzA7m3gETMwiUf5GruaBwWOz8nKY9ywJbpwiC+oQ/mqQ/XtrnGVR07xRvErdQVntjG/47qsUB1uyCp6h1wzzwAvprq+IUyKzHPF9HYNq8xbjhXWkztakjXlzsIDD26YusceHW5WF24h0OYmU1c5rcDLMDAxZpgeqhecPRJocjl3XF9dS50eRYLAywc/gr7oOUP/We5XH3LKQ3PX+MKFawXxjfNLd3TqSQWm7oP1c7/BG8PjjumqboesSWcq6rCKL7h+BvZ84TFqwh3i45upxHQVMbxTXpjSRZc7Iby4A/OSLHxl7lNucsrmDL1WtoFKZi7hba6XBdDXK84ongm8djhcvfVVF7rh4drjFJoI8+G7nLWrco9Cp1TlK1v05zpTKRwEhkeWvqIZ0mXZ+9M1U7iHdCzQ671tPN5JX2UV52sTDA2XUyKZSldZpVno5t9eqomOU2DFfeA50GsiFZyZYKrMWvhi+2pq8opjSmsiEcGT+NXAXJnJeYZIhU2Z5sFTOffB68u8O+TMphz73B4m5iraLTcdgqzBeeD7+HLwnsMH4lZiBXaDr2DLfNVhtv6Te5g5Xw6uLeH1Am7Ik3fyF8FE6jCFtTIx3qAqGXrqyCW4bVxe5b7KGeZtaNbA2iMcFc9uGYUDD3xfCZnMM/XkrEPTL4kDVYSaIdC58WM1vDc0nynin3xfprXwpO+IDVXYUc8/ftw1+CPNmmSflk2Of9I46rJ3M6x9FmVTdaOrr6MuE/f/010H94s/Rf6jq4m8W/3Q8E/vVd9ej0SZZE2Hy8jXUZX10rgufTN9k4gItxvYd7l+Em/x6vvqq91onZ13o1f7B7zS7FR2WYrPmwvUf1wqLx278YtO91l0OD5k6ejqPhJd9u3b366TuqT8CgAA", "encoding": "utf-8"}, "headers": {"vary": "Accept", "x-github-media-type": "github.drax-preview; format=json", "x-xss-protection": "1; mode=block", "x-content-type-options": "nosniff", "etag": "W/\"85b7858af780eff0325ee3fff779e85f\"", "cache-control": "public, max-age=60, s-maxage=60", "status": "200 OK", "x-ratelimit-remaining": "47", "x-served-by": "dc1ce2bfb41810a06c705e83b388572d", "access-control-expose-headers": "ETag, Link, X-GitHub-OTP, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-OAuth-Scopes, X-Accepted-OAuth-Scopes, X-Poll-Interval", "transfer-encoding": "chunked", "x-github-request-id": "D54E579D:146C7:172291A3:5645ECEB", "access-control-allow-credentials": "true", "last-modified": "Thu, 12 Nov 2015 04:11:02 GMT", "date": "Fri, 13 Nov 2015 14:00:12 GMT", "access-control-allow-origin": "*", "content-security-policy": "default-src 'none'", "content-encoding": "gzip", "strict-transport-security": "max-age=31536000; includeSubdomains; preload", "server": "GitHub.com", "x-ratelimit-limit": "60", "x-frame-options": "deny", "content-type": "application/json; charset=utf-8", "x-ratelimit-reset": "1447424220"}, "status": {"message": "OK", "code": 200}, "url": "https://api.github.com/repos/sigmavirus24/github3.py/license"}, "recorded_at": "2015-11-13T14:00:11"}], "recorded_with": "betamax/0.5.0"}

tests/integration/test_github.py

@@ -144,6 +144,25 @@ def test_gitignore_template(self):
         assert t is not None
         assert t != ''
 
+    def test_license(self):
+        """Test the ability to retrieve a single license."""
+        cassette_name = self.cassette_name('license')
+        with self.recorder.use_cassette(cassette_name):
+            license = self.gh.license('mit')
+
+        assert isinstance(license, github3.licenses.License)
+
+    def test_licenses(self):
+        """Test the ability to retrieve open source licenses."""
+
+        cassette_name = self.cassette_name('licenses')
+        with self.recorder.use_cassette(cassette_name):
+            licenses = list(self.gh.licenses())
+            assert len(licenses) > 0
+
+            license = licenses[0]
+            assert isinstance(license, github3.licenses.License)
+
     def test_non_existent_gitignore_template(self):
         """Test the ability to retrieve a single gitignore template."""
         cassette_name = self.cassette_name('non_existent_gitignore_template')

tests/integration/test_repos_repo.py

@@ -344,6 +344,14 @@ def test_languages(self):
                 assert 'Last-Modified' not in l
                 assert isinstance(l, tuple)
 
+    def test_license(self):
+        """Test that a repository's license can be retrieved."""
+        cassette_name = self.cassette_name('license')
+        with self.recorder.use_cassette(cassette_name):
+            repository = self.gh.repository('sigmavirus24', 'github3.py')
+            license = repository.license()
+            assert isinstance(license, github3.licenses.License)
+
     def test_milestone(self):
         """Test the ability to retrieve a milestone on a repository."""
         cassette_name = self.cassette_name('milestone')

tests/unit/license_example

@@ -0,0 +1,24 @@
+{
+  "key": "mit",
+  "name": "MIT License",
+  "url": "https://api.github.com/licenses/mit",
+  "html_url": "http://choosealicense.com/licenses/mit/",
+  "featured": true,
+  "description": "A permissive license that is short and to the point. It lets people do anything with your code with proper attribution and without warranty.",
+  "category": "MIT",
+  "implementation": "Create a text file (typically named LICENSE or LICENSE.txt) in the root of your source code and copy the text of the license into the file. Replace [year] with the current year and [fullname] with the name (or names) of the copyright holders.",
+  "required": [
+    "include-copyright"
+  ],
+  "permitted": [
+    "commercial-use",
+    "modifications",
+    "distribution",
+    "sublicense",
+    "private-use"
+  ],
+  "forbidden": [
+    "no-liability"
+  ],
+  "body": "\n\nThe MIT License (MIT)\n\nCopyright (c) [year] [fullname]\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n"
+}

tests/unit/test_licenses.py

@@ -0,0 +1,19 @@
+from .helper import UnitHelper
+from .helper import create_example_data_helper
+from .helper import create_url_helper
+
+import github3
+
+get_example_data = create_example_data_helper('license_example')
+url_for = create_url_helper(
+    'https://api.github.com/licenses/mit'
+)
+
+
+class TestLicenses(UnitHelper):
+    described_class = github3.licenses.License
+    example_data = get_example_data()
+
+    def test_repr(self):
+        """Show that instance string is formatted properly."""
+        assert(repr(self.instance).startswith('<License'))