shapeless is a type class and dependent type based generic programming library for Scala. It had its origins in several talks by Miles Sabin (@milessabin), given over the course of 2011, on implementing scrap your boilerplate and higher rank polymorphism in Scala. Since then it has evolved from being a resolutely experimental project into library which, while still testing the limits of what's possible in Scala, is being used widely in production systems wherever there are arities to be abstracted over and boilerplate to be scrapped.
A full feature overview of shapeless-2.2.0+ is in preparation. In the meantime, please refer to the release notes and the feature overview for shapeless-2.0.0 which can be found here. If you are upgrading from shapeless-2.0.0 you will find the migration guide useful.
shapeless is part of the Typelevel family of projects. It is an Open Source project under the Apache License v2, hosted on github. Binary artefacts are published to the Sonatype OSS Repository Hosting service and synced to Maven Central.
Most discussion of shapeless and generic programming in Scala happens on the shapeless Gitter channel. There is also a mailing list and IRC channel, but these are largely dormant now that most activity has moved to Gitter. Questions about shapeless are often asked and answered under the shapeless tag on StackOverflow. Some articles on the implementation techniques can be found on Miles's blog, and Olivera, Moors and Odersky, Type Classes as Object and Implicits is useful background material.
The shapeless project supports the Typelevel code of conduct and wants all of its channels (mailing list, Gitter, IRC, github, etc.) to be welcoming environments for everyone.
Whilst shapeless is a somewhat "advanced" Scala library, it is a lot more approachable than many people think. Contributors are usually available to field questions, give advice and discuss ideas on the Gitter channel, and for people wanting to take their first steps at contributing we have a selection of open issues flagged up as being good candidates to take on. No contribution is too small, and guidance is always available.
Binary release artefacts are published to the Sonatype OSS Repository Hosting service and synced to Maven Central. Snapshots of the master and scala-2.10.x branches are built using Travis CI and automatically published to the Sonatype OSS Snapshot repository. To include the Sonatype repositories in your SBT build you should add,
resolvers ++= Seq(
Resolver.sonatypeRepo("releases"),
Resolver.sonatypeRepo("snapshots")
)
Please be aware that SBT 0.13.6 has an issue related to its new name hashing feature which when compiling with shapeless might cause SBT to loop indefinitely consuming all heap. Workarounds are to move to an earlier (0.13.5) or later (0.13.7, 0.13.8) SBT version or disable name hashing by adding,
incOptions := incOptions.value.withNameHashing(false)
to your settings.
Builds are available for Scala 2.11.x and for Scala 2.10.x. The main line of development for shapeless 2.2.1 is Scala 2.11.6 with Scala 2.10.x supported via the macro paradise compiler plugin.
scalaVersion := "2.11.6"
libraryDependencies ++= Seq(
"com.chuusai" %% "shapeless" % "2.2.1"
)
If you are using Scala 2.10.x, note that unlike earlier versions, it is no longer necessary to provide an explicit Scala version suffix for your shapeless dependency. You must however ensure that you are using Scala version 2.10.2 or greater, with Scala 2.10.5 (or switching to 2.11.x) strongly recommended. You should also add the macro paradise plugin to your build,
scalaVersion := "2.10.5"
libraryDependencies ++= Seq(
"com.chuusai" %% "shapeless" % "2.2.1",
compilerPlugin("org.scalamacros" % "paradise" % "2.0.1" cross CrossVersion.full)
)
Please use a current release if possible. If unavoidable, you can find usage information for older releases on the shapeless wiki.
shapeless is built with SBT 0.13.8 or later, and its master branch is built with Scala 2.11.6 by default. To build with Scala 2.10.x you should check out the scala-2.10.x branch. As a general rule all new features and bugfixes are made against master and Scala 2.11.6 and merged into the scala-2.10.x branch with only the minimal changes needed for forwards compatibility.
- Alexander Konovalov alex.knvl@gmail.com @alexknvl
- Alexandre Archambault alexandre.archambault@gmail.com @alxarchambault
- Alistair Johnson alistair.johnson@johnsonusm.com
- Alois Cochard alois.cochard@gmail.com @aloiscochard
- Andrew Brett github@bretts.org @Ephemerix
- Ben Hutchison brhutchison@gmail.com @ben_hutchison
- Ben James ben.james@guardian.co.uk @bmjames
- Brian McKenna brian@brianmckenna.org @puffnfresh
- Chris Hodapp clhodapp1@gmail.com @clhodapp
- Cody Allen ceedubs@gmail.com @fourierstrick
- Dale Wijnand dale.wijnand@gmail.com @dwijnand
- Dario Rexin dario.rexin@r3-tech.de @evonox
- David Barri japgolly@gmail.com @japgolly
- Denis Mikhaylov notxcain@gmail.com @notxcain
- Eugene Burmako xeno.by@gmail.com @xeno_by
- Filipe Nepomuceno filinep@gmail.com
- Frank S. Thomas frank@timepit.eu @fst9000
- George Leontiev folone@gmail.com @folone
- Howard Branch purestgreen@gmail.com @purestgreen
- Huw Giddens hgiddens@gmail.com
- Jason Zaugg jzaugg@gmail.com @retronym
- Jean-Remi Desjardins jeanremi.desjardins@gmail.com @jrdesjardins
- Johannes Rudolph johannes.rudolph@gmail.com @virtualvoid
- Johnny Everson khronnuz@gmail.com @johnny_everson
- Joni Freeman joni.freeman@ri.fi @jonifreeman
- Julien Tournay boudhevil@gmail.com @skaalf
- Jules Gosnell jules_gosnell@yahoo.com
- Kevin Wright kev.lee.wright@gmail.com @thecoda
- Lars Hupel lars.hupel@mytum.de @larsr_h
- Mario Pastorelli mario.pastorelli@teralytics.ch @mapastr
- Mathias Doenitz mathias@spray.io @sirthias
- Michael Donaghy md401@srcf.ucam.org
- Michael Pilquist mpilquist@gmail.com @mpilquist
- Miles Sabin miles@milessabin.com @milessabin
- Nikolas Evangelopoulos nikolas@jkl.gr
- Oleg Aleshko olegych@tut.by @OlegYch
- Owein Reese owreese@gmail.com @OweinReese
- Paolo G. Giarrusso p.giarrusso@gmail.com @blaisorblade
- Pascal Voitot pascal.voitot.dev@gmail.com @mandubian
- Peter Schmitz petrischmitz@gmail.com @peterschmitz_
- Renato Cavalcanti renato@strongtyped.io @renatocaval
- Sam Halliday sam.halliday@gmail.com @fommil
- Sarah Gerweck sarah.a180@gmail.com @SGerweck
- SĂ©bastien Doeraene sjrdoeraene@gmail.com @sjrdoeraene
- Simon Hafner hafnersimon@gmail.com @reactormonk
- Stacy Curl stacy.curl@gmail.com @stacycurl
- Stephen Compall scompall@nocandysw.com @S11001001
- Tom Switzer thomas.switzer@gmail.com @tixxit
- Travis Brown travisrobertbrown@gmail.com @travisbrown
- Vladimir Matveev vladimir.matweev@gmail.com @netvlm