[Python-ideas] Boolean parameters guidelines

[Chris Angelico]

On Tue, May 10, 2016 at 11:48 PM, Steven D'Aprano <steve at pearwood.info> wrote:
>
> (Personally, I think that coding style and API design overlap and that
> it is pointless to try to separate them. Coding style isn't only how to
> name your variables, but also includes whether you use map versus list
> comprehensions, whether you raise exceptions or return error codes,
> whether you write in a Java-influenced Design Pattern style or a
> functional style, when to use bool arguments and when not to.)

If the API design guidelines get broken out, they should be closely
associated with PEP 8. Maybe call it PEP 18, and have some references
in PEP 8? But I'd rather see it all as one cohesive document - advice
on how to structure your code to be Pythonic and maintainable.

ChrisA