chore: enhance description of shell_exec

[fengju0213]

Description

enhance description of shell_exec for more information

Checklist

Go over all the following points, and put an x in all the boxes that apply.

• I have read the CONTRIBUTION guide (required)
• I have linked this PR to an issue using the Development section on the right sidebar or by adding Fixes #issue-number in the PR description (required)
• I have checked if any dependencies need to be added or updated in pyproject.toml and uv lock
• I have updated the tests accordingly (required for a bug fix or a new feature)
• I have updated the documentation if needed:
• I have added examples if this is a new feature

If you are unsure about any of these, don't hesitate to ask. We are here to help!

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch st_10_22

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[fengju0213]

I enhanced the description of shell_exec to provide more contextual information.
Another approach would be to automatically replace python with python -u when block is False, which has almost no side effects except in high-frequency output scenarios.
However, I think the current approach is cleaner and more flexible. Let me know if you have any suggestions.
@Wendong-Fan

[Wendong-Fan]

this PR need to be updated to fix the issue from root as discussed with @fengju0213

[fengju0213]

Switched non-blocking terminal sessions to export PYTHONUNBUFFERED=1, so Python subprocesses
stream their prints immediately instead of sitting in stdout buffers. Blocking runs stay
untouched.

[fengju0213]

updated cc @Wendong-Fan