package loc

You can search for identifiers within the package.

in-package search v0.2.0

Representing ranges of lexing positions from parsed files

Install

Dune Dependency

github.com Readme Changelog MIT License Edit opam file Versions (2)

Authors

M

Mathieu Barbin

Maintainers

M

Mathieu Barbin <opensource@mbarbin.org>

Sources

loc-0.2.2.tbz

sha256=3823c82f10c16278eb4b660a5621c59f4e920151c6d4c6a37976bbe9ba3a7934

sha512=aca370c2387e2afb6b116f911671f872cbc44713297713e98573dda5dcad0974bd7f22df4ad8a59243b19ba24a675d1ec98c66453176298baaaa3fdb56c5e1e4

README.md.html

loc

Loc is an OCaml library to manipulate code locations, which are ranges of lexing positions from a parsed file.

It is inspired by dune's Loc.t, and uses it under the hood. The type equality with Stdune.Loc.t is currently not exposed and Stdune not mentioned in the interface of Loc, with the aim of keeping the signature of Loc stable across potential internal changes in Stdune.

Code Documentation

The code documentation of the latest release is built with odoc and published to GitHub pages here.

Motivation

Attaching locations to nodes manipulated by programs can be useful for applications such as compilers, interpreters, linters, refactor tools, etc.

Here are 3 kinds of examples using the Loc library:

Attach locations to the nodes of an AST. See bopkit.
Apply surgical patches to a file. See file-rewriter.
Emit located messages to the console. See cmdlang's Err module.