CLN: fix all flake8 warnings in pandas/io by wesm · Pull Request #12096 · pandas-dev/pandas (original) (raw)

Choose a reason for hiding this comment

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

Yes, as you say, in principle rst needs blank lines if you use a nested list (but I am not sure how this is actually handled in the docstrings, should test that).
But in this case, as trade-off between looking nice in html and in plain text, I would maybe go without the nesting of the lists? (as now it takes quite some space in the plaintext version). Something like:

* boolean: If True -> try parsing the index.
* list of ints or names: If [1, 2, 3] -> try parsing columns 1, 2, 3 each as a separate date
  column.
* list of lists: If [[1, 3]] -> combine columns 1 and 3 and parse as a single date
  column.
* dict: {'foo' : [1, 3]} -> parse columns 1, 3 as date and call result 'foo'