Skip to content
arrow-right

GitHub Action

CodeMeta2CFF

v0.2.0 Latest version

CodeMeta2CFF

arrow-right

CodeMeta2CFF

Convert a CodeMeta file to Citation File Format (cff)

Installation

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

              

- name: CodeMeta2CFF

uses: caltechlibrary/codemeta2cff@v0.2.0

Learn more about this action in caltechlibrary/codemeta2cff

Choose a version

CodeMeta2CFF

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

License Latest release DOI

Table of contents

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.