Skip to content
This repository has been archived by the owner on Nov 13, 2023. It is now read-only.

Latest commit

 

History

History
97 lines (67 loc) · 2.33 KB

CONTRIBUTING.md

File metadata and controls

97 lines (67 loc) · 2.33 KB
Raw

Development

Dev Setup Requirements

This is a native OCaml project, so you will need the following tools:

  • OCaml >= 4.10.2
  • dune >= 1.11.4

Easiest way to install these is via the opam package manager.

# Create / switch to ocaml 4.12.0
opam switch create 4.12.0

# Install deps
opam install dune

After that, install some npm dependencies as well:

npm install

Build genType

# Builds the project
npm run build

# Alternatively
dune build

When the compilation went through successfully, you'll now find the executable in _build/default/src/GenType.exe. Running the executable:

_build/default/src/GenType.exe --version

Test genType

Make sure to always run the tests before submitting any changes (CI usually takes longer to give you feedback).

npm test

Releases (for Maintainers)

The project is compatible with the npm version workflow. After using the npm version [major|minor|patch|...] command, npm will automatically tag the current commit, bump all the necessary version numbers (also the number in src/Version.ml) and push it to the current remote branch.

Use the ... menu next to the tag to create a release manually. (To be automated later).

Here are the concrete commands to run:

# Make sure to commit & push all current changes, the working branch should be clean
# and synced up with your remote branch

# Also make sure that your current branch is explicitly set to the relevant remote
# (`git push` instead of `git push origin master`)
git status

# For patches (0.0.X+1)
npm version patch

# For minor (0.X+1.0)
npm version minor

# For major (X+1.0.0)
npm version major

Releasing to npm (Maintainers only)

Use the GitHub web iterface to download the artifact gentype-npm.tar.gz (might need to manually zip it if downloading unzips it).

# Dry run for testing
npm publish gentype-npm.tar.gz --dry-run

# Publish package as @latest
npm publish gentype-npm.tar.gz

# Publish package with @beta tag
npm publish gentype-npm.tar.gz --tag beta

Consult the npm publish documentation for more options. In case you get an ENEEDAUTH error, use npm adduser and authenticate with your npm account first.