====== GSF: Gradual System F ======

GSF is a gradual counterpart of System F, ie. it is a core functional language with explicit polymorphism and gradual types. Crucially, GSF satisfies all the expected properties of a gradual parametric language such as type safety, the static gradual guarantee, and parametricity. We show in the paper that the dynamic gradual guarantee is incompatible with parametricity, and GSF favors parametricity. Nevertheless, GSF satisfies a weaker property of "imprecise embedding of System F", which essentially means that the gradual medium of GSF is harmless. This property allows us to disprove several claims about gradual free theorems, clarifying the kind of reasoning supported by gradual parametricity--see the paper for details.

In this tutorial we present IGSF, a web executable model of GSF implemented in Scala and React.js. IGSF shows interactive typing and reduction derivations for arbitrary source programs. In particular, it shows the evidence-augmented terms/derivations, and highlights the evidence combinations that occur at each reduction step.


The tutorial covers: 
  * How to install and run a web interpreter for GSF
  * A basic presentation of the language syntax
  * IGSF in action through examples found in the paper


===== Installation instructions =====

We provide four ways to access IGSF (although we strongly recommend the first one!):

  - **Using the online implementation** at [[https://pleiad.cl/gsf]]. 
  - **With the virtual machine**, which can be downloaded [[https://pleiad.cl/files/GSF.ova|here]]
  - **Local execution of binaries**, which can be downloaded [[https://pleiad.cl/files/gsf-bin.zip|here]].
  - **Compilation and execution of the source code**, which can be downloaded [[https://pleiad.cl/files/gsf-sources.zip|here]].

The online implementation does not require any installation and is always up-to-date. If you want to get a snapshot of the current state of the interpreter (as of October 10, 2018), then follow the instructions for points 2 to 4.

==== The virtual machine ====
We have set up a virtual machine with an Ubuntu installation and Java 1.8. The virtual machine image was created with Virtual Box 5.2.18.
  - Install Virtual Box 5.2.18 or higher.
  - Import the Virtual Machine Image
  - Start the Virtual Machine
  - Use the following credentials to log in: username: ubuntu, password: ubuntu
  - Open a terminal. Make sure you are at home: <code bash>
cd
</code>
  - Run <code bash>
./gsf-0.9/bin/gsf
</code>

This should start a server on port 9000. To open IGSF go to http://localhost:9000/gsf/

You can find the source code as well in folder ''gsf''. Instruction on how to compile and execute the source files is described below.

==== Local execution of the binaries ====

To run IGSF locally, all you need is Java 1.8. Also, check that you have Java 1.8 in the path.

The following instructions are Unix valid commands. If you have Windows installed in your machine, you need to perform the corresponding commands.
  - Unzip the file.<code bash>
unzip gsf-bin.zip
</code>
  - Go to the "gsf " folder:<code bash>
cd gsf-0.9
</code>
  - Add run permissions to the binary file:<code bash>
chmod +x bin/gsf
</code>
  - And then run:<code bash>
./bin/gsf
</code>This should start a server in the port 9000. To open IGSF, go to http://localhost:9000/gsf/
  - In case the port 9000 is already taken, run:<code bash>
./bin/gsf -Dhttp.port=<available-port-number>
</code>


==== Compilation and execution of the source code ====
To compile IGSF you need to have installed:
  - SBT (http://www.scala-sbt.org/)
  - Node v8.9.1 (https://nodejs.org/)
  - JDK8 (https://www.oracle.com/technetwork/java/javase/downloads/)

We start by unzipping the sources.<code bash>
unzip gsf-sources.zip  
</code>

Then we can proceed to compile the frontend, or skip this and go straight to compile the backend (frontend is pre-compiled in location ''public/javascript/app.js''=

=== Compiling the frontend ===
To compile this javascript file, you have to enter the node folder first. 
  - From the application folder:<code bash>
cd node
</code>
  - Then we have to install node packages (it may take a while).<code bash>
npm i
</code>
  - Then once all the packages have been installed, we proceed to build and copy the generated javascript file into the web server. There is a convenient file that does this called ''make''. <code bash>
./make
</code> If the file does not have permission to run, then execute the following: <code bash>
chmod +x make
</code>

=== Compiling the backend ===
  - From the application folder we start SBT: <code bash>
sbt
</code>
  - Then we compile the application as follows (it may take a while the first time):<code bash>
compile
</code>

=== Running the application ===
  - From the application folder we start SBT (unless you already started it): <code bash>
sbt
</code>
  - Then we start the web application as follows:<code bash>
run
</code>This should start a server in the port 9000. To open IGSF, go to http://localhost:9000/gsf/
  - In case the port 9000 is already taken, run:<code bash>
run <available-port-number>
</code>


=== Distributing the application ===
  - From the application folder we start SBT (unless you already started it): <code bash>
sbt
</code>
  - Then to generate a zip file with all the binaries we execute:<code bash>
dist
</code>''SBT'' will generate the zip file located at ''target/universal/gsf-0.9.zip''




===== IGSF: How to use the online interpreter =====
The following screenshot shows how the prototype implementation looks like

{{:research:software:gsf:overview.png?700|}}

Given a source program, the application shows its typing and reduction derivations.

The implementation is composed of four main areas:

==== The predefined examples area ====
 
{{:research:software:gsf:select.png?700|}}

Here you can select examples from a predefined list of examples. Once an example is selected, a description is shown below and the source of the example is presented in the following area.

==== The scractchpad area ====


{{:research:software:gsf:textarea.png?700|}}

This is the place where you input source programs. The syntax of the language is the following:

{{:research:software:gsf:syntax.png?500|}}

Types can be natural numbers ''Int'', booleans ''Bool'', functions ''G -> G'', polymorphic types ''∀X.G'', pairs ''G*G'', type variables ''X'', type names ''α'' (although not part of the source language), and the unknown type ''?'' -- which may represent any type. 

A simple value ''u'' can be a boolean ''true'' or ''false'', a natural number, a typed function ''(λx: G. t)'', an untyped function ''(λx. t)'' as a shortcut for ''(λx: ?. t)'', a type abstraction ''ΛX.t'', or a pair of simple values ''<u, u>''.

A value ''v'' is just an ascribed simple value ''u :: G''.

A term can be a value ''v'', a pair of values ''<v,v>'', a variable ''x'', an ascription ''t :: G'', an addition ''t + t'', a conditional ''if t then t else t'', an application ''t t'', a type application ''t [G]'', a projection ''fst t'' or ''snd t'', a typed let expression ''let x: G = t in t'' or an untyped let expression ''let x = t in t'' as a shortcut for ''let x: ? = t in t''.

For convenience, when you type''\'' it is inserted a ''λ'' instead, ''L'' is changed for ''Λ'' and ''F'' for ''∀''.

==== The action area ====

{{:research:software:gsf:button.png?300|}}

Here you can type check the source program by clicking the "TYPECHECK!" button. If the source program is valid then its typing derivation is shown below, otherwise an error is shown. 
The other button is "CLEAR SCARTCHPAD" which will clear the scratchpad as the name suggest. 


==== The options area ====

{{:research:software:gsf:options.png?200|}}

Here there is a toggle button to enable or disable the presentation of evidence during typechecking and reduction. By default this option is disabled.


===== Examples =====
==== Example 1: getting started ====
For instance, let us consider this simple starting example:

{{:research:software:gsf:example1.png?700|}}

If we click the "TYPECHECK!" button, then its typing derivation is shown as follows:

{{:research:software:gsf:typechecking.png?700|}}

If we click the "REDUCE!" button, then its reduction derivation is shown step by step as shown below:

{{:research:software:gsf:typecheck.png?700|}}

Each step shows the redux in red and the store typing in the bottom right corner.
Note as programs may loop infinitely (with ''?'' we can encode omega), the prototype only presents the first 10 steps of reduction. If after 10 reduction steps the program is still reducible, another button is presented to reduce another 10 steps.

The reduction of the program is presented as the reduction of //intrinsic terms//: derivation trees augmented with evidence. An evidence reflects the justification of why a given consistent judgment holds. 
Each derivation tree can be expanded by clicking the button on the top-right corner:


{{:research:software:gsf:tree.png?700|}}

We can also show the evidences of each term in green by activating the "show evidences" option:

{{:research:software:gsf:showevidence.png?200|}}

Then the same derivation tree is now shown as follows:

{{:research:software:gsf:tree-expand.png?700|}}


==== Static and dynamic errors ====
The prototype implementation reports static errors after the "TYPECHECK!" button is clicked. For example:

{{:research:software:gsf:static-errors.png?700|}}

Now let us add an ascription to the boolean value:

{{:research:software:gsf:dynamic-error1.png?700|}}

Now it is valid statically but it fails at runtime as shown below:

{{:research:software:gsf:dynamic-error2.png?900|}}
{{:research:software:gsf:dynamic-error3.png?900|}}


==== Translation of source programs ====

GSF relies on a type-directed, straightforward translation that inserts explicit ascriptions everywhere consistency is used. 
Consider the following program:

{{:research:software:gsf:translation1.png?700|}}

Here, every value is ascribed, and every argument of an application is ascribed (when needed) to the exact type of the domain of the function:

{{:research:software:gsf:translation2.png?700|}}







==== Example 2: respecting parametricity ====
Let us look at another example which shows how GSF enforces parametricity dynamically.


In the following program, function ''f'' expects as argument a function ''g'' of type ''∀X .X → X''. Function ''f'' is applied to an argument ''h'' of unknown type. By consistency, this program is well-typed; however the compliance of ''h'' with respect to its assumed parametric signature is unknown statically. 


{{:research:software:gsf:example2-1.png?700|}}

Function ''h'' is the standard System F identity function, therefore the program produces the result 10.

{{:research:software:gsf:example2-2.png?400|}}

Now consider the following program:

{{:research:software:gsf:example2-3.png?700|}}

Function ''h'' now is less precise than before, but still a valid identity function. Therefore, the program produces the result 10.

{{:research:software:gsf:example2-2.png?400|}}

Now consider a slightly different program:

{{:research:software:gsf:example2-4.png?700|}}


Now function ''h'' is not a proper identity function. Note that the function is well-typed, because x has type ''?'' in the body. Also, using ''h'' in the program above is type safe, because ''f'' happens to instantiate its argument at type ''Int'', so execution could proceed safely without errors and yield 11; this would however be a violation of parametricity, so an error should be raised:

{{:research:software:gsf:example2-5.png?700|}}



==== Example 3: respecting scoping ====
GSF ensures proper scoping of type variables at runtime. 
Consider the following program:

{{:research:software:gsf:example3-1.png?700|}}

This program, contrary to prior work, does not fail as it correctly unseals the returned value of the function application:

{{:research:software:gsf:example3-2.png?400|}}


==== Example 3: respecting instantiations ====

GSF enforces type instantiations even when applied to an imprecisely-typed value. Consider the following program:

{{:research:software:gsf:example4-1.png?700|}}

This program, contrary to prior work, throws a runtime error as the instantiated function is called with a boolean after being instantiated to ''Int''.:

{{:research:software:gsf:example4-2.png?700|}}