Hackage :: [Package]

text-builder: Efficient strict text builder

[ builders, library, mit, text ] [ Propose Tags ] [ Report a vulnerability ]

  • Efficient monoidal builder of strict textual values

  • Text formatting library, an alternative to printf or the "formatting" Haskell library

[Skip to Readme]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.4, 0.4.1, 0.4.2, 0.4.3, 0.5, 0.5.1, 0.5.1.1, 0.5.2, 0.5.3, 0.5.3.1, 0.5.4, 0.5.4.1, 0.5.4.2, 0.5.4.3, 0.6, 0.6.1, 0.6.1.1, 0.6.1.2, 0.6.2, 0.6.3, 0.6.4, 0.6.5, 0.6.5.1, 0.6.6, 0.6.6.1, 0.6.6.2, 0.6.6.3, 0.6.6.4, 0.6.6.5, 0.6.6.6, 0.6.7, 0.6.7.1, 0.6.7.2, 0.6.7.3, 0.6.8, 0.6.9, 0.6.10
Change log CHANGELOG.md
Dependencies base (>=4.11 && <5), bytestring (>=0.10 && <0.13), text (>=1.2 && <3), text-builder-dev (>=0.3.10 && <0.4) [details]
License MIT
Copyright (c) 2017, Nikita Volkov
Author Nikita Volkov <nikita.y.volkov@mail.ru>
Maintainer Nikita Volkov <nikita.y.volkov@mail.ru>
Category Text, Builders
Home page https://github.com/nikita-volkov/text-builder
Bug tracker https://github.com/nikita-volkov/text-builder/issues
Source repo head: git clone https://github.com/nikita-volkov/text-builder
Uploaded by NikitaVolkov at 2025-04-02T17:56:23Z
Distributions Arch:0.6.7, Fedora:0.6.7, LTSHaskell:0.6.7.3, NixOS:0.6.7.2, Stackage:0.6.9
Reverse Dependencies 18 direct, 70 indirect [details]
Downloads 23417 total (60 in the last 30 days)
Rating 2.0 (votes: 1) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2025-04-02 [all 1 reports]

Readme for text-builder-0.6.10

[back to package description]

Summary

  • Efficient monoidal builder of strict textual values
  • Text formatting library, an alternative to printf or the "formatting" Haskell library

Performance

The benchmarks show that it's about 2 times faster than the lazy text builder supplied with the "text" package. In the years of existence of this package the collected user feedback proves that it's faster in fact.

benchmarking Left-biased mappend/1kB/TextBuilder
time                 4.567 μs   (4.552 μs .. 4.584 μs)
                     1.000 R²   (1.000 R² .. 1.000 R²)
mean                 4.570 μs   (4.551 μs .. 4.592 μs)
std dev              64.42 ns   (49.19 ns .. 81.46 ns)
variance introduced by outliers: 12% (moderately inflated)

benchmarking Left-biased mappend/1kB/Data.Text.Lazy.Builder
time                 8.855 μs   (8.805 μs .. 8.901 μs)
                     1.000 R²   (1.000 R² .. 1.000 R²)
mean                 8.867 μs   (8.821 μs .. 8.908 μs)
std dev              137.9 ns   (114.6 ns .. 160.4 ns)
variance introduced by outliers: 13% (moderately inflated)

benchmarking Left-biased mappend/1MB/TextBuilder
time                 9.546 ms   (9.415 ms .. 9.773 ms)
                     0.998 R²   (0.995 R² .. 1.000 R²)
mean                 9.407 ms   (9.351 ms .. 9.493 ms)
std dev              184.7 μs   (92.85 μs .. 333.3 μs)

benchmarking Left-biased mappend/1MB/Data.Text.Lazy.Builder
time                 17.04 ms   (16.85 ms .. 17.21 ms)
                     0.999 R²   (0.999 R² .. 1.000 R²)
mean                 17.09 ms   (16.99 ms .. 17.19 ms)
std dev              228.4 μs   (181.4 μs .. 285.3 μs)

benchmarking Right-biased mappend/1kB/TextBuilder
time                 4.481 μs   (4.467 μs .. 4.499 μs)
                     1.000 R²   (1.000 R² .. 1.000 R²)
mean                 4.486 μs   (4.470 μs .. 4.508 μs)
std dev              61.86 ns   (44.45 ns .. 87.66 ns)
variance introduced by outliers: 11% (moderately inflated)

benchmarking Right-biased mappend/1kB/Data.Text.Lazy.Builder
time                 8.751 μs   (8.701 μs .. 8.798 μs)
                     1.000 R²   (1.000 R² .. 1.000 R²)
mean                 8.751 μs   (8.697 μs .. 8.805 μs)
std dev              159.2 ns   (134.4 ns .. 205.0 ns)
variance introduced by outliers: 17% (moderately inflated)

benchmarking Right-biased mappend/1MB/TextBuilder
time                 7.057 ms   (7.035 ms .. 7.086 ms)
                     1.000 R²   (1.000 R² .. 1.000 R²)
mean                 7.071 ms   (7.050 ms .. 7.093 ms)
std dev              57.85 μs   (43.37 μs .. 83.06 μs)

benchmarking Right-biased mappend/1MB/Data.Text.Lazy.Builder
time                 15.10 ms   (14.96 ms .. 15.30 ms)
                     0.999 R²   (0.999 R² .. 1.000 R²)
mean                 15.15 ms   (15.04 ms .. 15.25 ms)
std dev              273.0 μs   (208.6 μs .. 392.6 μs)

benchmarking mconcat/1kB/TextBuilder
time                 4.778 μs   (4.756 μs .. 4.800 μs)
                     1.000 R²   (1.000 R² .. 1.000 R²)
mean                 4.784 μs   (4.770 μs .. 4.802 μs)
std dev              58.27 ns   (48.36 ns .. 72.11 ns)

benchmarking mconcat/1kB/Data.Text.Lazy.Builder
time                 8.046 μs   (8.009 μs .. 8.087 μs)
                     1.000 R²   (1.000 R² .. 1.000 R²)
mean                 8.053 μs   (8.021 μs .. 8.084 μs)
std dev              102.3 ns   (81.50 ns .. 130.5 ns)

benchmarking mconcat/1MB/TextBuilder
time                 8.902 ms   (8.856 ms .. 8.931 ms)
                     1.000 R²   (1.000 R² .. 1.000 R²)
mean                 8.892 ms   (8.868 ms .. 8.926 ms)
std dev              81.44 μs   (62.67 μs .. 119.7 μs)

benchmarking mconcat/1MB/Data.Text.Lazy.Builder
time                 10.56 ms   (10.39 ms .. 10.68 ms)
                     0.999 R²   (0.998 R² .. 0.999 R²)
mean                 10.50 ms   (10.42 ms .. 10.60 ms)
std dev              260.2 μs   (191.2 μs .. 375.9 μs)

How it works

It constructs text in two phases. In the first one it estimates the size of the byte array and in the second one it allocates it once and populates it in one go.

What is text-builder-dev?

It is a lower-level library which this one wraps and provides a stable interface for. It serves as a testing ground for new features and design exploration.