Skip to content
This repository has been archived by the owner on Sep 1, 2023. It is now read-only.

Updating FileRecordStream docstrings #3545

Merged
merged 8 commits into from
Apr 13, 2017

Conversation

rhyolight
Copy link
Member

Fixes #3542

Blocked by #3541

Copy link
Member

@marionleborgne marionleborgne left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done with review. There a couple of typos. And I have a more general question about some attributes that are not being used. Otherwise it looks good to me.

(line 1), type (line 2), and a special indicator (line 3). The special indicator
can indicate that the field specifies a reset, is a sequence ID, or is a
timestamp for the record.
:class:`~.file_record_stream.FileRecordStream` is class that can read and write
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FileRecordStream is a class

The FileRecordStream class supports the context manager ('with' statement )
protocol. That means you con do:
:class:`~.file_record_stream.FileRecordStream` supports the context manager
(``with`` statement) protocol. That means you con do:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo: You can do

retval: a data row (a list or tuple) if available; None, if no more records
in the table (End of Stream - EOS); empty sequence (list or tuple)
when timing out while waiting for the next record.
:param useCache: NOT USED
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we should just get rid of this?

# input bookmark is not applicable in case of a file storage
inputBookmark = inputBookmark
:param record: a list of Python objects that will be string-ified
:param inputBookmark: NOT USED
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we rid of this?

Returns whether there are more records from current position. ``bookmark``
is not used in this implementation.

:param bookmark: NOT USED
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same question as before, ca we remove it since it's not used.

@rhyolight
Copy link
Member Author

@marionleborgne took all your feedback, thanks

@rhyolight rhyolight merged commit 53c229f into numenta:master Apr 13, 2017
@rhyolight rhyolight deleted the filerecordstream-docstrings branch April 13, 2017 19:14
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants