cached-json-file: Locally cache a json file obtained by http

[ bsd3, library, network ] [ Propose Tags ]

A small library for caching a slow-changing remote json file in a specified directory (under "~/.cache/"). When the json is requested and the cache file is still fresh enough it is read directly from the local cache, otherwise the cached file is refreshed first.

[Skip to Readme]


[Index] [Quick Jump]


Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees


Versions [RSS] 0.1.0, 0.1.1
Change log
Dependencies aeson, base (<5), bytestring, directory, filepath, http-query, time, xdg-basedir [details]
License BSD-3-Clause
Copyright 2021 Jens Petersen <>
Author Jens Petersen <>
Maintainer Jens Petersen <>
Category Network
Home page
Bug tracker
Source repo head: git clone
Uploaded by JensPetersen at 2021-12-27T10:16:10Z
Distributions Fedora:0.1.1, LTSHaskell:0.1.1, NixOS:0.1.1, Stackage:0.1.1
Reverse Dependencies 1 direct, 0 indirect [details]
Downloads 606 total (16 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2021-12-27 [all 1 reports]

Readme for cached-json-file-0.1.1

[back to package description]


A Haskell library providing a cached json file.

Useful for frequently used programs that use some remote json data which changes rather slowly (like in hours, days, weeks or months), where it is not critical to have always the latest data locally immediately.


getCachedJSON dir file url minutes caches the json obtained from url in ~/.cache/dir/file for minutes.


import System.Cached.JSON

getSnapshots :: IO Object
getSnapshots =
  getCachedJSON "stackage-snapshots" "snapshots.json" "" 180

main = getSnapshots >>= print

Each time you run this program within 3 hours the data will be read from the local cache file ~/.cache/stackage-snapshots/snapshots.json rather than re-downloading it each time, which helps to speed up the program and avoid unnecessary web queries.

There is also getCachedJSONQuery prog jsonfile webquery minutes which uses webquery :: (FromJSON a, ToJSON a) => IO a to download the json data.

The shortest cache time is 1 minute.