Add since parameter to public_gists

Closes #729

Author: jacquerie

github3/github.py

@@ -21,6 +21,7 @@
 from . import search
 from . import structs
 from . import users
+from . import utils
 
 from .decorators import (requires_auth, requires_basic_auth,
                          requires_app_credentials)
@@ -1267,7 +1268,7 @@ def project_column(self, number):
                 url, headers=projects.Project.CUSTOM_HEADERS), 200)
         return self._instance_or_null(projects.ProjectColumn, json)
 
-    def public_gists(self, number=-1, etag=None):
+    def public_gists(self, number=-1, etag=None, since=None):
         """Retrieve all public gists and iterate over them.
 
         .. versionadded:: 1.0
@@ -1277,13 +1278,24 @@ def public_gists(self, number=-1, etag=None):
             returns all available gists
         :param str etag:
             (optional), ETag from a previous request to the same endpoint
+        :param since:
+            (optional), filters out any gists updated before the
+            given time. This can be a `datetime` or an `ISO8601`
+            formatted date string, e.g., 2012-05-20T23:10:27Z
+        :type since:
+            :class:`~datetime.datetime` or str
         :returns:
             generator of short gists
         :rtype:
             :class:`~github3.gists.gist.ShortGist`
         """
+        params = None
         url = self._build_url('gists', 'public')
-        return self._iter(int(number), url, gists.ShortGist, etag=etag)
+        if since is not None:
+            params = {'since': utils.timestamp_parameter(since)}
+        return self._iter(int(number), url, gists.ShortGist,
+                          params=params,
+                          etag=etag)
 
     @requires_auth
     def organization_memberships(self, state=None, number=-1, etag=None):

tests/cassettes/GitHub_public_gists.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.1.0"], "Accept-Charset": ["utf-8"], "Connection": ["keep-alive"], "Content-Type": ["application/json"]}, "method": "GET", "uri": "https://api.github.com/gists/public?per_page=25&since=2018-07-13T00%3A00%3A00Z"}, "response": {"body": {"string": "", "base64_string": "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", "encoding": "utf-8"}, "headers": {"X-XSS-Protection": ["1; mode=block"], "Content-Security-Policy": ["default-src 'none'"], "Access-Control-Expose-Headers": ["ETag, Link, Retry-After, 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"], "Access-Control-Allow-Origin": ["*"], "X-Frame-Options": ["deny"], "Status": ["200 OK"], "X-GitHub-Request-Id": ["C844:7DB4:483C3D0:A1D3165:5B4A3E59"], "ETag": ["W/\"0915ae1dd24db4ac0b99c3529aab9cfe\""], "Link": ["<https://api.github.com/gists/public?per_page=25&since=2018-07-13T00%3A00%3A00Z&page=2>; rel=\"next\", <https://api.github.com/gists/public?per_page=25&since=2018-07-13T00%3A00%3A00Z&page=120>; rel=\"last\""], "Date": ["Sat, 14 Jul 2018 18:18:02 GMT"], "X-RateLimit-Remaining": ["59"], "Strict-Transport-Security": ["max-age=31536000; includeSubdomains; preload"], "Server": ["GitHub.com"], "X-GitHub-Media-Type": ["github.v3; param=full; format=json"], "X-Content-Type-Options": ["nosniff"], "Content-Encoding": ["gzip"], "X-Runtime-rack": ["1.415604"], "Vary": ["Accept"], "X-RateLimit-Limit": ["60"], "Cache-Control": ["public, max-age=60, s-maxage=60"], "Referrer-Policy": ["origin-when-cross-origin, strict-origin-when-cross-origin"], "Content-Type": ["application/json; charset=utf-8"], "X-RateLimit-Reset": ["1531595882"]}, "status": {"message": "OK", "code": 200}, "url": "https://api.github.com/gists/public?per_page=25&since=2018-07-13T00%3A00%3A00Z"}, "recorded_at": "2018-07-14T18:18:03"}], "recorded_with": "betamax/0.8.1"}

tests/integration/test_github.py

@@ -1,5 +1,7 @@
 # -*- coding: utf-8 -*-
 """Integration tests for methods implemented on GitHub."""
+from datetime import datetime
+
 import github3
 import pytest
 import uritemplate
@@ -403,6 +405,15 @@ def test_project_column(self):
 
         assert isinstance(r, github3.projects.ProjectColumn)
 
+    def test_public_gists(self):
+        """Test the ability to iterate over the public gists."""
+        since = datetime(2018, 7, 13)
+        cassette_name = self.cassette_name('public_gists')
+        with self.recorder.use_cassette(cassette_name):
+            for r in self.gh.public_gists(since=since, number=25):
+                assert isinstance(r, github3.gists.ShortGist)
+                assert r.updated_at.replace(tzinfo=None) >= since
+
     def test_pubsubhubbub(self):
         """Test the ability to create a pubsubhubbub hook."""
         self.token_login()

tests/unit/test_github.py

@@ -1107,6 +1107,18 @@ def test_public_gists(self):
             headers={}
         )
 
+    def test_public_gists_since(self):
+        """Show that public gists can be filtered by date."""
+        since = '2018-07-13T00:00:00Z'
+        i = self.instance.public_gists(since=since)
+        self.get_next(i)
+
+        self.session.get.assert_called_once_with(
+            url_for('gists/public'),
+            params={'per_page': 100, 'since': since},
+            headers={}
+        )
+
     def test_respositories(self):
         """
         Show that an authenticated user can iterate over their repositories.