Essential Scala Code

This repository contains exercises and solutions for Underscore's Essential Scala training course.

If you want to discuss the content or exercises with the authors, join us in our chat room on Gitter.

Using the Source Code

This repository contains two branches: one for exercises and one for solutions. The directory structure is the same in each branch.

You will need to have Git and Java and an internet connection to run the exercises. All other dependencies are either included with the repo or downloaded on demand during compilation.

Notes on Editors and IDEs

If you don't have a particular preference for a Scala editor or IDE, we recommend you do the exercises for this course using the Visual Studio Code editor and a Linux or OS X terminal. See the instructions below to get started.

If you want to use Scala IDE for Eclipse, we recommend using sbteclipse. Follow the instructions on the sbteclipse web page to install it as a global SBT plugin.

If you want to use IntelliJ IDEA, follow the instructions for Importing an SBT Project in the IntelliJ online documentation.

Getting Started on Linux or OS X

To get started:

1. To run these exercises, you need a Java 8 compatible JDK on your machine. If you don't have this already, you can download and install one from Oracle Java SE Development Kit 8+ or OpenJDK 8+.

2. Clone this repository to a directory on your hard drive, e.g. ~/essential-scala-code:

   bash$ git clone https://github.com/underscoreio/essential-scala-code.git
   

3. Change to the root directory in the repository:

   bash$ cd essential-scala-code
   

4. Run the sbt.sh script. You may have to wait while SBT downloads various dependencies:

   bash$ ./sbt.sh
   # Lots of output here...
   # The first run will take a while...
   
   >
   

5. Type runMain intro.HelloWorld at the SBT prompt. You may have to wait while SBT downloads various dependencies.

6. If you see the message "Hello world!", you're ready to go!

If you have any problems getting started, get in touch on Gitter.

Getting Started on Windows

You will need to have installed Git and Java (we recommend Oracle's Java 7 SDK). Complete the following steps outlined in Chapter 1 in the section entitled "Setting up SBT for This Book":

1. To run these exercises, you need a Java 8 compatible JDK on your machine. If you don't have this already, you can download and install one from Oracle Java SE Development Kit 8+ or OpenJDK 8+.

2. Clone this repository to a directory on your hard drive, e.g. C:\essential-scala-code:

   C:\> git clone https://github.com/underscoreio/essential-scala-code.git ↩
                    C:\essential-scala-code
   

3. Change to the root directory in the repository:

   C:\> cd\essential-scala-code
   

4. Run the sbt.bat script. You may have to wait while SBT downloads various dependencies:

   C:\essential-scala-code> sbt
   # Lots of output here...
   # The first run will take a while...
   
   >
   

5. Type runMain intro.HelloWorld at the SBT prompt. You may have to wait while SBT downloads various dependencies.

6. If you see the message "Hello world!", you're ready to go!

If you have any problems getting started, get in touch on Gitter.