Skip to content

underscoreio/essential-slick

Repository files navigation

Essential Slick

Build Status

Creative Commons Licence
Essential Slick by Richard Dallaway, Jonathan Ferguson, Underscore Consulting LLP is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

Overview

Essential Slick is a book to get you started building application using the Slick database library. It is aimed at Scala developers who need to become productive with Slick quickly.

It follows a tutorial style and includes exercises.

Download

You can download the PDF, EPUB, and HTML formats of this book for free from the book web page.

Table of Contents

  1. Basics

  2. Selecting Data

  3. Creating and Modifying Data

  4. Action Combinators and Transactions

  5. Data Modelling

  6. Joins and Aggregates

  7. Plain SQL

A. Using Different Database Products

B. Solutions to Exercises

Building the Book

This book uses Underscore's ebook build system.

The simplest way to build the book is to use Docker Compose:

  • install Docker Compose; and
  • run go.sh (or docker-compose run book bash if go.sh doesn't work).

This will open a bash shell running inside the Docker container which contains all the dependencies to build the book. From the shell run:

  • mkdir dist
  • npm install; and then
  • ./sbt.sh.

Within sbt you can issue the commands pdf, html, epub, or all to build the desired format(s) of the book.

When you build the book, you'll see Unknown link warning messages. You can ignore these (and if anyone wants to find out why they happen, do go for it).

The results are placed in the dist directory.

Writing

  • Essential Slick uses mdoc to check the Scala code on the book.
  • The source files are in src/pages.
  • The converted sources are output to target/pages.