Permalink
Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
115 lines (75 sloc) 4.23 KB

Declare Your Language in Spoofax

Instructions for the hands-on Spoofax tutorial at the DSLDI Summer School at EPFL in Lausanne on July 13, 2015

Please go through sections A. and B. before the session on Monday morning.

A. Installing Spoofax

We highly recommend to work with a fresh Eclipse and Spoofax installation. You can download a copy for your OS and architecture:

B. The Tutorial Projects

You should start with a fresh Eclipse workspace and import the prepared Spoofax projects into the workspace. You can download the zip or clone the git repository. The zip: paplj-exercises. The git repository: https://github.com/MetaBorgCube/declare-your-language.

  1. Start Eclipse.
  2. Select a fresh workspace.
  3. Configure preferences (Eclipse > Preferences)
    1. Change appearance to Classic look (optional)
    2. Change font (General > Appearance > Colors and Fonts) then (Basic > Text Font) to Monaco 14pt (or something you like better)
    3. Turn off ‘Build Automatically’ in the Project menu
  4. Import the initial Spoofax projects into your workspace:
    1. Right-click into the Package Explorer.
    2. Select Import… from the context menu.
    3. Choose Existing Projects into Workspace… from the list.
    4. Select the **languages/paplj` directory.
    5. Import all projects into your workspace by pressing the Finish button.
    6. Close all projects (right click on project, choose Close Project)
  5. Build the first project 6. Select the paplj.syntax project. 7. Build the project by choosing Build Project from the Project menu or by pressing the corresponding keyboard shortcut (Ctrl+Alt+B, or Cmd+Alt+B for MacOSX). 8. Restart Eclipse by going to the File menu and choosing Restart.

1. Syntax

  • Open projects paplj.syntax, paplj.syntax.exercises

  • Build the paplj.syntax project

  • Open a test-suite in the exercises project

    • Run the Run testsuites entry in the Transform menu
  • Add productions to make the exercise tests succeed

    • syntax/Expressions.sdf3
    • syntax/Classes.sdf3
  • Use the doodle.pj file to try out different programs, or make your own

  • Try out the Syntax menu

    • Format
    • Show Abstract Syntax
    • How do ‘Builders’ work?
  • Close project paplj.syntax

2. Transformation

  • Open paplj.transformation, paplj.transformation.exercises

  • Inspect the solution for the syntax exercises

  • Add rewrite rules to make the exercise tests succeed

    • trans/desugar/desugar-rules.str
    • trans/desugar/resugar-rules.str
  • Use the doodle.pj file to try out different programs, or make your own

  • Try out the Transform menu

    • Desugar
    • Desugar AST
  • Close project paplj.transformation

3. Name and Type Analysis

  • Open projects paplj.analysis, paplj.analysis.exercises

  • Inspect the solution for the transformation exercises

  • Add name binding rules to make the exercise tests succeed

    • trans/check/names.nab
  • Add type rules to make the exercise tests succeed

    • trans/check/types.ts
  • Close project paplj.analysis

4. Dynamic Semantics

  • Open projects paplj.semantics, paplj.semantics.exercises

  • Inspect the solution for the analysis exercises

  • Add reduction rules to make the exercise tests succeed

    • trans/semantics/interp.ds
  • To build, first generate Java code from DynSem

    • Use All to Java entry in Semantics menu for trans/semantics/semantics.ds
  • Close project paplj.semantics

5. Full Definition

The project paplj.full contains the full definition of the dynamic semantics