camelot

An OCaml Linter / Style Checker
README

An OCaml Linter / Style Checker for the OCaml compiler version 4.10.0.
Make sure you have ocaml version 4.10.0, otherwise the parsetree will be different

Dependencies (handled by opam)

  • ocaml >= v4.10.0

  • dune >= 2.5.0

  • compiler-libs.common

  • fswatch (for Build + Watch)

  • ANSITerminal

  • ppx_expect >= 0.13.1 (for testing)

  • yojson >= 1.7.0

  • odoc (for documentation builds)

Note:

This project is dependent on compiler-libs, an inherently unstable library that
changes between OCaml installations.

Installation

To install from the latest opam release, run: opam install camelot

Building From Source

Build:
dune build bin/camelot.exe

Build + Watch:
dune build bin/camelot.exe -w

Writing and running tests

To run tests:
dune test

If any changes you make break code, dune test will flag it and highlight the differences. If there are no issues,
dune will not print anything.

To write tests, see the dune documentation for expect-tests.
If you implement a new rule, you'll have to do the following:

  • Add your test case ( a program that you expect the linter to show a match for) to either a new file or an existing file
    in the examples/ directory.

    • If you create a new file in the examples/ directory, edit the dune file's deps stanza to make it visible to the
      build system. If you create a new programs file in examples/, you'll have to add a new let%expect_test in the style of the ones prior to the
      file test.ml, except with the ``[%expect {| ... |} ]``` clause blank.

    • If you added a test program to an existing file, it'll automatically be linted by the appropriate expect_test.

  • Run dune runtest. If your code for linting worked, runtest should
    highlight that there was a difference due to your new rule - run dune promote to accept this difference.
    Only promote if the difference that dune shows is appropriate - if there is a difference in the linted output, verify that your code did not break things,
    fix the issue, and then promote.

  • Reloading test.ml should show that the difference was added to the appropriate expect tests. In a PR, mention this - the reviewer
    should examine the expect test and make sure it makes sense (e.g. that the old prints were not messed up + the new test case appropriately printed).

Camelot flags

-d <lintdir> : Specify the directory in which to lint

-show <ta | student | gradescope> : Specify the reporting type - does a student see this output or a ta?
If this argument is malformed or not present, the reporting type defaults to student

-f <filename> : Lints the given file

Acknowledgements

This project wouldn't have been possible without the following three repos:

  • sml-style-check from the folks at CMU: for guiding the design of the linter, as well as basically contributing the structure of our project (especially the extendable checker modules :) ),

  • hlint for a good reference on building a linter,

  • ppx_tools/rewriter, for giving us useful starter code and being the building block on which camelot started.

Install
Published
31 May 2020
Sources
1.4.1.tar.gz
md5=01838f9d27228ed397bb1cbdb3bcccc6
sha512=b2d40cd329d6a9d025457e00f880d2fef71552b97317e9bb4c4b67ff7441455aeaa8b67de79ff64a4271178fbb51daaa2f5a3f818d593f0798d4e23c0b3b2b02
Dependencies
odoc
with-doc & >= "1.5.0"
ppx_expect
with-test & >= "0.13.0"
yojson
>= "1.7.0"
ocaml
>= "4.10.0" & < "4.11.0"
dune
>= "2.5"
Reverse Dependencies