blaze-textual-native: Fast rendering of common datatypes

[ bsd3, deprecated, library, text ] [ Propose Tags ]

Deprecated in favor of blaze-textual

A library for efficiently rendering Haskell datatypes to bytestrings.

Note: if you use GHCi or Template Haskell, please see the README file for important details about building this package, and other packages that depend on it: https://github.com/mailrank/blaze-textual#readme

[Skip to Readme]

Modules

[Index]

Blaze
- Blaze.Text
  - Blaze.Text.Double
  - Blaze.Text.Int

Flags

Automatic Flags

Name	Description	Default
developer	operate in developer mode	Disabled
native	use slow native code for double conversion	Enabled

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

Downloads

blaze-textual-native-0.2.1.tar.gz [browse] (Cabal source package)
Package description (as included in the package)

Maintainer's Corner

Package maintainers

MichaelSnoyman

For package maintainers and hackage trustees

edit package information

Candidates

No Candidates

Versions [RSS]	0.2.1, 0.2.1.1
Dependencies	base (>=4 && <5), blaze-builder (>=0.2.1.4), bytestring, double-conversion (>=0.2.0.1), ghc-prim, integer (>=0.1 && <0.2), integer-gmp (>=0.2 && <0.4), old-locale, text (>=0.11.0.2), time, vector [details]
License	BSD-3-Clause
Copyright	Copyright 2011 MailRank, Inc.
Author	Bryan O'Sullivan <bos@mailrank.com>
Maintainer	Bryan O'Sullivan <bos@mailrank.com>
Category	Text
Home page	http://github.com/mailrank/blaze-textual
Bug tracker	http://github.com/mailrank/blaze-textual/issues
Source repo	head: git clone http://github.com/mailrank/blaze-textual head: hg clone http://bitbucket.org/bos/blaze-textual
Uploaded	by MichaelSnoyman at 2011-08-29T13:33:44Z
Distributions
Reverse Dependencies	3 direct, 458 indirect [details]
Downloads	1984 total (3 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 blaze-textual-native-0.2.1

[back to package description]

Welcome to blaze-textual

blaze-textual is a fast Haskell library for rendering common Haskell datatypes in text form using the blaze-builder library.

Important note for users of GHCi and Template Haskell

To achieve excellent performance for rendering floating point numbers, this package uses the double-conversion package.

Unfortunately, due to bugs in GHC, some uses of GHCi and Template Haskell can crash if this package is loaded.

5289: Can't use ghci with a library linked against libstdc++ (fixed in GHC 7.2.1).
5386: GHCi crashes with SIGFPE when using double-conversion package (not yet fixed at the time of writing)

If you are affected by these problems, you should expect the 5289 crash to look like this:

Loading package double-conversion-0.2.0.0 ... can't load .so/.DLL for: stdc++

The 5386 crash causes GHCi to die with a floating point exception (SIGFPE).

To work around these bugs, this package includes an alternative, slower, floating point conversion that is written in pure Haskell. Because it is 10 times slower than the double-conversion package, it is not the default.

To use it, reinstall this package by passing the native flag to cabal:

cabal install -fnative

Afterwards, you will also need to reinstall any downstream packages that depend on this one, e.g. the aeson JSON library:

cabal install aeson --reinstall

Join in!

We are happy to receive bug reports, fixes, documentation enhancements, and other improvements.

Please report bugs via the github issue tracker.

Master git repository:

git clone git://github.com/mailrank/blaze-textual.git

There's also a Mercurial mirror:

hg clone http://bitbucket.org/bos/blaze-textual

(You can create and contribute changes using either git or Mercurial.)

Authors

This library is written and maintained by Bryan O'Sullivan, bos@mailrank.com.