Hello ! I’m Xavier Jouvenot and in this small post, I am going to explain how to automatically check if your python code is well formatted with AppVeyor.
Today, we are going to focus on how we can automatically check if the python code you are versioning is well formatted, and more specifically, how you can use AppVeyor to do so. To automate this process will make your team more efficient and the code more consistent since everyone will have to be on board and format their code each time they want to contribute.
If you are not convinced that you should format you code, I really encourage you to go look at the previous article I did on Formatting and Automation, where I go in detail on why you should definitively format your code, and do it in a automatic way, to make your code more readable and make your team more productive since they won’t have to spend time arguing about Spaces VS Tabs, for example.
The short answer, for the people who don’t want to read through the entire article (I know you do that! I do it too 😆) is to insert the following steps in your AppVeyor process:
- pip3 install black
- black --check .
If you have my previous article about “Formatting Python — Why and How !”, you may already know about about the tool named black. For those who don’t know, this is a code formatter, described by its authors as follow:
Black is the uncompromising Python code formatter. By using it, you agree to cede control over minutiae of hand-formatting. In return, Black gives you speed, determinism, and freedom from pycodestyle nagging about formatting. You will save time and mental energy for more important matters.
In the steps above, I start by installing this tool with the python package manager pip. Then, I run
black at the root of the folder, meaning that it is going to find all the Python files in repository and, since we are using the flag
--check, verify if they are well formatted. If one Python file is not formatted correctly, then, the black command will return an error, and the corresponding step in AppVeyor will fail.