Skip to content

bizzabo/lens

master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
src
 
 
 
 
 
 
 
 
 
 

lens

Join the chat at https://gitter.im/xdotai/lens

User-friendly lens syntax for mortals. Update values inside of nested case class instances without .copy .

Based on Monocle. Also see optics-dev/Monocle#208 and optics-dev/Monocle#204 .

Use with caution. .copy and likewise .lens can make code hard to read. They are conceptually creating patched versions of existing objects. It can be hard for readers to reason about the patching, similar to how it is hard to reason about mutation. If you can write your code in a way that does not need patching objects, prefer that. If you can't, .lens is a nice alternative to .copy.

SBT Dependency

Scala 2.11

"ai.x" %% "lens" % "1.0.0"

Scala 2.12

"ai.x" %% "lens" % "2.0.0"

Usage

case class C( d: Int )
case class B( c: C )
case class A( b: B )
val a = A(B(C(3)))

Easy updates using .lens

import ai.x.lens.ImplicitBoundLens
A(B(C(5))) == a.lens(_.b.c.d).set( 5 )
A(B(C(6))) == a.lens(_.b.c.d).modify( _ + 3 )

Verbose updates using .copy

A(B(C(5))) == a.copy(
  b = a.b.copy(
    c = a.b.c.copy(
      d = 5
)))

A(B(C(6))) == a.copy(
  b = a.b.copy(
    c = a.b.c.copy(
      d = a.b.c.d + 3
)))

Related Work

ai.x.lens is very similar to quicklens, which implements more features to slightly reduce code size. But this also mean more learning and remembering. It's fair to make the trade-off in either direction. Check out quicklens if you want more features. Use ai.x.lens if you want something simpler.

About

User-friendly lens syntax for mortals. Update values inside of nested case class instances without .copy .

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages