Home > Article > Backend Development > Formatting and Linting Your Python Codes with GitHub Actions
In the ever-evolving landscape of software development, maintaining code quality and consistency is crucial. One of the most effective ways to ensure that your codebase remains clean and adheres to best practices is by automating formatting and linting processes. In this blog post, we’ll walk through setting up a GitHub Actions workflow designed to automate code formatting and linting for Python projects. We'll explore the configuration and the steps involved, and how it can save you time and reduce errors in your code.
GitHub Actions is a powerful tool that allows you to automate workflows directly within your GitHub repository. From running tests to deploying applications, GitHub Actions can handle various tasks based on events like pushes, pull requests, and more. In this example, we’ll focus on automating code formatting and linting using GitHub Actions.
Here’s a detailed look at the GitHub Actions workflow for formatting and linting Python code:
name: Format and Lint on: push: branches: - master pull_request: branches: - master jobs: format-and-lint: runs-on: ubuntu-latest steps: - name: Checkout code uses: actions/checkout@v3 - name: Set up Python uses: actions/setup-python@v4 with: python-version: '3.9' # Specify the Python version to use - name: Install dependencies run: | python -m pip install --upgrade pip pip install black isort autopep8 - name: Run Black run: black . - name: Run isort run: isort . - name: Run autopep8 run: autopep8 --in-place --recursive . - name: Commit changes if any env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} run: | # Check for changes git diff --exit-code || { echo "Changes detected. Committing changes..." # Configure Git user git config --global user.name "github-actions" git config --global user.email "actions@github.com" # Stage all changes git add . # Commit changes git commit -m "Apply code formatting and linting fixes" # Push changes git push origin HEAD }
on: push: branches: - master pull_request: branches: - master
The workflow is triggered on pushes and pull requests to the master branch. This ensures that every change to the main branch or pull request is automatically formatted and linted.
jobs: format-and-lint: runs-on: ubuntu-latest
The job runs on the latest version of Ubuntu. This is the environment where your formatting and linting will occur.
- name: Checkout code uses: actions/checkout@v3
This step checks out your repository code, allowing subsequent steps to access and modify it.
- name: Set up Python uses: actions/setup-python@v4 with: python-version: '3.9'
This step sets up Python 3.9 in the workflow environment. Adjust this to match the Python version used in your project.
- name: Install dependencies run: | python -m pip install --upgrade pip pip install black isort autopep8
Here, essential Python packages for formatting and linting—black, isort, and autopep8—are installed.
- name: Run Black run: black . - name: Run isort run: isort . - name: Run autopep8 run: autopep8 --in-place --recursive .
These steps apply code formatting using black, isort for import sorting, and autopep8 for additional formatting adjustments.
- name: Commit changes if any env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} run: | git diff --exit-code || { echo "Changes detected. Committing changes..." git config --global user.name "github-actions" git config --global user.email "actions@github.com" git add . git commit -m "Apply code formatting and linting fixes" git push origin HEAD }
If formatting or linting changes are made, this step commits and pushes them back to the repository. It uses a GitHub token for authentication and configures Git with a generic user for commits.
Implementing a GitHub Actions workflow for formatting and linting is a smart way to maintain code quality and consistency across your projects. By automating these processes, you can focus more on writing code and less on formatting issues. The workflow provided here serves as a solid foundation, but you can customize it further based on your project's specific needs. Start integrating this workflow into your repositories today and experience the benefits of automated code quality management!
The above is the detailed content of Formatting and Linting Your Python Codes with GitHub Actions. For more information, please follow other related articles on the PHP Chinese website!