diff --git a/docs/src/main/tut/faq.md b/docs/src/main/tut/faq.md index 3ff0888fbd..0c66717d25 100644 --- a/docs/src/main/tut/faq.md +++ b/docs/src/main/tut/faq.md @@ -25,6 +25,7 @@ position: 40 * [How can I test instances against their type classes' laws?](#law-testing) * [How can I help?](#contributing) * [Is there a sbt plugin that facilitate projects based on the Cats ecosystem libraries?](#sbt-catalysts) + * [How to try cats in a REPL?](#ammonite) ## What imports do I need? @@ -258,3 +259,13 @@ See the [contributing guide]({{ site.baseurl }}/contributing.html) for more info Of course. [sbt-catalysts](https://github.com/typelevel/sbt-catalysts) is created particularly for this purpose. It also provides a g8 template so that you can run `sbt new typelevel/sbt-catalysts.g8` to quickly set up a project using Cats ecosystem libraries through this plugin. For more details, go to [sbt-catalysts](https://github.com/typelevel/sbt-catalysts). +## How to try Cats in a REPL? + +The easiest way is probably using [Ammonite-REPL](http://ammonite.io/). Install it following the instructions there. Then in the amm console you can type in +```scala +interp.configureCompiler(_.settings.YpartialUnification.value = true) +import $ivy.`org.typelevel::cats-core:1.0.1`, cats.implicits._ +``` +Or if you want, you can add these lines to `~/.ammonite/predef.sc` so that they are enabled every ammonite session. + +