hex-text

ByteString-Text hexidecimal conversions

https://github.com/typeclasses/hex-text

Version on this page:0.1.0.4
LTS Haskell 22.17:0.1.0.9@rev:1
Stackage Nightly 2024-04-18:0.1.0.9@rev:1
Latest on Hackage:0.1.0.9@rev:1

See all snapshots hex-text appears in

MIT licensed by Chris Martin
Maintained by Chris Martin, Julie Moronuki
This version can be pinned in stack with:hex-text-0.1.0.4@sha256:0ea54d08f85324498b2db3480f05efc17eb03177c564fce81dadef53752db2c5,1277

Module documentation for 0.1.0.4

hex-text

hex-text is a small library for converting between ByteStrings and their representations as hexidecimal numbers encoded as Text.

Motivation

When using Stripe for payments, Stripe sends a signature as a hexidecimal Text value. The cryptonite package can be used to verify the signature, but it requires ByteString values, not Text.

Example usage

A ByteString is a list of bytes. A byte is a number between 0 and 255, represented by the Word8 type. In a fixed-width hexidecimal representation, the lowest byte 0 is represented by the hex string 00, and the greatest byte 255 is represented by the hex string ff. So, for example, the ByteString consisting of bytes [ 1, 2, 3, 253, 254, 255 ] is represented as 010203fdfeff.

λ> import Text.Hex (encodeHex)
λ> import Data.ByteString (pack)

λ> (encodeHex . pack) [1, 2, 3, 253, 254, 255]
"010203fdfeff"

Changes

Initial release: version 0.1.0.0, published in 2018.

Version 0.1.0.2, published October 2020:
★ Adds tighter version bounds
★ Supports base16-bytestring version 1.0, drops support for earlier versions

Version 0.1.0.4, published March 2021:
★ Adds support for GHC 9.0
★ Removes the test suite's dependency on doctest