Debug TLAPS proof manager with ocamldebug on Ubuntu Linux 18.04

by lemmster 4 years ago

GNU/Linux ◆ xterm-256color ◆ bash 340 views

sudo apt-get install opam ocaml

git clone https://github.com/tlaplus/tlapm

./configure --prefix=$(pwd) # Install into current directory
make all install
cd src/
make debug
cd -


export PATH=$PATH:/usr/local/lib/tlaps/bin "Reuse back-end provers from TLAPS standard installation in /usr/local/lib/tlaps!"

ocamldebug src/tlapm.byte ../DummyProofs.tla

How to use ocamldebug

Documentation is at https://caml.inria.fr/pub/docs/manual-ocaml/debugger.html

Debug in VSCode

Install earlybird (wwitch to minimum ocaml version required by it)

opam switch create 4.06.1 
eval $(opam env)
opam install earlybird

Install https://github.com/hackwaly/vscode-ocaml-debugger into VSCode
Launch code . in tlapm/ directory from the current shell
Launch config:

markus@avocado:/tmp/TLA/tlapm(master)$ cat .vscode/launch.json 
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "OCaml",
            "type": "ocamldebug",
            "request": "launch",
            "program": "${workspaceRoot}/src/tlapm.byte",
            "arguments": [
                 "--debug", "verbose4"
                , "--cleanfp" 
            ,"../MyProofs.tla"],
            "console": "internalConsole",
            "stopOnEntry": false
        }
    ]
}

Recording of VSCode setup at https://youtu.be/Eu46FmhpR_0

More by lemmster

TLA+ REPL - Load custom modules 00:55

by lemmster 3 years ago

untitled 05:20

by lemmster 4 years ago

See all

You can download this recording in asciicast v2 format, as a .cast file.

Download

Replay in terminal

You can replay the downloaded recording in your terminal using the asciinema play command:

asciinema play 307459.cast

If you don't have asciinema CLI installed then see installation instructions.

Use with stand-alone player on your website

Download asciinema player from the releases page (you only need .js and .css file), then use it like this:

<!DOCTYPE html>
<html>
<head>
  <link rel="stylesheet" type="text/css" href="asciinema-player.css" />
</head>
<body>
  <div id="player"></div>
  <script src="asciinema-player.min.js"></script>
  <script>
    AsciinemaPlayer.create(
      '/assets/307459.cast',
      document.getElementById('player'),
      { cols: 146, rows: 75 }
    );
  </script>
</body>
</html>

See asciinema player quick-start guide for full usage instructions.

While this site doesn't offer GIF conversion at the moment, you can still do it yourself with the help of asciinema GIF generator utility - agg.

Once you have it installed run the following command to create GIF file:

agg https://asciinema.org/a/307459 307459.gif

Or, if you already downloaded the recording file:

agg 307459.cast 307459.gif

Check agg --help for all available options. You can change font family and size, select color theme, adjust speed and more.

See agg manual for full usage instructions.