Lightweight, modular, and extensible library for functional programming.
Scala Shell
Pull request Compare This branch is 278 commits behind typelevel:master.
Latest commit 0408170 Sep 2, 2016 @non committed on GitHub Merge pull request #1350 from non/topic/changes-readme-authors-072
Update CHANGES.md, AUTHORS.md, and README.md for 0.7.2.
Permalink
Failed to load latest commit information.
bench/src/main/scala/cats/bench Fix compile error in benchmark. Aug 19, 2016
core/src/main/scala/cats Add missing backticks. Aug 25, 2016
docs/src Merge pull request #1323 from 47deg/master Aug 23, 2016
free/src Remove redundant parentheses. Aug 25, 2016
js/src Add Either(T) tests and replace Xor with Either in tests Aug 15, 2016
jvm/src/test/scala/cats/tests Add Either(T) tests and replace Xor with Either in tests Aug 15, 2016
kernel-laws/src Add consistency laws for .combineAll and .combineAllOption. Sep 1, 2016
kernel/src/main/scala/cats/kernel Add consistency laws for .combineAll and .combineAllOption. Sep 1, 2016
laws/src/main/scala/cats/laws Reduce the cost of the tailRecM test Aug 25, 2016
macros/src/main/scala/cats/macros Use scala-bricks to extract platform-specific code. Sep 13, 2015
project Syntax for Cartesian operations with tuples Aug 11, 2016
scripts separate kernel js out to help travis Aug 23, 2016
tests/src/test/scala/cats/tests Merge pull request #1327 from markus1189/xort-from-option Aug 24, 2016
.gitignore Add .ensime_cache to gitignore Mar 26, 2016
.jvmopts Fix #18: Scala.JS support Aug 3, 2015
.travis.yml fix botBuild value on travis Aug 19, 2016
AUTHORS.md Update CHANGES.md, AUTHORS.md, and README.md for 0.7.2. Sep 2, 2016
CHANGES.md Fix small (but important) typo. Sep 2, 2016
CONTRIBUTING.md Some attribution work Aug 9, 2016
COPYING add basic license Jan 29, 2015
DESIGN.md Include kernel in modules doc Jun 27, 2016
PROCESS.md wip Jun 15, 2016
README.md Update CHANGES.md, AUTHORS.md, and README.md for 0.7.2. Sep 2, 2016
build.sbt Remove unused import Aug 30, 2016
scalastyle-config.xml Add scalastyle rule for single space after if Jun 24, 2016
version.sbt Setting version to 0.7.2-SNAPSHOT Sep 2, 2016

README.md

Cats

Build Status Workflow Chat codecov.io Latest version Scala.js

Overview

Cats is a library which provides abstractions for functional programming in Scala.

The name is a playful shortening of the word category.

cats image

Why?

Scala supports both object-oriented and functional programming, and this is reflected in the hybrid approach of the standard library. Cats augments the standard library with tools that further enable functional programming such as Validated, Monad, and Traverse. A broader goal of Cats is to provide a foundation for an ecosystem of pure, typeful libraries.

Getting Started

Cats is currently available for Scala 2.10 and 2.11, and Scala.js.

To get started with SBT, simply add the following to your build.sbt file:

libraryDependencies += "org.typelevel" %% "cats" % "0.7.2"

This will pull in all of Cats' modules. If you only require some functionality, you can pick-and-choose from amongst these modules (used in place of "cats"):

  • cats-macros: Macros used by Cats syntax (required).
  • cats-kernel: Small set of basic type classes (required).
  • cats-core: Most core type classes and functionality (required).
  • cats-laws: Laws for testing type class instances.
  • cats-free: Free structures such as the free monad, and supporting type classes.

Release notes for Cats are available in CHANGES.md.

Cats is still under active development. While we don't anticipate any major redesigns, changes that are neither source nor binary compatible are to be expected in upcoming cats releases. We will update the minor version of cats accordingly for such changes. Once cats 1.0 is released (ETA: Q3 2016), there will be an increased focus on making changes in compatible ways.

Documentation

Cats information and documentation is available on the website.

We also have a Scaladoc index.

Finally, we have a list of frequently-asked questions.

Our goal is to have clear and comprehensive documentation. If you notice problems, omissions, or errors, please let us know.

How can I contribute to Cats?

We welcome contributions to Cats and would love for you to help build Cats. See our contributor guide for more information about how you can get involed.

Community

Discussion around Cats is currently happening in the Gitter channel as well as on Github issue and PR pages. You can get an overview of who is working on what via Waffle.io.

People are expected to follow the Typelevel Code of Conduct when discussing Cats on the Github page, Gitter channel, or other venues.

We hope that our community will be respectful, helpful, and kind. If you find yourself embroiled in a situation that becomes heated, or that fails to live up to our expectations, you should disengage and contact one of the project maintainers in private. We hope to avoid letting minor aggressions and misunderstandings escalate into larger problems.

If you are being harassed, please contact one of us immediately so that we can support you.

Maintainers

The current maintainers (people who can merge pull requests) are:

We are currently following a practice of requiring at least two sign-offs to merge PRs (and for large or contentious issues we may wait for more). For typos or other small fixes to documentation we relax this to a single sign-off.

Related Projects

There are many projects that integrate with Cats:

  • Circe: pure functional JSON library.
  • Dogs: pure functional collections and data structures.
  • Fetch: efficient data access to heterogeneous data sources.
  • FS2: compositional, streaming I/O library
  • Kittens: automatically derived type class instances.
  • Monix: high-performance library for composing asynchronous and event-based programs.
  • eff-cats: functional effects and effect handlers (alternative to monad transformers).

Copyright and License

All code is available to you under the MIT license, available at http://opensource.org/licenses/mit-license.php and also in the COPYING file. The design is informed by many other projects, in particular Scalaz.

Copyright the maintainers, 2015-2016.