?HAMA

Edit File Size: 1.42 KB

/opt/alt/python310/share/doc/alt-python310-setuptools/docs/deprecated/functionalities.rst

Text Base64

"Eggsecutable" Scripts
----------------------

.. deprecated:: 45.3.0

Occasionally, there are situations where it's desirable to make an ``.egg``
file directly executable.  You can do this by including an entry point such
as the following::

setup(
        # other arguments here...
        entry_points={
            "setuptools.installation": [
                "eggsecutable = my_package.some_module:main_func",
            ]
        }
    )

Any eggs built from the above setup script will include a short executable
prelude that imports and calls ``main_func()`` from ``my_package.some_module``.
The prelude can be run on Unix-like platforms (including Mac and Linux) by
invoking the egg with ``/bin/sh``, or by enabling execute permissions on the
``.egg`` file.  For the executable prelude to run, the appropriate version of
Python must be available via the ``PATH`` environment variable, under its
"long" name.  That is, if the egg is built for Python 2.3, there must be a
``python2.3`` executable present in a directory on ``PATH``.

IMPORTANT NOTE: Eggs with an "eggsecutable" header cannot be renamed, or
invoked via symlinks.  They *must* be invoked using their original filename, in
order to ensure that, once running, ``pkg_resources`` will know what project
and version is in use.  The header script will check this and exit with an
error if the ``.egg`` file has been renamed or is invoked via a symlink that
changes its base name.

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
distutils DIR	-	drwxr-xr-x	2026-02-10 08:07:38	Edit Download recursive recursive
distutils-legacy.rst	1.38 KB	lrw-r--r--	2021-10-22 20:55:51	Edit Download recursive recursive
easy_install.rst	50.92 KB	lrw-r--r--	2021-10-22 20:55:51	Edit Download recursive recursive
functionalities.rst	1.42 KB	lrw-r--r--	2021-10-22 20:55:51	Edit Download recursive recursive
index.rst	783 B	lrw-r--r--	2021-10-22 20:55:51	Edit Download recursive recursive
python_eggs.rst	30.22 KB	lrw-r--r--	2021-10-22 20:55:51	Edit Download recursive recursive

Directory Contents