Skip to main content
Latest Documentation
This is the latest documentation for the Cloud Posse Reference Architecture. To determine which version you're currently using, please see Version Identification.

GitHub Action: pre-commit

A GitHub action to run pre-commit

Introduction

This action is a fork of pre-commit/action that adds optional features for private repositories.

Permissions required: repo and workflow.

Usage

name: pre-commit

on:
pull_request:
push:
branches: [main]

jobs:
pre-commit:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
- uses: cloudposse/github-action-pre-[email protected]

To run a specific hook or pass custom arguments:

- uses: cloudposse/github-action-pre-[email protected]
with:
extra_args: flake8 --all-files

For private repositories, configure push-back support:

- uses: actions/checkout@v4
with:
fetch-depth: 0

- uses: cloudposse/github-action-pre-[email protected]
with:
token: ${{ secrets.GITHUB_TOKEN }}
git_user_name: pre-commit
git_user_email: pre-[email protected]
git_commit_message: pre-commit fixes

Inputs

NameDescriptionDefaultRequired
extra_argsoptions to pass to pre-commit run--all-filesfalse
git_commit_messagegithub commit message to push withpre-commit fixesfalse
git_user_emailgithub user email to push with[email protected]false
git_user_namegithub user name to push withpre-commitfalse
tokengithub token to clone / push withN/Afalse