'Retrieve the authenticated user\'s gists.
.. 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'

@requires_auth
def gists(self, number=(-1), etag=None):

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