Demo/comparisons/sortingtest.py needs some usage information.

[ramiroluz]

BPO	10495
Nosy	@birkenfeld
Files	issue10495_demo_sortingtest_usage_patch.diff

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2010-12-30.22:35:42.188>
created_at = <Date 2010-11-22.00:38:30.884>
labels = ['type-feature']
title = 'Demo/comparisons/sortingtest.py needs some usage information.'
updated_at = <Date 2010-12-30.22:35:42.186>
user = 'https://bugs.python.org/ramiroluz'

bugs.python.org fields:

activity = <Date 2010-12-30.22:35:42.186>
actor = 'georg.brandl'
assignee = 'none'
closed = True
closed_date = <Date 2010-12-30.22:35:42.188>
closer = 'georg.brandl'
components = ['Demos and Tools']
creation = <Date 2010-11-22.00:38:30.884>
creator = 'ramiroluz'
dependencies = []
files = ['19762']
hgrepos = []
issue_num = 10495
keywords = ['patch']
message_count = 3.0
messages = ['122048', '122053', '124940']
nosy_count = 2.0
nosy_names = ['georg.brandl', 'ramiroluz']
pr_nums = []
priority = 'normal'
resolution = 'out of date'
stage = None
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue10495'
versions = ['Python 3.2']

[ramiroluz]

When someone run Demo/comparisons/regextest.py without arguments it waits for lines to be inserted in the command line silently, until the EOF, or Ctrl+D in Linux, is entered.

If the user read the file, editing or using cat Demo/comparisons/sortingtest.py he have to understand the code to figure out how to use it.

My suggestion is to add an usage message, plus the if __name__ == '__main__':.

[ramiroluz]

I had write a suggested patch before seeing this message http://bugs.python.org/issue10494#msg122047 from Alexander Belopolsky (belopolsky).

Probably it will be discarded, but as I commented in the previous #bpo-10494, the work was already done. (see http://mail.python.org/pipermail/python-ideas/2010-October/008416.html)

[birkenfeld]

Demo/comparisons has now been removed.