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 Azure Pipelines.
Self promotion: Here are a few social networks where you can follow me and check my work as a programmer and a writer 😉
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.
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 Azure Pipelines process:
- script: |
pip3 install black
displayName: Installs the latest version of black
- script: |
black --check .
displayName: Checks if the python scripts are formatted properly with black
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 Azure Pipelines will fail.
If you want, you can specify directly the list of the Python files, instead of letting the tool scan through all the repository recursively. 😉