docs: expand running Python scripts examples

[Whning0513]

Fixes #9012.

Expand the poetry run documentation with a small project layout, a script example, and command-line argument handling.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[sourcery-ai]

Hey - I've left some high level feedback:

• In the first shell example, consider removing the trailing blank line inside the fenced code block to keep formatting consistent with other command snippets in the docs.
• Since this section now shows running scripts directly with python, it may be helpful to briefly mention (or link to) using tool.poetry.scripts/entry points for more typical CLI usage to clarify when each approach is recommended.

Prompt for AI Agents

Please address the comments from this code review:

## Overall Comments
- In the first shell example, consider removing the trailing blank line inside the fenced code block to keep formatting consistent with other command snippets in the docs.
- Since this section now shows running scripts directly with `python`, it may be helpful to briefly mention (or link to) using `tool.poetry.scripts`/entry points for more typical CLI usage to clarify when each approach is recommended.

---

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

• X
• Mastodon
• LinkedIn
• Facebook

_{Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.}