Difference between revisions of "Applications and libraries"

From HaskellWiki
Jump to navigation Jump to search
m (Reverted edits by Pinadd (Talk); changed back to last version by Henk-Jan van Tuyl)
m (→‎Haskell 2010 libraries: archived dead link)
 
(23 intermediate revisions by 7 users not shown)
Line 6: Line 6:
   
 
=== Haskell Prelude ===
 
=== Haskell Prelude ===
The most important Haskell library is called the [http://haskell.org/ghc/docs/latest/html/libraries/base/Prelude.html Prelude]. It is implicitly imported by default, and includes the most commonly used functions. Make sure you know what they do and how to use them effectively.
+
The most important Haskell library is called the [https://hackage.haskell.org/package/base-4.12.0.0/docs/Prelude.html Prelude]. It is implicitly imported by default, and includes the most commonly used functions. Make sure you know what they do and how to use them effectively.
   
=== The Haskell 2010 libraries ===
+
=== Haskell 2010 libraries ===
The Haskell 2010 [[Language and library specification]] defines a set of [http://www.haskell.org/onlinereport/haskell2010/haskellpa2.html libraries] with basic functionality which all Haskell implementations should support, including the Prelude. Changes to these libraries are handled by the [http://hackage.haskell.org/trac/haskell-prime/ Haskell'] process.
+
The Haskell 2010 [[Language and library specification]] defines a set of [http://www.haskell.org/onlinereport/haskell2010/haskellpa2.html libraries] with basic functionality which all Haskell implementations should support, including the Prelude. Changes to these libraries are handled by the [http://web.archive.org/web/20191229055836/https://prime.haskell.org/ Haskell'] process.
   
 
Haskell modules that almost everybody uses are in this group, for example:
 
Haskell modules that almost everybody uses are in this group, for example:
 
[http://www.haskell.org/onlinereport/haskell2010/haskellch13.html Control.Monad], [http://www.haskell.org/onlinereport/haskell2010/haskellch20.html Data.List]
 
[http://www.haskell.org/onlinereport/haskell2010/haskellch13.html Control.Monad], [http://www.haskell.org/onlinereport/haskell2010/haskellch20.html Data.List]
and [http://www.haskell.org/onlinereport/haskell2010/haskellch41.html System.IO]. In GHC these are all grouped into the 'base' package.
+
and [http://www.haskell.org/onlinereport/haskell2010/haskellch41.html System.IO]. Within GHC, these are mostly grouped into the [http://hackage.haskell.org/package/base base] package, but for example [http://www.haskell.org/onlinereport/haskell2010/haskellch14.html Data.Array] is in the [http://hackage.haskell.org/package/array array] package.
   
=== The GHC standard libraries ===
+
=== GHC bootstrap libraries ===
GHC comes with an expanded version of the Haskell 2010 libraries. Together these are called the [http://www.haskell.org/ghc/docs/latest/html/libraries/index.html GHC standard libraries]. Changes to these libraries are handled by the package maintainer if one exists, or the [[Library submissions]] process if not. [http://haskell.org/hoogle Hoogle] - the Haskell API Search Engine - indexes the [http://www.haskell.org/ghc/docs/latest/html/libraries/index.html GHC standard libraries].
+
GHC comes with an expanded version of the Haskell 2010 libraries. Together these are called the [http://www.haskell.org/ghc/docs/latest/html/libraries/index.html GHC bootstrap libraries]. You should not rely on this list being stable, since it is just the list of packages that are needed to build GHC itself (including ghci and the user guide).
  +
  +
Examples of libraries that are GHC 7.8.3 boot libraries (but not core libraries, see below):
  +
[http://hackage.haskell.org/package/haskeline haskeline],
  +
[http://hackage.haskell.org/package/integer-gmp integer-gmp] and
  +
[http://hackage.haskell.org/package/terminfo terminfo].
  +
  +
=== Core Libraries ===
  +
The core libraries form a subset of the packages in the Haskell Platform that has submitted to the management process described on the [[Library submissions]] page.
  +
  +
These packages typically define basic APIs that are expected to be available in any Haskell implementation, packages that are being maintained for backwards compatibility, or in some cases, which are just needed as glue to hold the rest of the platform together.
  +
  +
Not all GHC boot libraries are core libraries.
   
 
Examples of libraries, or packages, that belong to this group are:
 
Examples of libraries, or packages, that belong to this group are:
[http://hackage.haskell.org/package/bytestring bytestring],
+
[http://hackage.haskell.org/package/mtl Monad transformer library],
[http://hackage.haskell.org/package/containers containers] and [http://hackage.haskell.org/package/Win32 Win32].
+
[http://hackage.haskell.org/package/random random] and
  +
[http://hackage.haskell.org/package/parallel parallel].
   
 
=== Haskell Platform libraries ===
 
=== Haskell Platform libraries ===
On top of the GHC standard libraries, the [http://hackage.haskell.org/platform Haskell Platform] comes preinstalled with some additional packages that together form the [http://hackage.haskell.org/platform/contents.html#packages-and-documentation Haskell Platform libraries]. These libraries have been thoroughly tested before being included. The addition of these libraries with the [http://hackage.haskell.org/platform/ Haskell Platform] is what makes it 'batteries included'.
+
On top of the Core Libraries, the [http://www.haskell.org/platform/ Haskell Platform] comes preinstalled with some additional packages that together form the [http://www.haskell.org/platform/contents.html#packages-and-documentation Haskell Platform libraries]. These libraries have been thoroughly tested before being included. The addition of these libraries with the [http://www.haskell.org/platform/ Haskell Platform] is what makes it 'batteries included'.
   
  +
Examples of included packages are:
Examples of included packages are: [http://hackage.haskell.org/package/mtl Monad transformer library], [http://hackage.haskell.org/package/parallel parallel] and [http://hackage.haskell.org/package/QuickCheck QuickCheck].
+
[http://hackage.haskell.org/package/attoparsec attoparsec], [http://hackage.haskell.org/package/network network] and [http://hackage.haskell.org/package/QuickCheck QuickCheck].
   
 
=== The Hackage database ===
 
=== The Hackage database ===
 
[http://hackage.haskell.org/packages/archive/pkg-list.html Hackage] is the final layer of the Haskell library collections. [http://hackage.haskell.org/packages/archive/pkg-list.html Hackage] aims to provide a comprehensive collection of released Haskell packages, similar to Perl's CPAN or Python's PyPI.
 
[http://hackage.haskell.org/packages/archive/pkg-list.html Hackage] is the final layer of the Haskell library collections. [http://hackage.haskell.org/packages/archive/pkg-list.html Hackage] aims to provide a comprehensive collection of released Haskell packages, similar to Perl's CPAN or Python's PyPI.
   
Start on [http://hackage.haskell.org/packages/archive/pkg-list.html Hackage] if you are looking for some functionality that did not come preinstalled with the [http://hackage.haskell.org/platform/ Haskell Platform].
+
Start on [http://hackage.haskell.org/packages/archive/pkg-list.html Hackage] if you are looking for some functionality that did not come preinstalled with the [http://www.haskell.org/platform/ Haskell Platform].
   
 
See also the [[Hackage|Hackage wiki page]] and [[Cabal/How to install a Cabal package | how to install a Cabal package]].
 
See also the [[Hackage|Hackage wiki page]] and [[Cabal/How to install a Cabal package | how to install a Cabal package]].
Line 49: Line 63:
 
* [[/Extended Haskell/]]
 
* [[/Extended Haskell/]]
 
* [[/Games/]]
 
* [[/Games/]]
* [[/Genetic programming/]]
+
* [[/Generic programming/]]
 
* [[/GUI libraries|Graphical User Interface (GUI) Libraries]]
 
* [[/GUI libraries|Graphical User Interface (GUI) Libraries]]
 
* [[/Graphics/]]
 
* [[/Graphics/]]
Line 59: Line 73:
 
* [[/Program development/]]
 
* [[/Program development/]]
 
* [[/Robotics/]]
 
* [[/Robotics/]]
  +
* [[/Statistics/]]
 
* [[/Theorem provers/]]
 
* [[/Theorem provers/]]
 
* [[/Interfacing other languages|Tools for interfacing with other languages]]
 
* [[/Interfacing other languages|Tools for interfacing with other languages]]
Line 68: Line 83:
 
* The [http://www.haskell.org/mailman/listinfo/libraries mailing list] for discussion of issues related to libraries.
 
* The [http://www.haskell.org/mailman/listinfo/libraries mailing list] for discussion of issues related to libraries.
   
You can also [http://www.reddit.com/r/haskell_proposals/top/?t=month propose and vote on new libraries] that you'd like on [http://www.reddit.com/r/haskell reddit], and look at our past [http://hackage.haskell.org/trac/summer-of-code/ Summer of Code proposals].
+
You can also [http://www.reddit.com/r/haskell_proposals/top/?t=month propose and vote on new libraries] that you'd like on [http://www.reddit.com/r/haskell reddit], and look at our past [http://web.archive.org/web/20170721102552/ghc.haskell.org/trac/summer-of-code/ Summer of Code proposals].
   
 
== Guidelines for developers ==
 
== Guidelines for developers ==
Line 79: Line 94:
 
* [[Library submissions|How to propose changes to the standard libraries]]
 
* [[Library submissions|How to propose changes to the standard libraries]]
 
* [http://web.archive.org/web/20071011215053/http://pupeno.com/2006/12/12/the-lambda-revolution-v/ Creating a .deb from a Haskell Cabal package] (in the Web Archive)
 
* [http://web.archive.org/web/20071011215053/http://pupeno.com/2006/12/12/the-lambda-revolution-v/ Creating a .deb from a Haskell Cabal package] (in the Web Archive)
* [http://cgi.cse.unsw.edu.au/~dons/blog/2006/12/11 Creating a Haskell library by example]
 
 
* Guide to making standard [[Library submissions|library submissions]]
 
* Guide to making standard [[Library submissions|library submissions]]
* If you notice the library documentation is lacking, or could be improved, [http://haskell.org/haskellwiki/Improving_library_documentation please report it here]
+
* If you notice the library documentation is lacking, or could be improved, [http://www.haskell.org/haskellwiki/Improving_library_documentation please report it here]
* [http://www.google.com/codesearch Google Code Search] can help identify common idioms, improving your API.
 
 
* [[Future projects]], more projects people would like.
 
* [[Future projects]], more projects people would like.
* Project activity for some of the larger Haskell projects is graphed [http://www.cse.unsw.edu.au/~dons/images/commits/community/ here].
 
 
* [[Cabal]], The Common Architecture for Building Applications and Libraries, is a framework for packaging, building, and installing any tool developed in the Haskell language.
 
* [[Cabal]], The Common Architecture for Building Applications and Libraries, is a framework for packaging, building, and installing any tool developed in the Haskell language.
 
* [[Hack-Nix]], a set of tools based on the [http://nixos.org Nix] package manager to manage multiple setups to build a project
 
* [[Hack-Nix]], a set of tools based on the [http://nixos.org Nix] package manager to manage multiple setups to build a project
Line 100: Line 112:
 
* [http://wiki.clean.cs.ru.nl/Libraries Clean]
 
* [http://wiki.clean.cs.ru.nl/Libraries Clean]
 
* [http://www.standardml.org/Basis/ Standard ML]
 
* [http://www.standardml.org/Basis/ Standard ML]
* [http://caml.inria.fr/pub/docs/manual-ocaml/manual034.html Objective Caml]
+
* [http://web.archive.org/web/20070515163201/caml.inria.fr/pub/docs/manual-ocaml/manual034.html Objective Caml]
 
* [http://srfi.schemers.org/ Scheme]
 
* [http://srfi.schemers.org/ Scheme]

Latest revision as of 01:40, 1 March 2020


The number of Haskell packages is growing rapidly. The section 'Haskell library collections' gives an ordering of all these packages by relative importance. In the section 'Haskell applications and libraries' an ordering by category is given. Finally some guidelines for developers of new packages are presented.

Haskell library collections

Haskell Prelude

The most important Haskell library is called the Prelude. It is implicitly imported by default, and includes the most commonly used functions. Make sure you know what they do and how to use them effectively.

Haskell 2010 libraries

The Haskell 2010 Language and library specification defines a set of libraries with basic functionality which all Haskell implementations should support, including the Prelude. Changes to these libraries are handled by the Haskell' process.

Haskell modules that almost everybody uses are in this group, for example: Control.Monad, Data.List and System.IO. Within GHC, these are mostly grouped into the base package, but for example Data.Array is in the array package.

GHC bootstrap libraries

GHC comes with an expanded version of the Haskell 2010 libraries. Together these are called the GHC bootstrap libraries. You should not rely on this list being stable, since it is just the list of packages that are needed to build GHC itself (including ghci and the user guide).

Examples of libraries that are GHC 7.8.3 boot libraries (but not core libraries, see below): haskeline, integer-gmp and terminfo.

Core Libraries

The core libraries form a subset of the packages in the Haskell Platform that has submitted to the management process described on the Library submissions page.

These packages typically define basic APIs that are expected to be available in any Haskell implementation, packages that are being maintained for backwards compatibility, or in some cases, which are just needed as glue to hold the rest of the platform together.

Not all GHC boot libraries are core libraries.

Examples of libraries, or packages, that belong to this group are: Monad transformer library, random and parallel.

Haskell Platform libraries

On top of the Core Libraries, the Haskell Platform comes preinstalled with some additional packages that together form the Haskell Platform libraries. These libraries have been thoroughly tested before being included. The addition of these libraries with the Haskell Platform is what makes it 'batteries included'.

Examples of included packages are: attoparsec, network and QuickCheck.

The Hackage database

Hackage is the final layer of the Haskell library collections. Hackage aims to provide a comprehensive collection of released Haskell packages, similar to Perl's CPAN or Python's PyPI.

Start on Hackage if you are looking for some functionality that did not come preinstalled with the Haskell Platform.

See also the Hackage wiki page and how to install a Cabal package.

Haskell applications and libraries

Applications, libraries and tools for Haskell or written in Haskell have been classified below, but you should check Hackage for the latest list.

Other places to look include:

You can also propose and vote on new libraries that you'd like on reddit, and look at our past Summer of Code proposals.

Guidelines for developers

Built with Cabal

Developer guides:

Proposals for the module name space layout that can be used to guide the construction of new libraries.

Libraries for other languages

If you are thinking about designing a new library for Haskell, you ought to look what has been done in other languages. Here are standard library definitions for