singletons-th: A framework for generating singleton types

[ bsd3, dependent-types, library ] [ Propose Tags ] [ Report a vulnerability ]

singletons-th defines Template Haskell functionality that allows promotion of term-level functions to type-level equivalents and singling functions to dependently typed equivalents. This library was originally presented in Dependently Typed Programming with Singletons, published at the Haskell Symposium, 2012. (https://richarde.dev/papers/2012/singletons/paper.pdf) See also the paper published at Haskell Symposium, 2014, which describes how promotion works in greater detail: https://richarde.dev/papers/2014/promotion/promotion.pdf.

singletons-th generates code that relies on bleeding-edge GHC language extensions. As such, singletons-th only supports the latest major version of GHC (currently GHC 9.10). For more information, consult the singletons README.

You may also be interested in the following related libraries:

  • The singletons library is a small, foundational library that defines basic singleton-related types and definitions.

  • The singletons-base library uses singletons-th to define promoted and singled functions from the base library, including the Prelude.


[Skip to Readme]

Modules

[Index] [Quick Jump]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 3.0, 3.1, 3.1.1, 3.2, 3.3, 3.4
Change log CHANGES.md
Dependencies base (>=4.20 && <4.21), containers (>=0.5), ghc-boot-th, mtl (>=2.2.1 && <2.4), singletons (>=3.0 && <3.1), syb (>=0.4), template-haskell (>=2.22 && <2.23), th-desugar (>=1.17 && <1.18), th-orphans (>=0.13.11 && <0.14), transformers (>=0.5.2) [details]
Tested with ghc ==9.10.1
License BSD-3-Clause
Author Richard Eisenberg <rae@cs.brynmawr.edu>, Jan Stolarek <jan.stolarek@p.lodz.pl>
Maintainer Ryan Scott <ryan.gl.scott@gmail.com>
Category Dependent Types
Home page http://www.github.com/goldfirere/singletons
Bug tracker https://github.com/goldfirere/singletons/issues
Source repo this: git clone https://github.com/goldfirere/singletons.git(tag v3.1.2)(singletons-th)
head: git clone https://github.com/goldfirere/singletons.git -b master(singletons-th)
Uploaded by ryanglscott at 2024-05-12T23:04:11Z
Distributions LTSHaskell:3.2, NixOS:3.2, Stackage:3.3
Reverse Dependencies 9 direct, 67 indirect [details]
Downloads 3852 total (135 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs uploaded by user
Build status unknown [no reports yet]

Readme for singletons-th-3.4

[back to package description]

singletons-th

Hackage

singletons-th defines Template Haskell functionality that allows promotion of term-level functions to type-level equivalents and singling functions to dependently typed equivalents. This library was originally presented in Dependently Typed Programming with Singletons, published at the Haskell Symposium, 2012. See also the paper published at Haskell Symposium, 2014, which describes how promotion works in greater detail.

singletons-th generates code that relies on bleeding-edge GHC language extensions. As such, singletons-th only supports the latest major version of GHC (currently GHC 9.10). For more information, consult the singletons README.

You may also be interested in the following related libraries:

  • The singletons library is a small, foundational library that defines basic singleton-related types and definitions.
  • The singletons-base library uses singletons-th to define promoted and singled functions from the base library, including the Prelude.