This repository contains exercises, hints, and answers for the book Functional Programming in Scala. Along with the book itself, it's the closest you'll get to having your own private functional programming tutor without actually having one.
There are two main branches in this repository:
Be sure to select the branch which matches the edition of the book you are reading!
Here's how to use this repository:
Each chapter in the book develops a fully working library of functions
and data types, built up through a series of exercises and example code
given in the book text. The shell of this working library and exercise
stubs live in
src/main/scala/fpinscala/exercises/<chapter-description>, where
<chapter-description> is a package name that corresponds to the
chapter title (see below). When you begin working on a chapter, we
recommend you open the exercise file(s) for that chapter, and when you
encounter exercises, implement them in the exercises file and make sure
they work.
If you get stuck on an exercise, let's say exercise 4 in the chapter,
you can find hints in answerkey/<chapter-description>/04.hint.md (if
no hints are available for a problem, the file will just have a single
'-' as its contents) and the answer along with an explanation of the
answer and any variations in
answerkey/<chapter-description>/04.answer.md. The finished Scala
modules, with all answers for each chapter live in
src/main/scala/fpinscala/answers/<chapter-description>. Please feel
free to submit pull requests for alternate answers, improved hints, and
so on, so we can make this repo the very best resource for people
working through the book.
Chapter descriptions:
- Chapter 2: gettingstarted
- Chapter 3: datastructures
- Chapter 4: errorhandling
- Chapter 5: laziness
- Chapter 6: state
- Chapter 7: parallelism
- Chapter 8: testing
- Chapter 9: parsing
- Chapter 10: monoids
- Chapter 11: monads
- Chapter 12: applicative
- Chapter 13: iomonad
- Chapter 14: localeffects
- Chapter 15: streamingio
Setup build environment
The project is setup to use Scala CLI. First install Scala CLI by following the installation instructions.
You'll also likely want an editor that's aware of Scala syntax. VSCode with the Metals extension works great.
Building
To build the code for the first time, from the root directory of the project (i.e., the directory where this README.md is located):
$ scala-cli compile .
This compiles all exercises and answers. You can also do:
$ scala-cli console .
to get a Scala REPL (prompt scala>) with access to exercises and answers, and then for example:
scala> import fpinscala.exercises.datastructures.List
to import the List data type.
To run the sample programs:
$ scala-cli run .
This gives a list of possible main methods to execute. To run one of them:
$ scala-cli run . --main-class fpinscala.answers.gettingstarted.printAbs
To run a single unit-test, you can specify the fully qualified class name and test name:
$ scala-cli test . -- 'fpinscala.exercises.gettingstarted.GettingStartedSuite.MyProgram.factorial'
To run unit-tests for a package you can do:
$ scala-cli test . -- 'fpinscala.exercises.gettingstarted.*'
To run all unit-tests:
$ scala-cli test .
Note, running all tests will result in failures. As you solve exercises, the tests will start to pass.
SBT
Note: an SBT build is also provided.
License
All code in this repository is MIT-licensed. See the LICENSE file for details.
Have fun, and good luck! Also be sure to check out the community wiki for the chapter notes, links to more reading, and more.
Paul, Rúnar, and Michael