We are happy to announce release 1.3.1 of the MetaCoq project for Coq 8.17, 8.18 and 8.19, available both as source and through opam. This release will be part of the upcoming Coq Platform release including Coq 8.19. See the website for a detailed overview of the project, introductory material and related articles and presentations.
The main changes in this new version w.r.t. v1.2.1 are:
- A full integration of the typed erasure phase from the ConCert project in the erasure pipeline, with a complete correctness proof, by @mattam82. Use option
MetaCoq Erase -typed
to switch it on. It can be configured with the “live” erasure function inside Coq (seeerasure_live_test.v
) - Generalizations of the correctness and simulation lemmas by @yforster @mattam82 and @tabareau, showing in particular that erasure of applications of functions from firstorder types to firstorder types is compiled to applications, justifying separate compilation of functions and their arguments.
- Using standardization and canonicity, we also show that erased values of programs of firstorder inductive types (non-erasable inductives types for which all constructor argument types are themselves firstorder) are in direct correspondence with their Coq counterparts, allowing sound readback of these values. In other words, evaluating the erased terms under these assumptions faithfully simulates evaluation in Coq. Based on this, CertiCoq and coq-malfunction both implement an
Eval
variant that reads back Coq values and can be trusted. - Support for primitive ints, floats and array literal values. Primitive operations are still treated as axioms to be realized in target languages and the correctness theorems do not apply in their presence yet.
- Optional passes have been added that replicate the Coq Extraction plugin’s functionality, without proof (yet):
- Inlining of defined constants (e.g.
Extract Inline
). - Reordering of constructors (e.g. part of
Extract Inductive
). This allows to target different representations in target languages (typically bool in OCaml). - Unboxing of singleton unary constructors. For example,
exist nat (fun x : nat => x = 1) 1 p : { x : nat | x = 1 }
becomesexist 1
after typed erasure and removal of constructor parameters, which can be further unboxed to just1
. - CoFixpoints/CoInductives to Lazy/Inductives: cofixpoints and (co)-constructors get translated to fixpoints + lazy/force constructs in lambda-box, allowing efficient evaluation of coinductive terms in target languages.
- Beta-reduction. This reduces manifest beta-redexes in the erased terms, especially useful after inlining.
- Inlining of defined constants (e.g.
See Release MetaCoq 1.3.1 for Coq 8.19 · MetaCoq/metacoq · GitHub for the full changelog.
This version of MetaCoq was developed by Yannick Forster, Jason Gross, Yann Leray, Matthieu Sozeau and Nicolas Tabareau with contributions from Yishuai Li. You are welcome to contribute by opening issues and PRs. A MetaCoq Zulip stream is also available.
MetaCoq integrates Template-Coq, a reification and denotation plugin for Coq terms and global declarations, a Template monad for metaprogramming (including the ability to extract these metaprograms to OCaml for efficiency), a formalisation of Coq’s calculus PCUIC in Coq, a relatively efficient, sound and complete type checker for PCUIC, a verified type and proof erasure procedure from PCUIC to untyped lambda calculus and a quotation library. MetaCoq provides a low-level interface to develop certified plugins like translations, compilers or tactics in Coq itself.
You can install MetaCoq directly from sources or using opam install coq-metacoq
.
The current release includes several subpackages, which can be compiled and installed separately if desired:
- the utils library contains extensions to the standard library (notably for reasoning with All/All-n type-valued predicates) (in directory
utils
, and ascoq-metacoq-utils
). - the common libraries of basic definitions for the abstract syntax trees shared by multiple languages (
common
,coq-metacoq-common
) - the Template-Coq quoting library and plugin (
template-coq
/coq-metacoq-template
) - a formalisation of meta-theoretical properties of PCUIC, the calculus underlying Coq (
pcuic
/coq-metacoq-pcuic
) - a verified equivalence between Template-Coq and PCUIC typing (in directory
template-pcuic
and ascoq-metacoq-template-pcuic
) - a total verified type-checker for Coq (
safechecker
/coq-metacoq-safechecker
), usable inside Coq. - a plugin interfacing with the extracted type-checker in OCaml, providing the
MetaCoq SafeCheck <term>
command (safechecker-plugin
,coq-metacoq-safechecker-plugin
) - a verified type and proof erasure function for Coq (
erasure
/coq-metacoq-erasure
), usable inside Coq. - a plugin interfacing with the extracted erasure pipeline in OCaml, providing the
MetaCoq Erase <term>
command (erasure-plugin
,coq-metacoq-erasure-plugin
) - a quoting library, allowing the quotation of terms and type derivations along with associated data structures as ASTs/terms (
quotation
/coq-metacoq-quotation
). - a set of example translations from Type Theory to Type Theory (
translation
/coq-metacoq-translations
).
A good place to start are the files demo.v
, safechecker_test.v
, erasure_test.v
in the test-suite
directory.
The MetaCoq Team