Metadata-Version: 2.1
Name: bundle-app
Version: 1.0.0
Summary: Constructs a macOS App bundle with a python executable.
Author-email: Marc Culler <culler@users.noreply.github.com>, "Nathan M. Dunfield" <nathan@dunfield.info>, Matthias Görner <enischte@gmail.com>
Maintainer-email: Marc Culler <culler@users.noreply.github.com>, "Nathan M. Dunfield" <nathan@dunfield.info>, Matthias Görner <enischte@gmail.com>
Project-URL: Homepage, https://github.com/3-manifolds/bundle_app
Project-URL: Bug Tracker, https://github.com/3-manifolds/bundle_app/issues
Keywords: files,metadata
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v2 or later (GPLv2+)
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python
Classifier: Topic :: Desktop Environment :: File Managers
Requires-Python: >=3.10
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: toml>=0.10.0

Bundle App
==========

This python package builds a macOS Application bundle for
a python/tkinter app.  It embeds the frameworks built by
the 3-manifolds frameworks project within the app.

To get started, by building a simple example app, run
this command::

    python3 -m bundle_app.init Silly

This will create a directory named silly which serves
as a development directory for the app.  In particular,
the script main.py is what runs your app.  To create your
silly app, do::

    cd silly
    python3 -m bundle_app.build

When you build your real app you will want to replace
the icon file with one designed for your app and edit
main.py so that it runs your app.  You may create a
Requirements.txt file in the development directory to
specify pypi packages which should be installed within
the embedded python framework.  You may also edit
info.toml and the sdef file to suit your needs. 

To add pypi packages to your app, add a standard
requirements.txt file to the development directory
and run::

    python3 -m bundle_app.add_packages

To remove unnecessary components and reduce the size
of your app bundle, first edit the file superfluous.txt
and then run::

    python3 -m bundle_app.streamline 
