mdoc VS cats-effect

Compare mdoc vs cats-effect and see what are their differences.

mdoc

Typechecked markdown documentation for Scala (by scalameta)
Our great sponsors
  • InfluxDB - Power Real-Time Data Analytics at Scale
  • WorkOS - The modern identity platform for B2B SaaS
  • SaaSHub - Software Alternatives and Reviews
mdoc cats-effect
4 34
387 1,961
1.0% 2.1%
8.4 9.7
12 days ago 3 days ago
Scala Scala
Apache License 2.0 Apache License 2.0
The number of mentions indicates the total number of mentions that we've tracked plus the number of user suggested alternatives.
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.

mdoc

Posts with mentions or reviews of mdoc. We have used some of these posts to build our list of alternatives and similar projects. The last one was on 2022-04-20.
  • Optimal decision-making with examples built using scala
    4 projects | /r/scala | 20 Apr 2022
  • Friction-less scala - Tell us what is causing friction in your day-to-day life with Scala
    14 projects | /r/scala | 10 Aug 2021
    Literally what scaladoc is, it comes with sbt. Although, it's better when enhanced with mdoc so that you get the standard microsite template like these. It would be nice to have an sbt serveDocs and if everyone would host their docs for external linking, but javadoc doesn't do that either.
  • A Scala rant
    9 projects | /r/scala | 31 Mar 2021
    The good news is that scaladoc is produced by default by sbt and published by default. So you can often pull it from the same repository your library jar came from, extract it with zip, and read the docs. But that's also totally unnecessary - javadoc.io allows you to put in your module info and serves the docs for you, so if there's an older version you can access the documentation this way. Rely on the type signatures, since they can't lie, whilst comments (including scaladoc comments) can. Honestly, library authors should be using mdoc and including examples on every public method, and that type of documentation is something you can almost always contribute to a project for a quick pr kudos.
  • The future of Scaladoc
    3 projects | /r/scala | 8 Mar 2021
    I know it's not new but the "Snippet validation and results (mdoc)" features in mdoc are so cool. Really takes some of the tedium out of working with documentation since you can know that as you evolve your code the compiler will make sure you keep the docs in sync. Whole new level of Readme-Driven Development

cats-effect

Posts with mentions or reviews of cats-effect. We have used some of these posts to build our list of alternatives and similar projects. The last one was on 2023-04-25.
  • A question about Http4s new major version
    3 projects | /r/scala | 25 Apr 2023
    Those benchmarks are using a snapshot version of cats-effect. I don't know where that one comes from, but previously they were using a snapshot from https://github.com/typelevel/cats-effect/pull/3332 which had some issues (3.5-6581dc4, 70% performance degradation), which have since been resolved (see that PR for more info and comparative benchmarks).
  • The Great Concurrency Smackdown: ZIO versus JDK by John A. De Goes
    3 projects | /r/scala | 18 Feb 2023
    Recently, CE3 has had similar issues reported across multiple repositories, almost an epidemic of reports!
  • 40x Faster! We rewrote our project with Rust!
    5 projects | /r/rust | 30 Jan 2023
    The one advantage Rust has over Scala is that it detects data races at compile time, and that's a big time saver if you use low level thread synchronization. However, if you write pure FP code with ZIO or Cats Effect that's basically a non-issue anyway.
  • Sequential application of a constructor?
    2 projects | /r/scala | 21 Jan 2023
    See also cats-effect and fs2. cats-effect gives you your IO Monad (and IOApp to run it with on supported platforms). fs2 is the ecosystem’s streaming library, which is much more pervasive in functional Scala than in Haskell. For example, http4s and Doobie are both based on fs2.
  • Should I Move From PHP to Node/Express?
    13 projects | /r/node | 13 Oct 2022
    On the contrary, switching to the functional mindset, with something like Typelevel Scala3 and respective cats and cats-effect fs2 frameworks, helps to rethink a lot of designs and development approaches.
  • Next Steps for Rust in the Kernel
    8 projects | news.ycombinator.com | 21 Sep 2022
    I think "better Haskell on JVM" (in contrast to "worse Haskell") is a good identity for Scala to have. (Please note that this is an intentional hyperbole.)

    Of course, there are areas where Haskell is stronger than Scala (hint: modularity, crucial for good Software Engineering, is not one of them). And Scala has its own way of doing things, so just imitating Haskell won't work well.

    Examples of this "better Haskell" are https://typelevel.org/cats-effect/ and https://zio.dev/ .

    All together, Scala may be a better choice for you if you want to do Pure Functional Programming. And is definitely less risky (runs on JVM, Java libraries interop, IntelliJ, easy debugging, etc...).

    None of the other languages you mentioned are viable in this sense (if also you want a powerful type system, which rules out Clojure).

    I agree that Rust's identity is pretty clear: a modern language for use cases where only C or C++ could have been used before.

  • Java 19 Is Out
    4 projects | news.ycombinator.com | 20 Sep 2022
    I would use Scala. I like FP and Scala comes with some awesome libraries for concurrent/async programming like Cats Effect or ZIO. Good choice for creating modern style micro-services to be run in the cloud (or even macro-services, Scala has a powerful module system, so it's made to handle large codebases).

    https://typelevel.org/cats-effect/

    https://zio.dev/

    The language, the community and customs are great. You don't have to worry about nulls, things are immutable by default, domain modelling with ADTs and patter matching is pure joy.

    The tooling available is from good to great and Scala is big enough that there are good libraries for typical if not vast majority of stuff and Java libs as a reliable fallback.

  • Typelevel Native
    1 project | /r/scala | 20 Sep 2022
    What took my interest is this (for both JVM and future multithreaded Scala native): https://github.com/typelevel/cats-effect/discussions/3070 Having the same threads poll available IO events and execute callbacks should improve performance greatly
  • Scala isn't fun anymore
    10 projects | /r/programming | 10 Sep 2022
    The author is the creator of Monix and implemented the first version of cats-effect. He knows what he is doing.
  • Question about some advanced types
    3 projects | /r/scala | 5 Sep 2022
    You want Kernmantle, which quite honestly shouldn't be hard to implement around Cats and cats-effect. In particular, although Kernmantle doesn't require the use of the Arrow typeclass, there happen to be Arrow (actually ArrowChoice) instances for both Function1 from the standard library and Kleisli from Cats itself, given a Monad instance for the Kleilsi's F[_] type parameter. In other words, we should be able to port Kernmantle from Haskell to Scala (with the Typelevel ecosystem) and instantly be able to use pretty much anything else from the Typelevel ecosystem, or wrapped with it, in our workflow graphs. Pure functions, monadic functions, applicative functions, GADTs with hand-written interpreters, any of it. I think this would be eminently worth doing.

What are some alternatives?

When comparing mdoc and cats-effect you can also consider the following projects:

sbt-unidoc - sbt plugin to create a unified Scaladoc or Javadoc API document across multiple subprojects.

ZIO - ZIO — A type-safe, composable library for async and concurrent programming in Scala

sbt-mima-plugin - A tool for catching binary incompatibility in Scala

FS2 - Compositional, streaming I/O library for Scala

sbt-revolver - An SBT plugin for dangerously fast development turnaround in Scala

fs2-grpc - gRPC implementation for FS2/cats-effect

sbt-pack - A sbt plugin for creating distributable Scala packages.

doobie-quill - Integration between Doobie and Quill libraries

coursier - Pure Scala Artifact Fetching

Kategory - Λrrow - Functional companion to Kotlin's Standard Library

sbt-updates - sbt plugin that can check Maven and Ivy repositories for dependency updates

Slick - Slick (Scala Language Integrated Connection Kit) is a modern database query and access library for Scala