text-ascii: ASCII string and character processing.
A total-by-default, tested and documented library for working with ASCII text. Low on dependencies, high on usability.
[Skip to Readme]
Modules
[Index] [Quick Jump]
Downloads
- text-ascii-1.2.1.tar.gz [browse] (Cabal source package)
- Package description (as included in the package)
Maintainer's Corner
For package maintainers and hackage trustees
Candidates
| Versions [RSS] | 1.0.0, 1.0.1, 1.1, 1.2.1 |
|---|---|
| Change log | CHANGELOG.md |
| Dependencies | base (>=4.17 && <5), bytestring (>=0.12 && <0.13), case-insensitive (>=1.2 && <1.3), deepseq (>=1.4.8 && <1.6.0), hashable (>=1.4 && <1.5), megaparsec (>=9.6 && <9.7), monoid-subclasses (>=1.2 && <1.3), optics-core (>=0.4 && <0.5), optics-extra (>=0.4 && <0.5), template-haskell (>=2.19 && <3.0), text (>=2.1 && <2.2) [details] |
| Tested with | ghc ==9.4.8 || ==9.6.4 || ==9.8.1 |
| License | Apache-2.0 |
| Copyright | (C) Koz Ross 2021-3 |
| Author | Koz Ross |
| Maintainer | koz.ross@retro-freedom.nz |
| Category | Text |
| Home page | https://github.com/haskell-text/text-ascii |
| Bug tracker | https://github.com/haskell-text/text-ascii/issues |
| Uploaded | by koz_ross at 2024-01-21T20:44:34Z |
| Distributions | |
| Downloads | 478 total (7 in the last 30 days) |
| Rating | 2.25 (votes: 2) [estimated by Bayesian average] |
| Your Rating | |
| Status | Docs uploaded by user Build status unknown [no reports yet] |
Readme for text-ascii-1.2.1
[back to package description]text-ascii 
What is this thing?
A library for handling ASCII text.
What are the goals of this project?
Totality by default
Partial functions (and type classes which provide them) will not be included: everything is total. When we include anything unsafe, it will be explicitly firewalled into its own module, behind a newtype.
No boolean blindness
Boolean blindness is not
a good thing, for all the reasons listed in the link. Whenever possible, we'll
try and give more useful information than a Bool.
Compatibility with the text API
We want match the API of the text package exactly. If you know how to use text,
you'll know how to use this package too. Exceptions are made for places where
text is either partial or boolean-blind.
Discoverability, documentation and user-friendliness
In addition to documenting everything with Haddocks, we have over 250 doctests,
which provide executable examples of how the API can be used, and how it will
behave. We aim to clarify every corner case left by the documentation of
text, and care strongly about making the API easy to follow, learn and
understand.
Correctness
We currently use doctests, but plan to add support for more testing. No such thing as too much!
Low dependencies
As far as possible, we aim to depend on GHC boot packages only. When we introduce more dependencies, we do it only when we have to. This way, we ensure this package builds quickly and doesn't 'lag' more than necessary due to GHC version changes.
What's with all the cat stuff?
What does this run on?
We support the latest three releases of GHC. Currently, these are:
- 9.4
- 9.6
- 9.8
We check on the following platforms:
- Windows
- Linux
- MacOS
What can I do with this?
The project is licensed Apache 2.0 (SPDX code
Apache-2.0). For more details,
please see the LICENSE.md file.