Skip to content
check-circle

GitHub Action

REUSE Compliance Check

v1.1.1 Latest version
Use latest version
check-circle

REUSE Compliance Check

Check your project's REUSE compliance for clear and simple licensing and copyright

Installation

Copy and paste the following snippet into your .yml file.

- name: REUSE Compliance Check
  uses: fsfe/reuse-action@v1.1.1
Learn more about this action in fsfe/reuse-action
Choose a version

REUSE Compliance Check

REUSE status

Do you struggle with copyright and licensing in your project? REUSE helps you in three simple steps! Read more on reuse.software and run the short tutorial to learn how to make your copyright and licensing easy and clear.

This action allows users to check for compliance with the REUSE best practices. It is one of many options for projects to include REUSE in their workflows. Please see the help for developers to get an overview.

Features

This action runs the reuse lint command over your repository to check the following information:

  • Is copyright and licensing information available for every single file?
  • Do license texts exist for all found license identifiers?
  • Are there any other problems with detecting copyright and licensing information?

This action uses the REUSE helper tool. For more features, please install the tool locally.

Example usage

You can include the following lines in your workflow .yml file to run the lint subcommand:

# SPDX-FileCopyrightText: 2022 Free Software Foundation Europe e.V. <https://fsfe.org>
#
# SPDX-License-Identifier: CC0-1.0

name: REUSE Compliance Check

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps: 
    - uses: actions/checkout@v2
    - name: REUSE Compliance Check
      uses: fsfe/reuse-action@v1

If you would like to run other subcommands, you could use the following snippet which outputs a the SPDX bill of materials:

    - uses: actions/checkout@v2
    - name: REUSE Compliance Check
      uses: fsfe/reuse-action@v1
      with:
        args: spdx

In the same fashion, it is possible to add optional arguments like --include-submodules:

    - uses: actions/checkout@v2
    - name: REUSE Compliance Check
      uses: fsfe/reuse-action@v1
      with:
        args: --include-submodules lint

Inputs Description

Name Requirement Default Description
args required lint The subcommand for the REUSE helper tool. Read the tool's documentation for all available subcommands.

License

This action itself is REUSE compliant, so copyright and licensing information is stored in every file. As of March 2020, all files are licensed under GPL-3.0-or-later.

Using the REUSE helper tool, you can run reuse spdx to get a full bill of materials.