| CARVIEW |
vault: a persistent store for values of arbitrary types
A vault is a persistent store for values of arbitrary types. It's like having first-class access to the storage space behind IORefs. . The data structure is analogous to a bank vault, where you can access different bank boxes with different keys; hence the name. . Also provided is a locker type, representing a store for a single element.
[Skip to Readme]
Modules
[Index] [Quick Jump]
Flags
Automatic Flags
| Name | Description | Default |
|---|---|---|
| useghc | Use GHC-specific packages and extensions. | Enabled |
Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info
Downloads
- vault-0.3.1.6.tar.gz [browse] (Cabal source package)
- Package description (as included in the package)
Maintainer's Corner
For package maintainers and hackage trustees
Candidates
- No Candidates
| Versions [RSS] | 0.1.0.0, 0.2.0.0, 0.2.0.1, 0.2.0.3, 0.2.0.4, 0.3.0.0, 0.3.0.1, 0.3.0.2, 0.3.0.3, 0.3.0.4, 0.3.0.5, 0.3.0.6, 0.3.0.7, 0.3.1.0, 0.3.1.1, 0.3.1.2, 0.3.1.3, 0.3.1.4, 0.3.1.5, 0.3.1.6 |
|---|---|
| Change log | CHANGELOG.md |
| Dependencies | base (>=4.11 && <4.23), containers (>=0.5 && <0.9), hashable (>=1.1.2.5 && <1.6), unordered-containers (>=0.2.3.0 && <0.3) [details] |
| Tested with | ghc ==8.4.4 || ==8.6.5 || ==8.8.4 || ==8.10.7 || ==9.0.2 || ==9.2.8 || ==9.4.8 || ==9.6.7 || ==9.8.4 || ==9.10.2 || ==9.12.2 |
| License | BSD-3-Clause |
| Copyright | (c) Heinrich Apfelmus 2011-2026 |
| Author | Heinrich Apfelmus, Elliott Hird |
| Maintainer | Heinrich Apfelmus <apfelmus at quantentunnel de> |
| Uploaded | by HeinrichApfelmus at 2025-12-25T13:30:17Z |
| Category | Data |
| Home page | https://github.com/HeinrichApfelmus/vault |
| Source repo | head: git clone https://github.com/HeinrichApfelmus/vault.git |
| Distributions | Arch:0.3.1.5, Debian:0.3.1.4, Fedora:0.3.1.5, FreeBSD:0.3.0.4, LTSHaskell:0.3.1.6, NixOS:0.3.1.5, Stackage:0.3.1.6, openSUSE:0.3.1.5 |
| Reverse Dependencies | 65 direct, 3874 indirect [details] |
| Downloads | 138809 total (98 in the last 30 days) |
| Rating | 2.0 (votes: 1) [estimated by Bayesian average] |
| Your Rating |
|
| Status | Docs available [build log] Last success reported on 2025-12-25 [all 1 reports] |
Readme for vault-0.3.1.6
[back to package description]Vault is a tiny library that provides a single data structure called vault.
A vault is a type-safe, persistent storage for values of arbitrary types. Like IORef, I want to be able to store values of any type in it, but unlike IORef, I want the storage space to behave like a persistent, first-class data structure, as appropriate for a purely functional language.
It is analogous to a bank vault, where you can access different bank boxes with different keys; hence the name.
In other words, a vault is an abstract data type with the following basic signature
data Key a
data Vault
newKey :: IO (Key a)
empty :: Vault
lookup :: Key a -> Vault -> Maybe a
insert :: Key a -> a -> Vault -> Vault
delete :: Key a -> Vault -> Vault
A few common functions for finite maps, like adjust and union, are provided as well.
This library was created thanks to the feedback on my blog post Vault - a persistent store for values of arbitrary types.
Installation
The whole thing is available on hackage, so you just have to type
cabal update
cabal install vault
Feedback
Use the issue tracker or send an email to the maintainer.