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, 1, 1.0.0.1, 1.0.0.2, 1.0.0.3, 1.0.0.4
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.3, LTSHaskell:1.0.0.4, NixOS:1.0.0.4, Stackage:1.0.0.4
Reverse Dependencies 22 direct, 74 indirect [details]
Downloads 24132 total (53 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.