This package provides a GUI wrapper around the popular Black Python formatter.
So instead of a command-line interface, simply_black allows the user to choose which files and/or folders.
And the following options can be set in an easy way
- line length (-l)
- target platform (-t)
- skip string normalization (-S)
Configuration (settings and selected files/folders) can be saved to a json file, to be used later.
The program loads the file simply_black.json upon startup, if available.
It is also possible to start simply_black with a given configuration file.
The file simply_black.py can be downloaded from GitHub. This file requires MySimpleGUI and PySimpleGUI to be installed (both are available on GitHub or PyPI).
Alternatively, there's a file simply_black_embedded.py, which has the packages MySimpleGUI and PySimpleGUI embedded.
This application could be realized in PySimpleGUI as well, but I think this is a nice application to demonstrate some of the features of MySimpleGUI, particularly attribute notation, easy global setting functionality (including context manager) and ansi colour support. On top of that MySimpleGUI features better exception handling, that can help to debug.
More information on MySimpleGUI can be found at https://github.com/salabim/MySimpleGUI.
More information on PySimpleGUI can be found at https://github.com/PySimpleGUI/PySimpleGUI.
Operating system: Windows, Linux or MacOS.
Python >= 3.6
For simply_black.py:
- MySimpleGUI, available from GitHub or PyPI
- PySimpleGUI, available from Github or PYPI
For simply_black_embedded.py:
- None
The program simply_black.py has one optional parameter, the config json file to be loaded at startup. If no parameter is given, the program tries to open the file simply_black.json from the current directory. If the json file is not found, the selection will be empty, and the following defaults will apply:
- line length (-l): 88
- target platform (-t): auto
- skip string normalization (-S): off
On the top row you will find the following buttons:
- Add folder, to add folders to the selection panel
- Add files, to add file(s) to the selection panel
- Clear selection, to clear the selection panel
- Load config, to load a previously stored json file
- Save config, to save the selection and the setting to a json file
Next, the line length can be changed with the slider between 80 and 255.
Next, the target platform can be chosen (auto, py27, py33, py34, py35, py36, py37, py38)
And finally, the skip string normalization can be enabled by ticking the option field
At the bottom are two buttons:
- Blacken which starts the actual Black program. The output will be shown in the output panel.
- Exit to exit the program
The Output panel will show the result of the Black program.