https://github.com/takluyver/pynsist

Build Windows installers for Python applications
https://github.com/takluyver/pynsist

Last synced: 12 days ago
JSON representation

Build Windows installers for Python applications

• Host: GitHub
• URL: https://github.com/takluyver/pynsist
• Owner: takluyver
• License: other
• Created: 2014-03-30T19:11:21.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2024-04-09T12:58:32.000Z (7 months ago)
• Last Synced: 2024-10-11T19:19:00.326Z (about 1 month ago)
• Language: Python
• Homepage: https://pynsist.readthedocs.io/
• Size: 31.2 MB
• Stars: 896
• Watchers: 33
• Forks: 119
• Open Issues: 34
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

• best-of-python-dev - GitHub - 17% open · ⏱️ 09.04.2024): (Code Packaging)

README

        
Pynsist is a tool to build Windows installers for your Python applications. The

installers bundle Python itself, so you can distribute your application to

people who don't have Python installed.

For more information, see `the documentation `_

and `the examples `_.

Pynsist 2.7 requires Python 3.6 or above.

You can use `Pynsist 2.6 `_ on Python 3.5,

and `Pynsist 1.x `_ on Python 2.7 and

Python 3.3 or above, but these versions won't get further updates.

Quickstart

----------

1. Get the tools. Install `NSIS `_, and

   then install pynsist from PyPI by running ``pip install pynsist``.

2. Write a config file ``installer.cfg``, like this:

   .. code-block:: ini

   

       [Application]

       name=My App

       version=1.0

       # How to launch the app - this calls the 'main' function from the 'myapp' package:

       entry_point=myapp:main

       icon=myapp.ico

       [Python]

       version=3.6.3

       [Include]

       # Packages from PyPI that your application requires, one per line

       # These must have wheels on PyPI:

       pypi_wheels = requests==2.18.4

            beautifulsoup4==4.6.0

            html5lib==0.999999999

       # To bundle packages which don't publish wheels, or to include directly wheel files

       # from a directory, see the docs on the config file.

       # Other files and folders that should be installed

       files = LICENSE

           data_files/

3. Run ``pynsist installer.cfg`` to generate your installer. If ``pynsist`` isn't

   found, you can use ``python -m nsist installer.cfg`` instead.

This example illustrates how to use Pynsist by itself, for simple projects.

There are other options which can make it easier to integrate as a step in

a more complex build process. See the docs for more information.