A Haskell library that simplifies access to remote data, such as databases or web-based services.
Go to file
Zejun Wu 04da91d564 Relax dependency constrainst for ghc-8.10
Summary:
New versions are available for aeson, hashable and time. We need bump the
upper bound so that we can build haxl on ghc-8.10.

Reviewed By: rayshih

Differential Revision: D23090291

fbshipit-source-id: 58b874da0eb658e50a23fb0acb2cbcee42fdf1c7
2020-08-13 09:16:38 -07:00
example Remove FutureFetch from Haxl (#109) 2020-01-16 08:40:22 -08:00
Haxl Fix haxl build for ghc-8.2 2020-08-13 09:16:38 -07:00
tests Add test for Async exceptions 2020-07-15 04:39:37 -07:00
.gitignore Make haxl compile cleanly with stack build --pedantic 2016-10-05 05:46:30 -07:00
.travis.yml update travis config to remove unsupported ghc versions (#106) 2020-01-10 03:25:12 -08:00
changelog.md Track fetches/memos accurately in profiling (#120) 2020-04-24 08:02:53 -07:00
CODE_OF_CONDUCT.md Adopt Contributor Covenant 2019-08-29 23:20:50 -07:00
CONTRIBUTING.md Fix code of conduct link. 2018-08-07 09:35:56 -07:00
haxl.cabal Relax dependency constrainst for ghc-8.10 2020-08-13 09:16:38 -07:00
LICENSE Update haxl copyright headers 2015-03-11 12:42:01 -07:00
logo.png Initial open source import 2014-06-10 02:47:59 -07:00
logo.svg Add SVG logo 2014-06-16 06:48:28 -07:00
readme.md Add links to License and Contribution guidelines (#127) 2020-08-05 15:44:24 -07:00
Setup.hs Initial open source import 2014-06-10 02:47:59 -07:00
stack.yaml Bump stackage-lts version in stack.yaml 2017-06-15 11:33:47 -07:00

Haxl Logo

Haxl

Build Status

Haxl is a Haskell library that simplifies access to remote data, such as databases or web-based services. Haxl can automatically

  • batch multiple requests to the same data source,
  • request data from multiple data sources concurrently,
  • cache previous requests,
  • memoize computations.

Having all this handled for you behind the scenes means that your data-fetching code can be much cleaner and clearer than it would otherwise be if it had to worry about optimizing data-fetching. We'll give some examples of how this works in the pages linked below.

There are two Haskell packages here:

To use Haxl in your own application, you will likely need to build one or more data sources: the thin layer between Haxl and the data that you want to fetch, be it a database, a web API, a cloud service, or whatever.

There is a generic datasource in "Haxl.DataSource.ConcurrentIO" that can be used for performing arbitrary IO operations concurrently, given a bit of boilerplate to define the IO operations you want to perform.

The haxl-facebook package shows how we might build a Haxl data source based on the existing fb package for talking to the Facebook Graph API.

Where to go next?

Contributing

We welcome contributions! See CONTRIBUTING for details on how to get started, and our Code of Conduct.

License

Haxl uses the BSD 3-clause License, as found in the LICENSE file.