auto-update

Efficiently run periodic, on-demand actions

https://github.com/yesodweb/wai

Version on this page:0.2.5
LTS Haskell 23.24:0.2.6
Stackage Nightly 2025-05-28:0.2.6
Latest on Hackage:0.2.6

See all snapshots auto-update appears in

MIT licensed by Michael Snoyman
Maintained by [email protected]
This version can be pinned in stack with:auto-update-0.2.5@sha256:475203ef9fc17093b74cc8a7d52607a1ad47fffb4ae1fa720dcbcb5777eb3340,1676

Module documentation for 0.2.5

Depends on 2 packages(full list with versions):
base, stm

auto-update

A common problem is the desire to have an action run at a scheduled interval, but only if it is needed. For example, instead of having every web request result in a new getCurrentTime call, we’d like to have a single worker thread run every second, updating an IORef. However, if the request frequency is less than once per second, this is a pessimization, and worse, kills idle GC.

This library allows you to define actions which will either be performed by a dedicated thread or, in times of low volume, will be executed by the calling thread.

For original use case, see yesod-scaffold issue #15.

Changes

ChangeLog for auto-update

0.2.5

  • Thread less autoupdate #1018

0.2.4

  • Simple refactoring.

0.2.3

  • #996: Refactored the Control.Debounce logic to not leak threads.
  • #996: Added extra DebounceEdge options for different types of debouncing.
    • LeadingMute: Action on first trigger, and ignore any triggers during cooldown
    • TrailingDelay: First trigger starts cooldown, and triggers during cooldown extend the cooldown. Action when cooldown expires.

0.2.2

  • NewAPI: updateThreadName, reaperThreadName, debounceThreadName: Names can be given via this field to threads for GHC.Conc.Sync.listThreads.

0.2.1

  • Labeling threads.

0.2.0

  • Creating Reaper.Internal to export Reaper constructor.
  • Hiding Reaper constructor.
  • #985: Add reaperModify to the Reaper API, allowing workload modification outside of the main reaperAction loop.

0.1.6

  • #756: Add control of activation on leading vs. trailing edges for Control.Debounce

0.1.5

  • #752: Using the Strict and StrictData language extensions for GHC >8.

0.1.4.1

  • #693: Improve documentation for reaperAction function.
  • #732: Fixed memory leak in reaperAdd function.

0.1.4

  • Provide updateActionModify API in AutoUpdate #547

0.1.3.1

  • Doc improvements

0.1.3

  • Adding a new AIP - reaperKill

0.1.2

  • Added Control.Debounce