Basic usage - friendly-traceback 0.7.53 (original) (raw)

Toggle table of contents sidebar

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.

There are various ways of using friendly. I only list here the basic scenarios available from a terminal or from within a Python interpreter. More options are possible, including running from an editor/IDE as described later in this documentation.

For those that know how to run programs from a terminal, I recommend using one of the first five following options.

  1. Execute a Python program, as I have already shown at the beginning:
  2. You can also start a friendly console:
  3. Combining the two options above by adding -ito always start friendly’s console after executing a program:

friendly example.py -i

or

friendly -i example.py

  1. As an altertive, add -xto start friendly’s console after executing a program only if an exception has been raised:

friendly example.py -x

or

friendly -x example.py

  1. If you run a program that raises an error and leaves you at an interactive prompt, you can import friendly “after the fact”. Consider the following content of a file named ignore.py:
    from math import *
    def test():
    a = cost(pi)
    test()

Here’s a sample session:

python -i ignore.py Traceback (most recent call last): File "C:\Users\andre\friendly-traceback\friendly\ignore.py", line 6, in test() File "C:\Users\andre\friendly-traceback\friendly\ignore.py", line 4, in test a = cost(pi) NameError: name 'cost' is not defined

from friendly import start_console An exception occurred before friendly-traceback was imported. Some information is available. start_console()

friendly-traceback: 0.4.79 friendly: 0.4.29 Python: 3.9.5 Type 'Friendly' for help on special functions/methods.

In your program, no object with the name `cost` exists.
Instead of writing `cost`, perhaps you meant one of the following:
*   Global scope: `cos`, `cosh`, `acos`

Note

This last example is more easily done in environments like Jupyter notebooks where the Friendly console does not have to be explicitly called to have access to the information from Friendly.

  1. You can also start a friendly console from any Python interactive interpreter, which is what was done above.

import friendly friendly.start_console()

For friendly, all of the above assume that you are using a terminal with a dark background. If you are using a terminal with a light background, you might want to add --format light, which can be abbreviated as -f light, as a command line option:

Similarly, the start_console() function accept various parameters, including formatter for friendlywhich can be specified to be either dark or light.

Using in other environments

If you want to use Friendly elsewhere than from a terminal, you likely will need to use a custom mode designed for that environment. Currently, as explained elsewhere in this documentation,friendly (but not friendly-traceback) has special options that need to be selected so that it can work best with the following:

If you design your own programming environment, such as is done onHackInScienceor futurecoderthen you likely only need to install friendly_traceback. Compared with friendly_traceback, friendly has quite a few additional dependencies that you would likely not need.

france En Français

Friendly offre la possibilité de présenter l’information en Français. Par exemple, si on désire démarrer Friendly à partir d’un terminal tel que décrit ci-dessus, il suffit de rajouter l’argumentlang fr de la façon suivante:

friendly

$ python -m friendly --lang fr

friendly_traceback

$ python -m friendly_traceback --lang fr

Si on désire démarrer la console à partir d’un interprète Python, on utilise le paramètrelang de la façon suivante:

friendly

import friendly friendly.start_console(lang='fr')

friendly_traceback

import friendly_traceback friendly_traceback.start_console(lang='fr')

Other languages

As mentioned previously, in addition to English and French,Friendly is available in other languages.