Python setuptools using 'scripts' keyword in setup.py

Question

I am trying to understand how python packaging works using setuptools.

One of the arguments for setup() function is scripts . The documentation doesn't specify what that argument is used for. Any help would be great!! Here is some sample code where scripts is used.

from setuptools import setup, find_packages
setup(
    name="HelloWorld",
    version="0.1",
    packages=find_packages(),
    scripts=['say_hello.py'],

    # Project uses reStructuredText, so ensure that the docutils get
    # installed or upgraded on the target machine
    install_requires=['docutils>=0.3'],

    package_data={
        # If any package contains *.txt or *.rst files, include them:
        '': ['*.txt', '*.rst'],
        # And include any *.msg files found in the 'hello' package, too:
        'hello': ['*.msg'],
    },

    # metadata for upload to PyPI
    author="Me",
    author_email="[email protected]",
    description="This is an Example Package",
    license="PSF",
    keywords="hello world example examples",
    url="http://example.com/HelloWorld/",   # project home page, if any

    # could also include long_description, download_url, classifiers, etc.
)

Mads Skjern · Accepted Answer · 2024-07-21 13:11:59Z

22

Its mainly used to define the additional scripts you'll be using in your package. Here's a snippet from the official documentation on python-packaging:

#!/usr/bin/env python
import funniest 
print funniest.joke()

Then we can declare the script in setup() like this:

setup(
    ...
    scripts=['bin/funniest-joke'],
    ... 
    )

When we install the package, setuptools will copy the script to our PATH and make it available for general use. This has advantage of being generalizeable to non-python scripts, as well: funniest-joke could be a shell script, or something completely different.

edited Jul 21, 2024 at 13:11

Mads Skjern

5,9487 gold badges38 silver badges45 bronze badges

answered Jul 15, 2017 at 4:09

worker_bee

4514 silver badges11 bronze badges

Sign up to request clarification or add additional context in comments.

2 Comments

ankostis Over a year ago

It's important to stress that the scripts keyword DOES NOT WORK in Windows! If there is no specific reason, please use the 2nd option console_scripts setuptools entry-point, as described in the reference link, which is officially "blessed": packaging.python.org/guides/…

droid192 Over a year ago

notice for entry_points: The functions you specify are called with no arguments, and their return value is passed to sys.exit() ...

Collectives™ on Stack Overflow

Python setuptools using 'scripts' keyword in setup.py

1 Answer 1

2 Comments

Your Answer

Linked

Hot Network Questions

Collectives™ on Stack Overflow

1 Answer 1

2 Comments

Your Answer

Sign up or log in

Post as a guest

Linked

Related