def stream(self, category=values.unset, start_date=values.unset,<EOL>end_date=values.unset, include_subaccounts=values.unset, limit=None,<EOL>page_size=None):
limits = self._version.read_limits(limit, page_size)<EOL>page = self.page(<EOL>category=category,<EOL>start_date=start_date,<EOL>end_date=end_date,<EOL>include_subaccounts=include_subaccounts,<EOL>page_size=limits['<STR_LIT>'],<EOL>)<EOL>return self._version.stream(page, limits['<STR_LIT>'], limits['<STR_LIT>'])<EOL>
Streams TodayInstance records from the API as a generator stream.
This operation lazily loads records as efficiently as possible until the limit
is reached.
The results are returned as a generator, so this operation is memory efficient.

:param TodayInstance.Category category: The usage category of the UsageRecord resources to read
:param date start_date: Only include usage that has occurred on or after this date
:param date end_date: Only include usage that occurred on or before this date
:param bool include_subaccounts: Whether to include usage from the master account and all its subaccounts
:param int limit: Upper limit for the number of records to return. stream()
                  guarantees to never return more than limit.  Default is no limit
:param int page_size: Number of records to fetch per request, when not set will use
                      the default value of 50 records.  If no page_size is defined
                      but a limit is defined, stream() will attempt to read the
                      limit with the most efficient page size, i.e. min(limit, 1000)

:returns: Generator that will yield up to limit results
:rtype: list[twilio.rest.api.v2010.account.usage.record.today.TodayInstance]