Execute an installed Python package as a script?

Question

Is there a way to enable a package to be executed as a script? For example:

[~]# easy_install /path/to/foo.egg
...
[~]# python -m foo --name World
Hello Worl         


        

Answer 1

I think this may be a limitation of Python 2.6. I've tested it, and executing a package (either in . or installed from an egg with easy_install) with the -m option works fine in 2.7, but not in 2.6. For example, on my system (Ubuntu) with a test package called pkg_exec in the current directory, and where __main__.py simply prints sys.argv:

xx@xx:~/tmp/pkg_exec$ python2.6 -m pkg_exec
/usr/bin/python2.6: pkg_exec is a package and cannot be directly executed
xx@xx:~/tmp/pkg_exec$ python2.7 -m pkg_exec
['/home/xx/tmp/pkg_exec/pkg_exec/__main__.py']

Also, according to the 2.7 docs:

Changed in version 2.7: Supply the package name to run a __main__ submodule.

Answer 2

This is a regression in Python 2.6. See issue2571:

The ability to execute packages was never intended, since doing so breaks imports in a variety of subtle ways. It was actually a bug in 2.5 that it was permitted at all, so 2.6 not only disabled it again, but also added a test to make sure it stays disabled (2.4 correctly rejected it with an ImportError, just as 2.6 does).

You have a few options, you can either always run it specifying main:

$ python -m module.__main__

Or you can write a shell script wrapper that detects the python version and then executes it in the different style.

Or you can execute code on the command line that will import and then run the module, and then perhaps place that in a shell script:

$ python -c "import module; module.main()"

In my own command-line projects I have both the shell script that catches errors (python not being installed, etc.) but the shell script will also execute the import code and detect if the necessary modules have been installed and prompt an error (with a helpful link or install text).

Answer 3

as long as the package is on the python path, add at the end of the script.

if __name__ == "__main__":
     call_script()

$ python -m module_name  

will run the module e.g

python -m random