microlens: A tiny lens library with no dependencies. If you're writing an app, you probably want microlens-platform, not this.

This is an extract from lens (with no dependencies). It's not a toy lenses library, unsuitable for “real world”, but merely a small one. It is compatible with lens, and should have same performance. It also has better documentation.

Use this library:

• if you want to define lenses or traversals in your own library, but don't want to depend on lens

• if you are new to lenses and want a small library to play with, but don't want to use something “inferior” or have to relearn things when/if you switch to lens

Don't use this library:

• if you need Isos, Prisms, indexed traversals, or actually anything else which isn't defined here (tho some indexed functions are available elsewhere – containers and vector provide them for their types, and ilist provides indexed functions for lists)

• if you want a library with a clean, understandable implementation (in which case you're looking for lens-simple)

If you're writing an application which uses lenses more extensively, look at microlens-platform – it combines features of most other microlens packages (microlens-mtl, microlens-th, microlens-ghc).

If you want to export getters or folds and don't mind the contravariant dependency, please consider using microlens-contra.

There's a longer readme on Github, you should read it if you're interested about using this library.

If you haven't ever used lenses before, read this tutorial. (It's for lens, but it applies to microlens just as well.)

Note that microlens has no dependencies starting from GHC 7.10 (base-4.8). Prior to that, it has to depend on transformers-0.2 or above.

Modules

[Index]

Downloads

• microlens-0.4.4.1.tar.gz [browse] (Cabal source package)
• Package description (revised from the package)

Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.

Maintainer's Corner

Package maintainers

• Artyom, stevenfontanella

For package maintainers and hackage trustees

• edit package information

Candidates

• 0.4.13.0, 0.4.13.1, 0.4.14.0