diff --git a/pep-0008.txt b/pep-0008.txt --- a/pep-0008.txt +++ b/pep-0008.txt @@ -438,6 +438,17 @@ Version Bookkeeping other code, separated by a blank line above and below. +Unix Shebangs and Executable Bit + + Files intended to be imported as modules should not contain a shebang + ("#!/usr/bin/env python" or similar text on the first line) nor have the + executable bit set. It is unneeded and distracting. If a module provides + command-line functionality, it can be used with "python -m module" or with + a small script (in a different file) that imports the module and calls one + of its functions. If you are using distutils, do not declare the same file + as module and script, it will result in undefined behavior. + + Naming Conventions The naming conventions of Python's library are a bit of a mess, so we'll