atelier-prelude: Custom relude-based prelude with Effectful conventions

[ library, mit, prelude ] [ Propose Tags ] [ Report a vulnerability ]

A custom prelude based on relude, adapted for Effectful — part of the atelier toolkit.


[Skip to Readme]

Downloads

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

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.1.0.0, 0.2.0.0, 0.3.0.0, 0.3.1.0, 0.4.0.0, 0.4.1.0
Change log CHANGELOG.md
Dependencies base (>=4.18 && <4.23), effectful-core (>=2.7 && <2.8), relude (>=1.2 && <1.3) [details]
Tested with ghc ==9.14.1, ghc ==9.6.7, ghc ==9.8.4, ghc ==9.10.3, ghc ==9.12.4
License MIT
Author Christian Georgii
Maintainer victor.bakke@tweag.io
Uploaded by Gipphe at 2026-09-18T09:06:28Z
Revised Revision 1 made by Gipphe at 2026-09-25T13:08:40Z
Category Prelude
Home page https://github.com/tweag/tricorder/tree/main/atelier-prelude
Bug tracker https://github.com/tweag/tricorder/issues
Source repo head: git clone https://github.com/tweag/tricorder
Distributions Stackage:0.4.1.0
Reverse Dependencies 5 direct, 0 indirect [details]
Downloads 49 total (31 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2026-09-18 [all 1 reports]

Readme for atelier-prelude-0.4.1.0

[back to package description]

atelier-prelude

A custom prelude based on relude, adapted for Effectful conventions. Part of the atelier toolkit.

Usage

atelier-prelude exposes a module named Prelude. To make it the implicit prelude, hide base's Prelude with a mixin — GHC's automatic import Prelude then resolves to this one, with no NoImplicitPrelude and no per-module imports.

In package.yaml (hpack):

dependencies:
  - name: base
    mixin:
      - hiding (Prelude)
  - atelier-prelude

or in a .cabal file:

build-depends: base, atelier-prelude
mixins:        base hiding (Prelude)

Add -Wno-implicit-prelude to your ghc-options to silence the implicit-prelude warning.

What's different from relude

Lifted, IO-based operations from relude are intentionally not re-exported, so that effects are threaded explicitly through Effectful rather than performed in IO:

  • Relude.Lifted.* (system, environment, handle, terminal, file operations)
  • Relude.File
  • Relude.Print (console output)

Use the corresponding atelier-core effects instead — e.g. Atelier.Effects.Env, Atelier.Effects.File, Atelier.Effects.Console.

License

MIT — see LICENSE.