Foundational effects and utilities for effect-based applications, built on Effectful. Part of the atelier toolkit.
Overview
atelier-core provides a set of composable Effectful effects and supporting
types for building structured, observable applications.
It also wraps a number of IO-based primitives (environment, clock, file
system, console, POSIX) as effects so they can be interpreted and tested
explicitly: Atelier.Effects.Env, Atelier.Effects.Clock,
Atelier.Effects.FileSystem, Atelier.Effects.Console,
Atelier.Effects.Posix.*, and more.
All notable changes to atelier-core will be documented in this file.
The format is based on Keep a Changelog,
and this project adheres to the PVP.
[Unreleased]
[1.1.0.0] - 2026-11-18
Added
Atelier.Time: Added Functor instances for AsRawUnit and AsJsonMicrosecond.
Atelier.FileSystem.Path: paths that are distinguished at the type level on
whether they are absolute or relative, as well as operations around these
paths lifted from System.FilePath and System.Directory.
Atelier.FileSystem.File: file operations on Atelier.FileSystem.Path
paths.
Atelier.FileSystem.Directory: directory operations on
Atelier.FileSystem.Path paths.
Atelier.FileSystem.SymbolicLink: symbolic link operations on
Atelier.FileSystem.Path paths.
Atelier.FileSystem.Permissions: permissions operations on
Atelier.FileSystem.Path paths.
Atelier.Effects.Exit now re-exports ExitCode and its constructors.
Atelier.Effects.Handles.SeekMode: reexport from System.IO.
Atelier.Effects.FileWatcher.Event.collapse.
Changed
Atelier.Effects.File: renamed to Atelier.Effects.Handles.
Atelier.Effects.FileWatcher.Event: Removed and Added events merged
together is now considered a Modified event. This catches atomic writes by
editors that support writing file in that way.
Deprecated
Atelier.Effects.FileSystem: replaced by Effectful.FileSystem and the
Atelier.Effects.FileSystem.* family of modules.
[1.0.0.0] - 2026-10-29
Added
Atelier.Effects.FSNotify: System.FSNotify lifted to Eff.
Atelier.Types.JSON.Renamed: used to mark properties that have been renamed.
Attempting to JSON parse a property that is Renamed "from" "to" will
produce an error message denoting that the property "from" has been renamed
to "to".
Atelier.Effects.Arguments.Switch: similar to Options.Applicative.switch
from optparse-applicative, but includes an inverse flag in the form of
--no-<long-name> for the flag.
Changed
Atelier.Effects.Arguments: converted to a static effect.
Atelier.Effects.Arguments.runArgumentsIO renamed to
Atelier.Effects.Arguments.runIO.
Atelier.Types.Base64 moved to Atelier.Types.JSON.Base64.
Atelier.Types.WithDefaults moved to Atelier.Types.JSON.WithDefaults.
Atelier.Effects.Cache: renamed members to make more suited for qualified
use.
Atelier.Effects.Chan: renamed members to make more suited for qualified
use.
Atelier.Effects.Clock: renamed members to make more suited for qualified
use.
Atelier.Effects.Conc: renamed members to make more suited for qualified
use.
Atelier.Effects.Console: renamed members to make more suited for qualified
use.
Atelier.Effects.Debounce: renamed members to make more suited for qualified
use.
Atelier.Effects.Delay: renamed members to make more suited for qualified
use.
Atelier.Effects.Env: renamed members to make more suited for qualified use.
Atelier.Effects.Exit: renamed members to make more suited for qualified
use.
Atelier.Effects.File: renamed members to make more suited for qualified
use.
Atelier.Effects.FileSystem: renamed members to make more suited for
qualified use.
Atelier.Effects.FileWatcher: renamed members to make more suited for
qualified use.
Atelier.Effects.Log: renamed members to make more suited for qualified use.
Atelier.Effects.Process: converted to static effect, and renamed members to
make more suited for qualified use.
Atelier.Effects.Tally: renamed members to make more suited for qualified
use.
Atelier.Effects.Tally.count (previously
Atelier.Effects.Tally.withTallyCheck) now no longer takes a classifier. The
classifier function was always just ran and passed straight through to the
continuation, so now the continuation just receives the count as-is.
Atelier.Effects.Timeout: converted to static effect, and renamed members to
make more suited for qualified use.
Atelier.Effects.UUID: renamed to Atelier.Effects.GenUUID, and renamed
members to make more suited for qualified use.
Atelier.Effects.Cache.Singleflight: renamed members to make more suited for
qualified use.
Atelier.Effects.Posix.Daemons: converted to static effect, and renamed members to
make more suited for qualified use.
Atelier.Effects.PubSub.Pub: runNoOp renamed to noOp.
Removed
Deprecated functions in Atelier.Effects.Input.
Deprecated modules Atelier.Effects.Publishing,
Atelier.Effects.Publishing.Sub and Atelier.Effects.Publishing.Pub.
[0.8.1.0] - 2026-10-23
Added
Atelier.Effects.Console.runConsoleOut and Atelier.Effects.Console.Output:
to run Console effects against specific well-known handlers, like stdout
and stderr.
[0.8.0.0] - 2026-10-20
Added
Atelier.Types.JSON.StringLiteral: helper newtype for parsing and encoding
values as exact string literals, regardless of their Show and Read
instances.
Atelier.Types.JSON.ReadShow: a copy of Atelier.Types.JsonReadShow, but
with a better name.
Atelier.Types.JSON.QuietSnake: a copy of Atelier.Types.QuietSnake, but
with a better name.
Atelier.Effects.Input.withEff: a copy of
Atelier.Effects.Input.runInputEff, but with a better name.
Atelier.Effects.Input.withConst: a copy of
Atelier.Effects.Input.runInputConst, but with a better name.
Atelier.Effects.PubSub: a copy of
Atelier.Effects.Publishing, but with a better name.
Atelier.Effects.PubSub.Pub: a copy of
Atelier.Effects.Publishing.Pub, but with a better name.
Atelier.Effects.PubSub.Sub: a copy of
Atelier.Effects.Publishing.Sub, but with a better name.
Atelier.Effects.Reader.project: a simple way to expose parts of another
Reader a as another Reader effect.
Atelier.Effects.Input.map: a function to transform an existing effect.
Atelier.Effects.Log.Config: gets a ToJSON instance.
Atelier.Effects.Log.Severity: gets a ToJSON instance.
Changed
Atelier.Effects.Log.Config: its FromJSON instance now fails gracefully
using the Default instance.
Deprecated
Atelier.Types.JsonReadShow: superseded by Atelier.Types.JSON.ReadShow.
Atelier.Types.QuietSnake: superseded by Atelier.Types.JSON.QuietSnake.
Atelier.Effects.Input.runInputEff: superseded by Atelier.Effects.Input.withEff.
Atelier.Effects.Input.runInputConst: superseded by Atelier.Effects.Input.withConst.
Atelier.Effects.Publishing: superseded by Atelier.Effects.PubSub.
Atelier.Effects.Publishing.runPubSub: superseded by Atelier.Effects.PubSub.run.
Atelier.Effects.Publishing.Pub: superseded by Atelier.Effects.PubSub.Pub.
Atelier.Effects.Publishing.Sub: superseded by Atelier.Effects.PubSub.Sub.
Atelier.Signal: For properly handling termination of an application.
[0.7.1.0] - 2026-09-17
Added
Proper support for GHC 9.14.
[0.7.0.0] - 2026-09-16
Removed
Support for GHC 9.14. A faulty CI setup incorrectly stated that we were
building and testing successfully on GHC 9.14.
[0.6.1.0] - 2026-09-15
Added
Atelier.Effects.FileSystem.Glob: lifted functions from the Glob library.
Support for GHC 9.14.
[0.6.0.0] - 2026-09-10
Changed
Require effectful >=2.7 && <2.8.
Require effectful-core >=2.7 && <2.8.
Require effectful-plugin >=2.2 && <2.3.
[0.5.0.0] - 2026-09-09
Changed
Atelier.Time: Remove orphan FromJSON and ToJSON instances, and instead
introduce AsRawUnit and AsJsonMicrosecondnewtypes for FromJSON and
ToJSON instance deriving. This fixes the issue where the time units’
FromJSON and ToJSON instances did not match, meaning
decode (encode (10 :: Hour)) == Nothing held true. Now you have to be more
explicit about how the units will be represented in JSON.
[0.4.0.1] - 2026-08-14
Removed
Dependency on hs-opentemeletry-api for the test suite.
[0.4.0.0] - 2026-08-14
Added
Atelier.Effects.Env: lookupEnv picks out a single environment variable.
Changed
Major version bump for the following dependencies’ upper version bounds:
aeson
http-api-data
time
Removed
Move all metrics and observability tooling to atelier-monitoring:
Atelier.Component: moved to atelier-monitoring.
Atelier.Effects.Conc.Traced: moved to atelier-monitoring.
Atelier.Effects.Monitoring.Metrics: moved to atelier-monitoring.
Atelier.Effects.Monitoring.Metrics.Server: moved to atelier-monitoring.
Atelier.Effects.Monitoring.Metrics.Registry: moved to atelier-monitoring.
Atelier.Effects.Cache.Singleflight: removed tracing capability. Old version
with tracing capability is available in atelier-monitoring as
Atelier.Effects.Cache.Singleflight.Traced.
Atelier.Effects.Publishing#runPubSub: moved to atelier-monitoring in
Atelier.Effects.Publishing.Traced.
Atelier.Effects.Publshing#runPubSub_: renamed to runPubSub.
[0.3.0.0] - 2026-08-06
Added
Atelier.Effects.Process: getExecutablePath returns the absolute path of
the currently running executable, for re-invoking the program as a
subprocess.
Atelier.Effects.Publishing.Pub:map and mapM allows mapping over
published effects, producing a new Pub effect with the transformed values.
Changed
Moved Pub and Sub out of Atelier.Effects.Publishing to separate modules,
Atelier.Effects.Publishing.Pub and Atelier.Effects.Publishing.Sub
respectively.
[0.2.0.0] - 2026-06-26
Added
Atelier.Effects.File now re-exports IOMode (..).
Atelier.Effects.Process: withProcessGroup runs a process in its own
process group and guarantees the whole group is torn down when the body
returns or throws; terminateProcessGroup aborts a running group from
another thread (for children that trap SIGINT, where interrupting the
group is not enough).
New module Atelier.Effects.Process.Internal, exposing the RunningProcess
constructor for tests that fabricate a handle. Production code should not
import it.
Changed
Breaking:Atelier.Effects.Process.RunningProcess is now a distinct
newtype wrapping System.Process.Typed.Process (previously a type
synonym). getStdin/getStdout/getStderr operate on the new type.
Removed
Breaking:Atelier.Effects.Process no longer exports setCreateGroup,
startProcess, or stopProcess. Process lifecycle is now managed through
withProcessGroup.
[0.1.0.0] - 2026-06-05
Added
Initial release: foundational Effectful-based effects and utilities,
extracted from the atelier toolkit.