Warning

Most of the documentation was written prior to version 0.5 and needs to be updated. This work has now started for version 0.7 and we aim to have it completed before version 0.8 is available.

www()

Occasionally, friendly will not recognize an exception, or a given message associated with that exception:

SomeError: never seen before

In this case, you can use the function www() which will open your default web browser and do an internet search for "SomeError: never seen before" using DuckDuckGo.

The same is true if you find that the explanation given by Friendly is not enough for you.

Searching using DDG

If no exception has been raised, calling www() will open Friendly’s documentation instead.

Optional arguments

www() is a convenience function that uses Python’s webbrowser module to open a page in the default web browser. It can also take one of the following optional arguments:

  • www('friendly'): go to Friendly’s documentation site.

  • www('python'): go to Python’s documentation site for the Python version currently used by the program from which it is invoked.

  • www('bug'): go to the Github’s issue page for friendly_traceback.

  • www('email'): uses the default browser configuration to invoke an email app to start a new email to be sent to me (andre.roberge@gmail.com). If you do not have a Github account, you can definitely use this option to communicate with me.

All string arguments passed to why() are case-insensitive.

Note that www() is a recent addition to friendly and that its behaviour is subject to change based on received feedback.