Installation for development of CMTools

CMTools CodeMeta Tools provides a simple command line tool called `cmt` that can be used to generate project files and software artifacts. It provides a tool called `cme` to edit and manage the CodeMeta file.

The project focuses on leveraging CodeMeta data, directory name and Git repo information for building and release software written in Python, Go, JavaScript or TypeScript. It was motivated by the practices in Caltech Library's Digital Development Group.

The tools are intended to be run from the project root directory. `cmt` expects the file path of your codemeta.json file as well as one or more target files to be generated. The target file's extension determines the generated content. The tool can generate the following project files based on the contents of the codemeta.json file. `cme` expects the file path of your codemeta.json file and optionally the attributes of the CodeMeta object you wish to manage.

`cme` is used to create and manage "codemeta.json". `cmt` is used to generate the following.

• README.md
• INSTALL.md
• installer.sh
• installer.ps1
• CITATION.cff
• version.ts, version.js, version.go or version.py
• about.md
• page.tmpl (Pandoc template) or page.hbs (handlebars template)
• Makefile (for Go or Deno based projects)
• website.mak
• release.bash
• publish.bash

Quick install with curl or irm

There is an experimental installer.sh script that can be run with the following command to install latest table release. This may work for macOS, Linux and if you’re using Windows with the Unix subsystem. This would be run from your shell (e.g. Terminal on macOS).

curl https://caltechlibrary.github.io/CMTools/installer.sh | sh

This will install the programs included in CMTools in your $HOME/bin directory.

If you are running Windows 10 or 11 use the Powershell command below.

irm https://caltechlibrary.github.io/CMTools/installer.ps1 | iex

Installing from source

Required software

• Deno >= 2.3
• CMTools >= 0.0.29

Steps

1. git clone https://github.com/caltechlibrary/CMTools
2. Change directory into the CMTools directory
3. Make to build, test and install

git clone https://github.com/caltechlibrary/CMTools
cd CMTools
make
make test
make install