Message291365
After reviewing Sanyam's PR at https://github.com/python/cpython/pull/172 I ended up rejecting it as an approach to resolving this issue.
The core problem with the approach is that accessing `_sitebuiltins._Helper` is an implementation detail twice over:
- Python implementations aren't required to have a _sitebuiltins module
- that module isn't required to contain a _Helper class
That means importing it into a general purpose module like pydoc would couple pydoc specifically to the way CPython works, which is something we try to avoid doing.
By contrast, a richer `__help__()` protocol to override the `__doc__` based default behaviour would allow any object to implement it, and _sitebuiltins._Helper could just use that protocol to special case itself. |
|
Date |
User |
Action |
Args |
2017-04-09 09:47:46 | ncoghlan | set | recipients:
+ ncoghlan, terry.reedy, Devin Jeanpierre, ezio.melotti, eric.araujo, r.david.murray, mikehoy, jbitcm-, Cubky, jairotrad, jaysinh.shukla, CuriousLearner |
2017-04-09 09:47:46 | ncoghlan | set | messageid: <1491731266.76.0.912608987617.issue13691@psf.upfronthosting.co.za> |
2017-04-09 09:47:46 | ncoghlan | link | issue13691 messages |
2017-04-09 09:47:46 | ncoghlan | create | |
|