text-conversions

Safe conversions between textual types

https://github.com/cjdev/text-conversions

LTS Haskell 23.19:0.3.1.1
Stackage Nightly 2025-05-01:0.3.1.1
Latest on Hackage:0.3.1.1

See all snapshots text-conversions appears in

ISC licensed by Alexis King
Maintained by Alexis King
This version can be pinned in stack with:text-conversions-0.3.1.1@sha256:35dc3ee494275509a3a771d5d27fc02d4af34478a40126cba87cdc6f007d551e,1433

Module documentation for 0.3.1.1

Used by 4 packages in nightly-2025-05-01(full list with versions):
doctemplates, pandoc, string-interpolate, webgear-server

text-conversions Build Status Hackage

This is a small library to ease the pain when converting between the many different string types in Haskell. Unlike some other libraries that attempt to solve the same problem, text-conversions is:

  • Safe. This library treats binary data (aka ByteString) like binary data, and it does not assume a particular encoding, nor does it ever throw exceptions when failing to decode. It does, however, provide failable conversions between binary data and textual data.

  • Extensible. It’s easy to add or derive your own instances of the typeclasses to use your own types through the same interface.

Here’s an example of using text-conversions to convert between textual types:

> convertText ("hello" :: String) :: Text
"hello"

And here’s an example of converting from UTF-8 encoded binary data to a textual format:

> decodeConvertText (UTF8 ("hello" :: ByteString)) :: Maybe Text
Just "hello"
> decodeConvertText (UTF8 ("\xc3\x28" :: ByteString)) :: Maybe Text
Nothing

For more details, see the documentation on Hackage.

Changes

Changelog

0.3.1.1 (May 2nd, 2022)

  • Eliminated dependency on the errors package.

0.3.1 (September 29th, 2020)

  • Added support for base16-bytestring-1.0.

0.3.0 (June 9, 2016)

New Features

  • The Base16 and Base64 newtypes are now provided for managing safe conversions between binary data and Base16 and Base64 textual encodings of that data.

0.2.0 (May 25, 2016)

Breaking Changes

  • The ConvertText typeclass has been split into two simpler functions, convertText and decodeConvertText. This means the vision of a unified function for converting between any two textual datatypes is no longer implemented, but the original attempt had too many problems to really be worth the cost. Specifically, instances like FromText (Maybe Foo) would cause problems due to the overlapping instances, which have now been removed.

0.1.0 (May 24, 2016)

  • Initial release