README.md

CodeMeta2CFF

A GitHub action to convert a codemeta.json file to CITATION.cff. This allows users to avoid updating multiple files.

Table of contents

• Introduction
• Known issues and limitations
• Getting help
• License
• Authors and history
• Acknowledgments

Introduction

If you have a CodeMeta file in your repository, you can use this action to automatically convert it into a Citation File Format (cff) file. Add the following to your workflow

      - name: Convert to CFF
        uses: caltechlibrary/codemeta2cff@main

A full workflow for converting on a release is

name: CodeMeta2CFF
run-name: Run CodeMeta2CFF after ${{github.event_name}} by ${{github.actor}}

on:
  push:
    tags:
      - v*
  workflow_dispatch:
    inputs:
      reason:
        description: 'Reason'
        required: false
        default: 'Manual trigger'

jobs:
  CodeMeta2CFF:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v3
      - name: Convert CFF
        uses: caltechlibrary/codemeta2cff@main
      - name: Commit CFF
        uses: EndBug/add-and-commit@v9
        with:
          message: 'Add CITATION.cff for release'
          add: 'CITATION.cff'

Known issues and limitations

Only a limited subset of CodeMeta and CFF fields have been mapped. You can contribute by improving the codemeta2cff application at https://github.com/caltechlibrary/datatools

Getting help

If you encounter any problems, please raise them in the issue tracker.

License

Software produced by the Caltech Library is Copyright © 2021 California Institute of Technology. This software is freely distributed under a BSD/MIT type license. Please see the LICENSE file for more information.

Authors and history

This action was developed by Tom Morrell, using the codemeta2cff Go application written by Robert Doiel

Acknowledgments

This work was funded by the California Institute of Technology Library.