convertible-text: Typeclasses and instances for converting between types

[ bsd3, data, deprecated, failure ] [ Propose Tags ]

This is a port of John Goerzen's convertible package, intended to distinguish between conversions which are guaranteed to succeed and those which might fail. It uses the attempt package, which in turn uses the failure package, so that this package is fully compatible with the failure framework.

This package currently contains all of the typeclasses and instances for convertible. However, as these features are ported to the convertible package, this package will be left with only the instances for converting to and from text types (String, ByteString (lazy and strict) and Text (lazy and strict).

Be aware that conversions to and from bytestrings assume UTF-8 encoding. If a different encoding is desired, you can use a newtype wrapper and declare an instance of ConvertAttempt or ConvertSuccess on it.

The main module to import is Data.Convertible.Text.

Versions [RSS] [faq] 0.0.0, 0.2.0,,,,,, 0.3.0,,,,,,,,,,, 0.4.0,,
Dependencies attempt (>=0.2.1 && <0.3), base (==4.*), bytestring (>= && <0.10), containers (>= && <0.3), old-time (>= && <1.1), safe-failure (==0.4.*), template-haskell, text (==0.5.*), time (<=1.1.4) [details]
License LicenseRef-LGPL
Copyright Copyright (c) 2009-2009 John Goerzen
Author John Goerzen, Michael Snoyman
Maintainer Michael Snoyman <>
Revised Revision 1 made by HerbertValerioRiedel at 2019-02-12T22:19:19Z
Category Data, Failure
Home page
Uploaded by MichaelSnoyman at 2009-12-17T17:31:43Z
Distributions NixOS:
Executables runtests
Downloads 16407 total (87 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Hackage Matrix CI
Docs not available [build log]
All reported builds failed as of 2016-12-30 [all 6 reports]


  • Data
    • Convertible
      • Data.Convertible.Base
      • Data.Convertible.Instances
        • Data.Convertible.Instances.C
        • Data.Convertible.Instances.Map
        • Data.Convertible.Instances.Num
        • Data.Convertible.Instances.String
        • Data.Convertible.Instances.Text
        • Data.Convertible.Instances.Time
      • Data.Convertible.Text
      • Data.Convertible.Utils

Manual Flags


Build the executable to run unit tests


Skip building the library.

Automatic Flags

time > 1.1.3 has defined some more instances so omit them here


Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info


Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.

Maintainer's Corner

For package maintainers and hackage trustees