briefcase 0.1.2

Tools to support converting a Python project into a standalone native application.

Briefcase

Tools to support converting a Python project into a standalone native application.

Quickstart

In your virtualenv, install Briefcase:

$ pip install briefcase

Then, add extra options to your setup.py file to provide the app-specific properties of your app. Settings that are applicable to any app can be set under the app key; platform specific settings can be specified using a platform key:

setup(
    ...
    options={
        'app': {
            'formal_name': 'My First App',
            'bundle': 'org.example',
            'icon': 'icons/app.icns',
        },
        'osx': {
            'app_requires': [
                'toga[osx]'
            ]
        },
        'ios': {
            'app_requires': [
                'toga[ios]'
            ],
            'icon': {
                '29': 'icons/app-29.png',
                '40': 'icons/app-40.png',
                '58': 'icons/app-58.png',
                '76': 'icons/app-76.png',
                '80': 'icons/app-80.png',
                '87': 'icons/app-87.png',
                '120': 'icons/app-120.png',
                '152': 'icons/app-152.png',
                '167': 'icons/app-167.png',
                '180': 'icons/app-180.png',
            },
            'splash': {
                '1024x768': 'splash/splash-1024x768.png',
                '1536x2048': 'splash/splash-1536x2048.png',
                '2048x1536': 'splash/splash-2048x1536.png',
                '768x1024': 'splash/splash-768x1024.png',
                '640x1136': 'splash/splash-640x1136.png',
                '640x960': 'splash/splash-640x960.png',
            }
        },
        'android': {
            'app_requires': [
                'toga[android]'
            ]
        },
    }
)

At a minimum, you must set a formal_name key (the full, formal name for the app) and a bundle key (the bundle identifier for the author organization - usually a reverse domain name).

Then, you can invoke briefcase, using:

$ python setup.py osx

to create an OS/X app, or:

$ python setup.py ios

to create an iOS app, or:

$ python setup.py android

to create an Android app.

Community

Briefcase is part of the BeeWare suite. You can talk to the community through:

• @pybeeware on Twitter

• The BeeWare Users Mailing list, for questions about how to use the BeeWare suite.

• The BeeWare Developers Mailing list, for discussing the development of new features in the BeeWare suite, and ideas for new tools for the suite.

Contributing

If you experience problems with Briefcase, log them on GitHub. If you want to contribute code, please fork the code and submit a pull request.