report at bugs
Jul 29, 2012, 6:19 PM
Post #17 of 21
Nick Coghlan added the comment:
[issue15403] Refactor package creation support code into a common location
[In reply to]
Discoverability is definitely a problem - part of that is a docs issue, since test.support is currently the only one mentioned in the prose docs.
One advantage to moving to a support subpackage is that we can lose the "helper" suffix from the names, while still allowing thematic divisions.
So, for example, we could have
# support.py -> support/__init__.py
# script_helper.py -> support/scripts.py
# Other possible additions
Even without updating the prose docs, this would help discoverability a lot by having a much smaller directory listing to scan for useful support code. At the moment the general purpose helper modules are mixed in with the tests
I agree with Antoine that we're probably better off handling this as a refactor post-release at this point, though. I'd hoped to have the time to devote to it beforehand, but there's user facing stuff that's higher priority right now.
Python tracker <report [at] bugs>
Python-bugs-list mailing list