Skip to content

GitHub Action converting a codemeta file to CITATION.cff

License

Notifications You must be signed in to change notification settings

comses/codemeta2cff

 
 

Repository files navigation

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.

About

GitHub Action converting a codemeta file to CITATION.cff

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published