log4effect

Logging with Cats Effect

License	Apache-2.0
Categories	Scala Languages
GroupId	io.scalaland
ArtifactId	log4effect_2.13
Last Version	0.1.0
Release Date	Sep 25, 2019
Type	jar
Description	log4effect Logging with Cats Effect
Project Organization	io.scalaland
Source Code Management	https://github.com/scalalandio/log4effect

Download log4effect_2.13

Filename	Size
log4effect_2.13-0.1.0.pom
log4effect_2.13-0.1.0.jar	23 KB
log4effect_2.13-0.1.0-sources.jar	3 KB
log4effect_2.13-0.1.0-javadoc.jar	1 MB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/io.scalaland/log4effect_2.13/ -->
<dependency>
    <groupId>io.scalaland</groupId>
    <artifactId>log4effect_2.13</artifactId>
    <version>0.1.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/io.scalaland/log4effect_2.13/
implementation 'io.scalaland:log4effect_2.13:0.1.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/io.scalaland/log4effect_2.13/
implementation ("io.scalaland:log4effect_2.13:0.1.0")

Apache Buildr

'io.scalaland:log4effect_2.13:jar:0.1.0'

Apache Ivy

<dependency org="io.scalaland" name="log4effect_2.13" rev="0.1.0">
  <artifact name="log4effect_2.13" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='io.scalaland', module='log4effect_2.13', version='0.1.0')
)

Scala SBT

libraryDependencies += "io.scalaland" % "log4effect_2.13" % "0.1.0"

Leiningen

[io.scalaland/log4effect_2.13 "0.1.0"]

Dependencies

compile (4)

Group / Artifact	Type	Version
org.scala-lang : scala-library	jar	2.13.1
org.typelevel : cats-core_2.13	jar	2.0.0
org.typelevel : cats-effect_2.13	jar	2.0.0
com.typesafe.scala-logging : scala-logging_2.13	jar	3.9.2

test (3)

Group / Artifact	Type	Version
ch.qos.logback : logback-classic	jar	1.2.3
org.specs2 : specs2-core_2.13	jar	4.7.1
org.specs2 : specs2-scalacheck_2.13	jar	4.7.1

Project Modules

There are no modules declared in this project.

log4effect

If you missed some syntax for logging with Cats Effect, then here it is.

Getting started

Library is available for Scala 2.11, 2.12, 2.13.

Add it with:

libraryDependencies += "io.scalaland" %% "log4effect" % log4EffectVersion

Usage

Logging is done using Logged type class:

import cats.effect.Sync
import io.scalaland.log4effect.Logged

def operation[F[_]: Sync: Logged] = for {
  a <- Sync[F].defer(1 + 1)
  b <- Sync[F].defer(2 + 2)
  _ <- Logged[F].info(s"a = $a b=$b")
} yield a -> b

If you want you can use interpolator syntax - it assumes that there is cats.Show instance for any value that you use in it.

import cats.implicits._
import io.scalaland.log4effect.Logged
import io.scalaland.log4effect.syntax._

val i = 1
val d = 1.0
val s = "test"

def logs[F[_]: Monad: Logged] = for {
  _ <- trace"$i $d $s"[F]
  _ <- trace"$i $d $s".withEx[F](new Exception("with ex"))
  _ <- debug"$i $d $s"[F]
  _ <- debug"$i $d $s".withEx[F](new Exception("with ex"))
  _ <- info"$i $d $s"[F]
  _ <- info"$i $d $s".withEx[F](new Exception("with ex"))
  _ <- warn"$i $d $s"[F]
  _ <- warn"$i $d $s".withEx[F](new Exception("with ex"))
  _ <- error"$i $d $s"[F]
  _ <- error"$i $d $s".withEx[F](new Exception("with ex"))
} yield ()

If there is no cats.Show you'd have to call .toString explicitly.

Scalaland.io

We have another fantastic day writing Scala

Versions

Version
0.1.0 Sep 25, 2019