Skip to content
Snippets Groups Projects
README.md 2.36 KiB
Newer Older
Matt Bovel's avatar
Matt Bovel committed
# Scala 3 SBT Project

This contains the basic sbt configuration needed to run Scala 3 code.

## Installation

1. Check that you have the "Scala (Metals)" and "Scala Syntax (official)" extensions installed in VSCode.
1. Clone this repo: `git clone git@gitlab.epfl.ch:lara/cs206-demos.git`.
1. Open it with VSCode (for example using the command `code .` in `cs206-demos`).
1. Click on "Import SBT Build":
Matt Bovel's avatar
Matt Bovel committed
     
     <img src="https://gitlab.epfl.ch/lamp/cs210/uploads/b1926bf55d4d4ce136859afaaad1c7f2/Screenshot_2021-09-30_at_13.22.36.png" width="500px" />
Matt Bovel's avatar
Matt Bovel committed
1. Wait while Metals runs `bloopInstal`:
Matt Bovel's avatar
Matt Bovel committed
     
     <img src="https://gitlab.epfl.ch/lamp/cs210/uploads/58d513dee61f3584f3e5cf8b10d3510c/Screenshot_2021-09-30_at_13.24.37.png" width="500px" />
Matt Bovel's avatar
Matt Bovel committed

## Usage

### Normal Scala files

Hamza Remmal's avatar
Hamza Remmal committed
“Normal” Scala files (ending with `.scala`) must have a `@main` method. For example, [`01-java-threads.scala`](src/main/scala/lecture1/01-java-threads.scala), the main method is `testThreads`. You can run it from the command-line, first by entering the sbt shell:
Matt Bovel's avatar
Matt Bovel committed

```bash
sbt
```
and then by running:

```bash
runMain testThreads
```

where `testThreads` is the name of the `@main` function. This should output something similar to:

```
sbt:cs206-demos> run testThreads
[info] compiling 1 Scala source to /Users/mbovel/cs206-demos/target/scala-3.2.0/classes ...
[info] running testThreads testThreads
Little threads did not start yet!
ThreadThread-3 has counter 0
ThreadThread-2 has counter 0
ThreadThread-2 has counter 1
Parent thread and children are running!
...
```

You can also directly run it from VSCode using the `run` link:

![Run link displayed in VSCode](images/run_link.jpg)


### Scala worksheets

Inside `src/main/scala`, you can create Scala _worksheets_ (files ending with `.worksheet.sc`). These are special Scala files meant for experimentation where the result of every top-level expression is directly displayed in the IDE. See [the official tutorial about Scala worksheets](https://docs.scala-lang.org/scala3/book/tools-worksheets.html) for more details.

We provide [`sumList.worksheet.sc`](src/main/scala/sumList.worksheet.sc) as an example. If you open it in VSCode, you should see the result of all top-level expressions automatically displayed:

![Example of a worksheet opened in VSCode](images/worksheet_screenshot.png)

Try to change the code and you should see the results automatically updating!