Skip to main content

Be nice to your spouse - give your command line scripts some GUI feedback when needed.

Project description

https://img.shields.io/pypi/v/spousefriendly.svg

Be nice to your spouse (or other person who needs to run your scripts) - give your command line scripts some GUI feedback when needed.

Motivation

Developers usually like to run scripts from a terminal. In addition, for these kind of Python scripts, if something goes wrong, the easiest thing to do is let it fail ‘ungracefully’, at which point you get a helpful stacktrace on the screen. And if it goes well, it should just exit without printing anything.

For your spouse or friend who just wants to double click an icon, both these behaviours will be very confusing. They normally want confirmation that it worked and is finished, and if it doesn’t it should show some kind of nice error message.

This package provides some simple wrappers (normally context managers) so that you can get the best of both worlds.

Basic usage

Take a typical script:

def main():
    # Stuff here


if __name__ == '__main__':
    main()

Simply wrap the call to main in a spousefriendly.friendly_success_and_failure with block:

import spousefriendly

if __name__ == '__main__':
    with spousefriendly.friendly_success_and_failure():
        main()

If running from a terminal, there will be no change in behaviour. From a GUI, however (e.g. launched from a file manager), upon exit there will be a success message, or a failure message if appropriate.

Detailed usage

friendly_success_and_failure composes two context managers:

spousefriendly.friendly_success(success_message='Optional success message')

spousefriendly.friendly_failure(failure_message='Optional failure message')

Both success_message and failure_message can also be passed to friendly_success_and_failure as keyword arguments. Sensible defaults are used if not supplied.

Limitations

Obviously, the context managers can’t protect against anything that happens outside their scope (e.g. import errors etc.).

TODO

Windows support! This is the most obvious one. Since I don’t use Windows, I’m not in a position to test this. I’ve put some rudimentary things in, but it probably doesn’t work.

History

0.1.0 (2015-01-11)

  • First release on PyPI.

Project details


Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
spousefriendly-0.1.0-py2.py3-none-any.whl (5.8 kB) Copy SHA256 hash SHA256 Wheel 3.4 Sep 15, 2015
spousefriendly-0.1.0.tar.gz (6.7 kB) Copy SHA256 hash SHA256 Source None Sep 15, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page