#49 naming guideline for non-top-level python modules
Closed: Fixed None Opened 13 years ago by cheeselee.

Draft: http://fedoraproject.org/wiki/User:Cheeselee/PythonNamingGuidelineDraft

The current guideline* has no specification for naming non-top-level modules like twisted.web and zope.interface. The implicit rule followed by all existing packages is substituting the dots('.') with minuses('-') and prefixing 'python-'. For example, the rpm for zope.interface is named 'python-zope-interface'. I hope this can be written out if proper.

Somebody may help revising the sentence as I am not a native English speaker.


Periods are not acceptable as separators: https://fedoraproject.org/wiki/Packaging/NamingGuidelines#Separators

All python module packages must be named using the upstream name of the python module. This makes a package name format of python-$NAME. When in doubt, use the name of the module that you type to import it in a script: https://fedoraproject.org/wiki/Packaging/NamingGuidelines#Addon_Packages_.28python_modules.29

So, basically, the guidelines actually say that what you thought was "implicit" behavior is "explicit" as documented, so no change in the guidelines is necessary.

That said, we did approve some clarification items to make this more clear:

1) In python guidelines: "When a module has a dot in its name, the usual rule about changing "." to "-" applies [LINK]"
2) In the dot-dash section, "Version numbers used in compat libraries do not need to omit the dot or change it into a dash"

action abadger1999's clarifications approved (+1:7, 0:0, -1:0)

Updated https://fedoraproject.org/wiki/Packaging:NamingGuidelines

Announcement text:

The rules for substituting dots with dashes in package names have been clarified to make explicit that they apply to python modules and that they do not apply to version numbers in compat libraries.

Login to comment on this ticket.

Metadata