'Retrieve all public gists and iterate over them.
.. versionadded:: 1.0
:param int number: (optional), number of gists to return. Default: -1
returns all available gists
:param str etag: (optional), ETag from a previous request to the same
endpoint
:returns: generator of :class:`Gist <github3.gists.Gist>`\ s'

def public_gists(self, number=(-1), etag=None):

    url = self._build_url(u'gists', u'public')
    return self._iter(int(number), url, Gist, etag=etag)
