Skip to content

yamlfmt for GitHub Actions | yamlfmt-action は YAML ファイルを自動的に整形する GitHub Actions 用アクションです。CI/CD パイプラインでのコード品質向上に役立ちます。

License

Notifications You must be signed in to change notification settings

yk-lab/yamlfmt-action

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

yamlfmt-action

GitHub release (latest by date) GitHub license GitHub stars GitHub watchers

English | 日本語

Automatically format YAML files using yamlfmt in your GitHub Actions workflows. This action helps maintain consistent code style, making reviews and debugging easier.

TL;DR

name: YAML Formatting

on:
  push:
    branches:
      - main
  pull_request:
    types: [opened, synchronize, reopened]
  workflow_dispatch:

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: yamllint
        uses: reviewdog/action-yamllint@v1
        with:
          github_token: ${{ secrets.github_token }}
          fail_on_error: true
      - name: yamlfmt
        uses: yk-lab/yamlfmt-action@v1

Features

  • Automatic Formatting: Uses yamlfmt to standardize the formatting of YAML files.
  • Easy Integration: Add a few lines to your existing workflows to get started.
  • Customizable Options: Configure yamlfmt options to suit your project's needs.
  • Fast and Lightweight: Designed for speed and efficiency.

Table of Contents

Usage

Add yk-lab/yamlfmt-action as a step in your workflow:

name: YAML Formatting

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  format:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run yamlfmt
        uses: yk-lab/yamlfmt-action@v1

Options

The action supports the following input parameters:

  • version: Version of yamlfmt to use (default: latest, e.g., v0.13.0)
  • path: Path to the YAML file or directory to format
  • dstar: Enable double-star expansion
  • exclude: Exclude files matching the specified pattern
  • gitignore_excludes: Exclude files matching patterns specified in .gitignore
  • gitignore_path: Path to the .gitignore file
  • extensions: List of file extensions to format
  • formatter: Set the formatter to use

Example of Using Parameters

- name: Run yamlfmt with options
  uses: yk-lab/yamlfmt-action@v1
  with:
    path: '.github/workflows'

FAQ

Q1. Can I use a configuration file for yamlfmt?

A1. Yes, you can include a configuration file like .yamlfmt in your repository to customize yamlfmt behavior.

Q2. Can I exclude specific files or directories?

A2. You can specify exclude patterns using yamlfmt options. Refer to the yamlfmt documentation for details.

Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request.

Steps to Contribute:

  1. Fork the repository.
  2. Create a new branch: git checkout -b feature/your-feature
  3. Commit your changes: git commit -m 'Add some feature'
  4. Push to the branch: git push origin feature/your-feature
  5. Open a pull request.

License

This project is licensed under the MIT License.

Related Links

About

yamlfmt for GitHub Actions | yamlfmt-action は YAML ファイルを自動的に整形する GitHub Actions 用アクションです。CI/CD パイプラインでのコード品質向上に役立ちます。

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published