'Iterate over events that the user has received.
If the user is the authenticated user, you will see private and public
events, otherwise you will only see public events.
:param bool public: (optional), determines if the authenticated user
sees both private and public or just public
:param int number: (optional), number of events to return. Default: -1
returns all events available
:param str etag: (optional), ETag from a previous request to the same
endpoint
:returns: generator of :class:`Event <github3.events.Event>`\ s'

def received_events(self, public=False, number=(-1), etag=None):

    path = [u'received_events']
    if public:
        path.append(u'public')
    url = self._build_url(base_url=self._api, *path)
    return self._iter(int(number), url, Event, etag=etag)
