[doc] Replace super(XXX, self) with super() in code examples

[andresdelfino]

As it is documented, it can make one think passing args to super() in these cases is needed, which is misleading.

[vsajip]

For my part, I don't mind leaving the old form in, because it works for both newer and older versions of Python. Someone copy-pasting from a cookbook might not be well-versed in Python, and there's no reason to trip them up in case they paste into a project using an older Python version.

[andresdelfino]

For my part, I don't mind leaving the old form in, because it works for both newer and older versions of Python. Someone copy-pasting from a cookbook might not be well-versed in Python, and there's no reason to trip them up in case they paste into a project using an older Python version.

I can see your point, but I think that goes against new (3.x) users. Imagine having all classes in examples explicitly subclassing object so that Python 2 users can copy & paste. Perhaps I'm missing something, but it seems the same thing to me. Plus, the reason that "this is for Python 2 users to be able to copy & paste" isn't obvious to a Python 3 user that's reading the code, so she/he may get the wrong idea, and understand that in those cases it's necessary to do things that way.

super() can be complex, so showing it as simple as it gets in the simple cases seems better to me.

[iritkatriel]

I agree with both of your comments, but since the logging-cookbook is versioned - wouldn't it be ok to update the Python 3 branches without backporting to the python 2.7 version?

[andresdelfino]

I agree with both of your comments, but since the logging-cookbook is versioned - wouldn't it be ok to update the Python 3 branches without backporting to the python 2.7 version?

Yes, this shouldn't be backported to 2.7

[vsajip]

OK, I don't feel that strongly about it, so I'm OK with making these changes in the logging cookbook. Not sure how authors of the other files affected feel - I think we should be consistent across all these files.

[andresdelfino]

@1st1 Could you talk a look at this when you have some time? :)

[orsenthil]

I find it preferable to use the zero-argument form of super in Python 3.0 docs as there reference document in 3.0 and linked documents demonstrate that form only ( https://docs.python.org/3/library/functions.html#super)

• If we have to showcase the two argument form, the reference document could be enhanced.

+1 to this patch, and using super() directly for the superclasses. I reviewed all the examples and it looks good to me.

[miss-islington]

Thanks @andresdelfino for the PR, and @orsenthil for merging it 🌮🎉.. I'm working now to backport this PR to: 3.8, 3.9.
🐍🍒⛏🤖

[bedevere-bot]

GH-25638 is a backport of this pull request to the 3.9 branch.

[bedevere-bot]

GH-25639 is a backport of this pull request to the 3.8 branch.