Are you happy with your logging solution? Would you help us out by taking a 30-second survey? Click here

dead_code_analyzer

Dead-code analyzer for OCaml

Subscribe to updates I use dead_code_analyzer


Statistics on dead_code_analyzer

Number of watchers on Github 52
Number of open issues 3
Main language OCaml
Average time to merge a PR 14 days
Open pull requests 1+
Closed pull requests 3+
Last commit over 2 years ago
Repo Created almost 5 years ago
Repo Last Updated almost 2 years ago
Size 533 KB
Organization / Authorlexifi
Contributors3
Page Updated
Do you use dead_code_analyzer? Leave a review!
View open issues (3)
View dead_code_analyzer activity
View on github
Fresh, new opensource launches 🚀🚀🚀
Trendy new open source projects in your inbox! View examples

Subscribe to our mailing list

Evaluating dead_code_analyzer for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)

dead code analyzer

Dead-code analyzer for OCaml

Overview

The tool assumes that .mli files are compiled with -keep-locs and .ml files with -bin-annot. Exported values are collected by reading .cmi or .cmt files (depending on the existence of an explicit .mli interface). References to such values are collected by reading typed trees from .cmt files

This tool scans a compiled OCaml project and reports various warnings about suspicious code:

  • Exported values never used. (The declaration can be dropped from the interface, and then from the implementation if there is no internal use -- which will be reported by standard OCaml warnings).

  • Types fields and constructors never used. (Can be dropped from the type)

  • Class fields never used. (Can be dropped from the signature)

  • Optional arguments for which either all call sites or none of them provide a value (other than None). (The argument can be made mandatory or dropped.)

  • Other stylistic issues: patterns matching a value of type unit which are not () (typically, _ or a variable); let-binding let () = ... in ... (it's usually better to use sequencing); let-binding of the form let x = ... in x (the binding is useless); optional argument in argument's type: val f: ... -> (... -> ?_:_ -> ...) -> ...

Requirements

  • Currently tested and working on OCaml 4.05.0+trunk

Install

OPAM

opam install dead_code_analyzer

Manual

  1. Download the sources.
  2. Build by either
    • running make to generate the dead_code_analyzer.byt bytecode executable file;
    • running make opt to generate the dead_code_analyzer.opt native-code executable file. Both will be produced in the build directory.

Usage

dead_code_analyzer.<byt|opt> <options> <path>

The given paths can be files and directories. For more information about the usage, use the -help option.

Testing

To run the tests use make check. For each subset of the tests a file <subset>.out is generated, containg the output of the execution on it.

To run a subset of the tests call make -C check <subset>.

Documentation

Running make doc will produce the documentation as html files in the doc directory.

Running make man will produce documentation as man pages in the man/man3 directory.

Contribute

You are welcome to clone this repository and send us back pull requests.

Read CONTRIBUTING.md at the root of this directory for more informations on how to contribute.

Status

The project is used internally at LexiFi.

There has been no official release yet.

Limitations

Tracking the optional arguments uses may consume a lot of memory. Tracking the methods uses may consume a lot of memory.

Copyright

Source code is distributed under the conditions stated in file License

Contact

This project was initiated by LexiFi (http://www.lexifi.com) and is part of the SecurOCaml project.

Contact: alain.frisch@lexifi.com

dead_code_analyzer open pull requests (View All Pulls)
  • Ignore deprecated values
dead_code_analyzer list of languages used
More projects by LexiFi View all
Other projects in OCaml