PEP-8 & refactoring

[pexpect]

PEP-8 & refactoring

[stephenfin]

Some ideas

• fix pep-8 errors reported by pylint
• convert examples in docstrings to doctest compatible examples
• modularize __init__.py
• convert some functions with >5 args to use **kwargs and parse this
• remove commented out code (it's in version control)
• resolve todos or open issues if not possible

[takluyver]

Hi Stephen,

I don't like doing big pep 8 cleanups - I try to roughly follow pep 8 when
I'm writing or changing code, but reformatting other code doesn't seem
worth it, especially as it introduces conflicts with other changes.

I also don't have a problem with functions with more than five arguments.
Using kwargs makes our code longer, and makes introspection less useful, do
it seems like a step backwards.

Other than that, I think your ideas mostly make sense. Hold off on
splitting up init, though: I want to do that carefully as we add
support for asyncio and windows.

[stephenfin]

Sounds good. I'll have a look at the other items in that case and see what I can do.

[takluyver]

Thanks!