Skip to content

Latest commit

 

History

History
86 lines (58 loc) · 2.6 KB

README.md

File metadata and controls

86 lines (58 loc) · 2.6 KB

Coq Plugin smpl

Smpl is useful for proof automation in Coq. Smpl provides named lists of tactics to which tactics can be added with Coq commands. A special tactic called 'smpl foo' executes the tactics in the lists named foo in order, until one of them succeeds. Smpl works across modules by merging tactics from all imports according to a priority number that can be provided upon addition. Smpl thus allows to modify the behavior of a tactic after it is defined in a convenient and modular way.

Put differently, Smpl realizes a tactic that behaves similarily to

first [ l_1 | ... | l_n]

with the twist that the list l_1 | ... | l_n can be extended in a fashion akin to eauto databases (i.e. adding tactics works across modules by merging the lists).

See the included demo file for instructions how to use the plugin.

Availability

The plugin is available for Coq 8.6.1 in branch v8.6 and for 8.7 in branch v8.7.

Installation

We provide an opam repository from which smpl can be installed for Coq 8.6.1 and 8.7+beta1. To install from the opam repository use the following commands:

opam repo add opam-smpl https://github.com/sigurdschneider/opam-additions.git
opam update
opam install smpl

Manual Installation

If you are familiar with Coq plugins, this plugin will be no surprise to you. Download the plugin, either by downloading the .zip archive here, or cloning the repository. Assuming smpl was extracted/cloned to directory smpl, the following commands install the plugin into the user-contrib directory of your Coq installation.

cd smpl
make
make install

In any of your Coq files, smpl can then be imported via

Require Import smpl.Smpl.

We recommend checking out the included demo file for examples.

Alternative: Including smpl's sources in your project

If you want to place smpl's sources in your project, you can place it in a directory of your project.

git clone -v v8.6 https://github.com/sigurdschneider/smpl.git
cd smpl
make

Note that you need to do

git clone -b v8.7 https://github.com/sigurdschneider/smpl.git

if you are already using Coq 8.7+beta1.

Enter the cloned directory and build smpl:

cd smpl make

To use the plugin, you must add the following to your _CoqProject file:

-R smpl/theories smpl
-I smpl/src

Important: Make sure that smpl is not covered by any other recursive import command, such as -R . Foo in your _CoqProject as this will result in different module names and not work.

In any of your files, you can then import the plugin via

Require Import smpl.Smpl.