The description of Program Frameworks chapter is out of date

Documentation
1

Since the turtle’s move to Program Frameworks, its description is out of date:

The modules described in this chapter are frameworks that will largely dictate the structure of your program. Currently, the modules described here are all oriented toward writing command-line interfaces.

The turtle module isn’t an “oriented toward writing command-line interfaces.”.

Besides, since 3.13 we have Command Line Interface Libraries chapter. Maybe cmd and shlex, currently in Program Frameworks, should be moved to here.

If it is done, only the turtle will be in Program Frameworks. Maybe, we can rearrange it with Tk’s stuff, something like:

  • Graphical User interfaces
    • turtle — Turtle graphics
    • IDLE
    • Graphical User Interfaces with Tk
2 Likes
2

Describing shlex as something that will “largely dictate the structure of your program” also seems dubious. There is a shlex.shlex class for which that description may be accurate, but many people will just be using functions like shlex.quote and shlex.split.

1 Like
3

Isn’t readline also a “Command Line Interface Library”? Sure it’s also a “Text Processing” module, so it’s not wrong where it is.

4

I think it is worse than dubious, it is just wrong. The shlex.shlex object doesn’t structure your program in any way, it’s just a lexer object.

1 Like
5

Agreed with the general sentiment here (?) that the frameworks section might as well be gotten rid of.

1 Like
6

It’s odd that tkinter isn’t listed as a framework. I agree that removing the Program Frameworks section would be a good idea: it’s not a helpful category for turtle, cmd, and shlex.

1 Like
7

I’ve opened an issue: Docs: remove Program Framework chapter · Issue #137777 · python/cpython · GitHub

2 Likes