Understanding different naming conventions in python packaging

June 10, 2022

• directory name (root directory, repository) - PEP8 = no convention
• distribution name (PyPI, source distribution, eggs, wheels) - PEP8 = no convention
  • https://peps.python.org/pep-0508/#names
  • https://peps.python.org/pep-0345/#name
• package name (importable package) - PEP8 = all-lowercase, underscores discouraged
• module name (importable module) - PEP8 = all-lowercase, underscores fine

Poetry will try and find a package name based on distribution name (with dashes converted to underscores).