Programming language for literate programming law specification
Go to file
Denis Merigoux 2ec9d50142 Small fixes
2021-03-11 14:34:49 +01:00
.github/workflows Fixes #78, as well as various improvements 2021-03-05 19:16:56 +01:00
doc docs: modify README.md's screenshots size 2021-03-10 15:20:44 +01:00
examples docs(examples): update the README.md catala code examples 2021-03-10 10:57:13 +01:00
javascript Small fixes 2021-03-11 14:34:49 +01:00
src Small fixes 2021-03-11 14:34:49 +01:00
syntax_highlighting refactor(syntax_highlighting): update the catala_en highlighting 2021-03-10 14:47:43 +01:00
tests fix(tests): modify some of the expected test outputs because of removed trailling whitespaces 2021-03-09 22:08:55 +01:00
.gitattributes git: update the gitattributs in order to manage all catala files 2021-03-09 22:25:30 +01:00
.gitignore Opam file: fix license format 2021-01-04 13:50:33 +01:00
.ocamlformat Weaving to LaTeX 2020-03-07 18:20:04 -08:00
catala.opam Benchmark, randomness of inputs, bugs fixed 2021-01-30 17:54:05 +01:00
CONTRIBUTING.md docs(contributing): syntax 2021-03-10 11:33:51 +01:00
dune Only look into src directory 2020-05-22 19:58:01 +02:00
dune-project Allow approximate merlin 2021-02-01 20:20:33 +01:00
generate_website_assets.sh Update website assets make rules 2021-02-04 11:17:45 +01:00
INSTALL.md Fixed CI 2021-03-02 18:28:56 +01:00
LICENSE.txt Code reorg 2019-09-04 10:32:33 +02:00
Makefile Fix makefile 2021-03-05 19:22:37 +01:00
README.md docs(readme): use url link like screenshot src 2021-03-10 18:36:10 +01:00

Catala logo

Catala

Catala is a domain-specific language for deriving faithful-by-construction algorithms from legislative texts. To learn quickly about the language and its features, you can jump right to the official Catala tutorial.

Join the Catala community on Zulip: https://zulip.catala-lang.org/!

Concepts

Catala is a programming language adapted for socio-fiscal legislative literate programming. By annotating each line of the legislative text with its meaning in terms of code, one can derive an implementation of complex socio-fiscal mechanisms that enjoys a high level of assurance regarding the code-law faithfulness.

Concretely, you have to first gather all the laws, executive orders, previous cases, etc. that contain information about the socio-fiscal mechanism that you want to implement. Then, you can proceed to annotate the text article by article, in your favorite text editor :

Screenshot

Once your code is complete and tested, you can use the Catala compiler to produce a lawyer-readable PDF version of your implementation. The Catala language has been specially designed in collaboration with law professionals to ensure that the code can be reviewed and certified correct by the domain experts, which are in this case lawyers and not programmers.

Screenshot

The Catala language is special because its logical structure mimics the logical structure of the law. Indeed, the core concept of "definition-under-conditions" that builds on default logic has been formalized by Professor of Law Sarah Lawsky in her article A Logic for Statutes. The Catala language is the only programming language to our knowledge that embeds default logic as a first-class feature, which is why it is the only language perfectly adapted to literate legislative programming.

Building and installation

See the dedicated readme.

Usage

Use catala --help to get more information about the command line options available.

The top-level Makefile contains a lot of useful targets to run. To display them, use

    make help

Examples

See the dedicated readme.

Contributing

See the dedicated readme.

Test suite

See the dedicated readme.

Documentation

Formal semantics

See the dedicated readme.

Compiler documentation

The compiler documentation is auto-generated from its source code using dune and odoc. Use

make doc

to generate the documentation, then open the doc/odoc.html file in any browser.

License

The library is released under the Apache license (version 2).

Limitations and disclaimer

Catala is a research project from Inria, the French National Research Institute for Computer Science. The compiler is yet unstable and lacks some of its features.

Pierre Catala

The language is named after Pierre Catala, a professor of law who pionneered the French legaltech by creating a computer database of law cases, Juris-Data. The research group that he led in the late 1960s, the Centre détudes et de traitement de linformation juridique (CETIJ), has also influenced the creation by state conselor Lucien Mehl of the Centre de recherches et développement en informatique juridique (CENIJ), which eventually transformed into the entity managing the LegiFrance website, acting as the public service of legislative documentation.