Re:CLI tools hidden in the Python standard library
by BoppreH on Thursday June 29, 2023 @04:43AM
(#36517951)
Decorators seem to be documented now:
https://docs.python.org/3/glossary.html#term-decorator
https://docs.python.org/3/reference/compound_stmts.html#func...
Re:CLI tools hidden in the Python standard library
by bragr on Thursday June 29, 2023 @10:33AM
(#36520878)
These have always been documented. Hit the version selector: https://docs.python.org/2.7/glossary.html#term-decorator
Re:CLI tools hidden in the Python standard library
by roelschroeven on Thursday June 29, 2023 @04:56AM
(#36518027)
The tutorial is not supposed to cover all language features: "This tutorial does not attempt to be comprehensive and cover every single feature, or even every commonly used feature. Instead, it introduces many of Python’s most noteworthy features, and will give you a good idea of the language’s flavor and style."
But then I don't know how you're supposed to learn the features that are not in the tutorial. You can have a look at the table of contents of the standard library documentation for modules that might interest you, but that doesn't cover language features. Those are documented in The Python Language Reference, but that document is not really suited for learning from.
There are lots of websites and Youtube channels and so on, but you have to find them, and filter out the not-so-good ones which is not easy, especially for a beginner. I think there is room for some kind of official advanced tutorial to cover the gap.
Re:CLI tools hidden in the Python standard library
by fastasucan on Thursday June 29, 2023 @04:36PM
(#36526343)
I agree. Wish Python could been better with the documentation. Its a bit absurd that things feel more clear and simple reading Rust documentation than Python documentation for me, given that Python actually is a lot more simple and clear (for me).
To be fair, most things are missing from the official documentation. When I learned kotlin, I read through their official docs, and knew about most language features in a day. When I learned python, I constantly got surprised by things I hadn't seen come up in the docs. For instance decorators was (still is?) not mentioned at all in the official tutorial.