extra: Extra functions I use.

[ bsd3, development, library ] [ Propose Tags ]

A library of extra functions for the standard Haskell libraries. Most functions are simple additions, filling out missing functionality. A few functions are available in later versions of GHC, but this package makes them available back to GHC 7.2.

The module Extra documents all functions provided by this library. Modules such as Data.List.Extra provide extra functions over Data.List and also reexport Data.List. Users are recommended to replace Data.List imports with Data.List.Extra if they need the extra functionality.

[Skip to Readme]

Versions [faq]	0.1, 0.2, 0.3, 0.3.1, 0.3.2, 0.4, 0.5, 0.5.1, 0.6, 0.7, 0.8, 1.0, 1.0.1, 1.1, 1.2, 1.3, 1.3.1, 1.4, 1.4.1, 1.4.2, 1.4.3, 1.4.4, 1.4.5, 1.4.6, 1.4.7, 1.4.8, 1.4.9, 1.4.10, 1.4.11, 1.4.12, 1.5, 1.5.1, 1.5.2, 1.5.3, 1.6, 1.6.1, 1.6.2, 1.6.3, 1.6.4, 1.6.5, 1.6.6, 1.6.7, 1.6.8, 1.6.9, 1.6.11, 1.6.12, 1.6.13, 1.6.14, 1.6.15, 1.6.16, 1.6.17, 1.6.18, 1.6.19, 1.6.20, 1.6.21, 1.7, 1.7.1, 1.7.2, 1.7.3, 1.7.4, 1.7.5, 1.7.6, 1.7.7, 1.7.8, 1.7.9
Change log	CHANGES.txt
Dependencies	base (>=4.9 && <5), clock (>=0.7), directory, filepath, process, time, unix [details]
License	BSD-3-Clause
Copyright	Neil Mitchell 2014-2020
Author	Neil Mitchell <ndmitchell@gmail.com>
Maintainer	Neil Mitchell <ndmitchell@gmail.com>
Category	Development
Home page	https://github.com/ndmitchell/extra#readme
Bug tracker	https://github.com/ndmitchell/extra/issues
Source repo	head: git clone https://github.com/ndmitchell/extra.git
Uploaded	by NeilMitchell at 2020-12-19T16:17:17Z
Distributions	Arch:1.7.9, Debian:1.6.9, Fedora:1.7.3, FreeBSD:1.4.1, LTSHaskell:1.6.17, NixOS:1.7.9, Stackage:1.6.17, openSUSE:1.7.7
Downloads	135365 total (1432 in the last 30 days)
Rating	2.25 (votes: 2) [estimated by Bayesian average]
Your Rating	λ λ λ
Status	Docs available [build log] Last success reported on 2020-12-19 [all 1 reports]

Modules

[Index] [Quick Jump]

Control
- Concurrent
  - Control.Concurrent.Extra
- Exception
  - Control.Exception.Extra
- Monad
  - Control.Monad.Extra
Data
- Either
  - Data.Either.Extra
- Foldable
  - Data.Foldable.Extra
- IORef
  - Data.IORef.Extra
- List
  - Data.List.Extra
  - NonEmpty
    - Data.List.NonEmpty.Extra
- Tuple
  - Data.Tuple.Extra
- Typeable
  - Data.Typeable.Extra
- Version
  - Data.Version.Extra
Extra
Numeric
- Numeric.Extra
System
- Directory
  - System.Directory.Extra
- Environment
  - System.Environment.Extra
- IO
  - System.IO.Extra
- Info
  - System.Info.Extra
- Process
  - System.Process.Extra
- Time
  - System.Time.Extra
Text
- Read
  - Text.Read.Extra

Downloads

extra-1.7.9.tar.gz [browse] (Cabal source package)
Package description (as included in the package)

Maintainer's Corner

For package maintainers and hackage trustees

edit package information

Readme for extra-1.7.9

[back to package description]

Extra

Control.Monad.Extra.concatMapM provides a monadic version of concatMap, in the same way that mapM is a monadic version of map.
Data.Tuple.Extra.fst3 provides a function to get the first element of a triple.
Control.Exception.Extra.retry provides a function that retries an IO action a number of times.
Data.Either.Extra.fromLeft is a function available in GHC 8.0 and above. On GHC 8.0 and above this package reexports the version from Data.Either while on GHC 7.10 and below it defines an equivalent version.

The module Extra documents all functions provided by this library. Modules such as Data.List.Extra provide extra functions over Data.List and also reexport Data.List. Users are recommended to replace Data.List imports with Data.List.Extra if they need the extra functionality.

Which functions?

When producing a library of extra functions I have been guided by a few principles. I encourage others with small useful utility functions contribute them here, perhaps as a temporary stop before proposing they join the standard libraries.

I have been using most of these functions in my packages - they have proved useful enough to be worth copying/pasting into each project.
The functions follow the spirit of the original Prelude/base libraries. I am happy to provide partial functions (e.g. fromRight), and functions which are specialisations of more generic functions (whenJust).
Most of the functions have trivial implementations. If a beginner couldn't write the function, it probably doesn't belong here.
I have defined only a few new data types or type aliases. It's a package for defining new utilities on existing types, not new types or concepts.

Base versions

A mapping between base versions and GHC compiler versions can be found here.

Contributing

My general contribution preferences are available here. In addition, this repo contains some generated code which is checked in, namely src/Extra.hs and test/TestGen.hs. You can generate those files by either running runhaskell Generate.hs or ghci (which uses the .ghci file) and typing :generate. All PR's should contain regenerated versions of those files.