`setuptools.setup` parameter `py_modules` is undocumented

[LutherThompson]

BPO	31996
Nosy	@berkerpeksag

^{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 2017-11-09.23:37:48.589>
created_at = <Date 2017-11-09.23:34:14.863>
labels = ['type-feature', 'docs']
title = '`setuptools.setup` parameter `py_modules` is undocumented'
updated_at = <Date 2017-11-11.06:25:32.519>
user = 'https://bugs.python.org/LutherThompson'

bugs.python.org fields:

activity = <Date 2017-11-11.06:25:32.519>
actor = 'Luther Thompson'
assignee = 'docs@python'
closed = True
closed_date = <Date 2017-11-09.23:37:48.589>
closer = 'berker.peksag'
components = ['Documentation']
creation = <Date 2017-11-09.23:34:14.863>
creator = 'Luther Thompson'
dependencies = []
files = []
hgrepos = []
issue_num = 31996
keywords = []
message_count = 3.0
messages = ['305997', '305998', '306077']
nosy_count = 3.0
nosy_names = ['docs@python', 'berker.peksag', 'Luther Thompson']
pr_nums = []
priority = 'normal'
resolution = 'third party'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue31996'
versions = ['Python 3.6']

[LutherThompson]

I wrote my own distribution package with only one module, but the module file was not being installed along with the dist info file. I found by looking up the code for the six module that setup has a py_modules parameter which apparently must be used to make the installation work. This module is not mentioned anywhere in https://packaging.python.org/tutorials/distributing-packages/.

[berkerpeksag]

Thank you for your report, but the correct place to report issues with packaging.p.o is https://github.com/pypa/python-packaging-user-guide

[LutherThompson]

Thanks, done: pypa/packaging.python.org#397