'Iterate over references for this repository.
:param str subspace: (optional), e.g. \'tags\', \'stashes\', \'notes\'
:param int number: (optional), number of refs to return. Default: -1
returns all available refs
:param str etag: (optional), ETag from a previous request to the same
endpoint
:returns: generator of :class:`Reference <github3.git.Reference>`\ s'

def refs(self, subspace=u'', number=(-1), etag=None):

    if subspace:
        args = (u'git', u'refs', subspace)
    else:
        args = (u'git', u'refs')
    url = self._build_url(base_url=self._api, *args)
    return self._iter(int(number), url, Reference, etag=etag)
