Eta Hackage

This repository contains a set of patches for particular packages from Hackage that cannot be built out-of-the-box with etlas. To install a package, you have to run the following command:

etlas install <package-name>

etlas will take care of downloading the tar file, optionally patching it, and installing it. If a patch is in the repo, but your local etlas in unable to find a patch for it, run

etlas update

and try the installation again.

Table of Contents

• Package Categorization
  • Supported Packages
  • Unsupported Packages
  • Built-in Packages
• Contributing
  • Patching a Library
    • Prerequisites
    • Patching

Package Categorization

Overview

We have categorized the packages from Hackage below in relation to etlas support. If a package from Hackage has not been listed here, it means no one has tried to build it and categorize it.

If you would like to have a given package/version made compatible with etlas, you can:

• Submit an issue
• Ask us on Gitter

Supported Packages

These packages are supported by etlas.

• abstract-deque-0.3
• abstract-par-0.3.3
• Adaptive-0.1
• adjunctions-4.3
• aeson-1.1.0.0
• aeson-pretty-0.8.2
• agum-2.6
• ansi-terminal-0.6.2.3
  • NOTE: Windows support disabled.
• ansi-wl-pprint-0.6.7.3
• appar-0.1.4
• array-0.5.1.1
• array-utils-0.3
• async-2.1.1
• attoparsec-0.13.1.0
• auto-update-0.1.4
• base-compat-0.9.1
• base-orphans-0.5.4
• base-prelude-1.0.1.1
• base16-bytestring-0.1.1.6
• base64-bytestring-1.0.0.1
• basic-lens-0.0.0
• basic-prelude-0.6.1
• binary-conduit-1.2.4.1
• binary-search-1.0.0.3
• bindings-DSL-1.0.23
• bifunctors-5.4.1
• bitarray-0.0.1.1
• Binpack-0.4.1
• blaze-builder-0.4.0.2
• blaze-html-0.8.1.3
• blaze-html-truncate-0.3.0.0
• blaze-markup-0.7.1.1
• Boolean-0.2.3
• byteable-0.1.1
• bytestring-builder-0.10.8.1.0
• call-stack-0.1.0
• case-insensitive-1.2.0.7
• cassava-0.4.5.1
• cereal-0.5.4.0
• chunked-data-0.3.0
• clock-0.7.2
• colour-2.3.3
• comonad-5
  • NOTE: The patch just changes the Build-Type. Should be restored once Cabal can be compiled with Eta.
• conceit-0.4.0.0
• concurrent-machines-0.2.3.3
• conduit-1.2.8
• constraints-0.8
• containers >= 0.5.8.1 && <= 0.5.9.1
• contravariant-1.4
• control-monad-omega-0.3.1
• cookie-0.4.2.1
• data-default-0.7.1.1
• data-default-class-0.1.2.0
• data-default-instances-containers-0.0.1
• data-default-instances-dlist-0.0.1
• data-default-instances-old-locale-0.0.1
• deepseq-1.4.2.0
• deepseq-generics-0.2.0.0
• directory-1.3.0.0
• directory-tree-0.12.1
• disjoint-sets-st-0.1
• distributive >= 0.5.0.2 && <= 0.5.2
  • NOTE: The patch just changes the Build-Type. Should be restored once Cabal can be compiled with Eta.
• dlist-0.8.0.2
• dom-lt-0.1.3
• DecisionTree-0.0
• either-4.4.1.1
• errors-2.1.3
• exceptions-0.8.3
• extra-1.5.2
• fail-4.9.0.0
• fibonacci-0.2.0.1
• fingertree-0.1.1.0
• fingertree-psqueue-0.3
• fingertree-tf-0.1.0.0
• filepath >= 1.4.1.0 && <= 1.4.1.1
• fgl-5.5.3.0
  • NOTE: Gives Ignoring ANN annotation, because this is a stage-1 compiler or doesn't support GHCi
• fmlist-0.9
• free-4.12.4
• garsia-wachs-1.2
• generic-deriving >= 1.11.1 && <= 1.11.2
• GenericPretty-1.2.1
• gdiff-1.1
• gray-code-0.3.1
• ghc-boot-th-8.0.1
• Glob-0.7.14
• graph-matchings-0.1.0.0
• graph-wrapper-0.2.5.1
• groups-0.4.0.0
• hashable >= 1.2.4.0 && <= 1.2.6.0
• hashtables >= 1.2.1.0 && <= 1.2.1.1
• heap-1.0.3
• heaps-0.3.3
• hetero-map-0.21
• hex-0.1.2
• hgal-2.0.0.2
• HoleyMonoid-0.1.1
• hostname-1.0
• html-truncate-0.3.0.0
• http-api-data-0.3.5
  • NOTE: The patch just changes the Build-Type. Should be restored once Cabal can be compiled with Eta.
• http-date-0.0.6.1
• http-media-0.6.4
• http-types-0.9.1
• HUnit-1.5.0.0
• ieee754-0.8.0
• interval-1.20160821
• iproute-1.7.1
• js-flot-0.8.3
• js-jquery-3.1.1
• kan-extensions-5.0.1
• lazy-io-0.1.0
• labeled-tree-1.0.0.0
• lens >= 4.15.1 && <= 4.15.2
• lens-family-1.2.1
• lens-family-core-1.2.1
• lca-0.3
• lifted-async-0.9.0
• lifted-base >= 0.2.3.8 && <= 0.2.3.10
• list-extras-0.4.1.4
• logict-0.6.0.2
• loop-0.3.0
• machines-0.6.1
• machines-binary-0.3.0.3
• machines-io-0.2.0.13
• matrix-0.3.5.0
• map-syntax-0.2.0.1
• meldable-heap-2.0.3
• microlens-0.4.7.0
• microlens-mtl-0.1.10.0
• mime-types-0.1.0.7
• mmorph >= 1.0.6 && <= 1.0.9
• monad-par-0.3.4.8
• monad-par-extras-0.3.3
• monoid-absorbing-0.1.0.4
• monad-control-1.0.1.0
• monad-loops-0.4.3
• MonadRandom-0.4.2.3
• monads-tf-0.1.0.3
• mono-traversable-1.0.1
• mtl-2.2.1
• mtl-compat-0.2.1.3
• multiset-0.3.3
• mwc-random-0.13.5.0
• nested-sequence-0.2
• nested-sets-0.0.1.1
• network-uri-2.6.1.0
• newtype-0.2
• newtype-generics-0.4.1
• NumInstances-1.4
• old-locale-1.0.0.7
• old-time-1.1.0.3
• operational-0.2.3.5
• optparse-applicative-0.13.2.0
• parallel-3.2.1.0
• parsec-3.1.11
• patch-combinators-0.2.2
• pipes >= 4.3.1 && <= 4.3.2
• pipes-4.3.1
• pipes-bytestring-2.1.4
• pipes-concurrency-2.0.7
• pipes-group-1.0.6
• pipes-parse-3.0.8
• pipes-safe-2.2.5
• pointed-5
• polyparse-1.12
• pqueue-1.3.1.1
• psqueues-0.2.2.3
• pqueue-1.3.1.1
• PSQueue-1.1
• prelude-extras-0.4.0.3
• pretty-1.1.3.4
• prettyclass-1.0.0.0
• primes-0.2.1.0
• primitive-0.6.2.0
• profunctors-5.2
• protolude-0.1.10
• queue-0.1.2
• QuickCheck-2.9.2
• ReadArgs-1.2.3
• readable-0.3.1
• reflection-2.1.2
  • template-haskell flag was disabled by default. Enable once TemplateHaskell works.
• regex-base-0.93.2
• regex-posix-0.95.2
• relacion-0.1
• resourcet >= 1.1.8.1 && <= 1.1.9
• randproc-0.4
• safe >= 0.3.9 && <= 0.3.11
• servant-0.9.1.1
• servant-docs-0.9.1.1
• servant-server-0.9.1.1
  • NOTE: Servant.Utils.StaticFiles is disabled.
• scientific-0.3.4.9
• semigroups-0.18.2
• semigroupoids-5.1
  • NOTE: The patch just changes the Build-Type. Should be restored once Cabal can be compiled with Eta.
• silently-1.2.5
• singletons-2.0.1
• split-0.2.3.1
• stable-marriage-0.1.1.0
• StateVar-1.1.0.4
• stm-2.4.4.1
• stm-chans-3.0.0.4
  • NOTE: The patch just changes the Build-Type. Should be restored once Cabal can be compiled with Eta.
• string-conversions-0.4.0.1
• stringsearch-0.3.6.6
• syb-0.6
• system-filepath-0.4.13.4
• tagged-0.8.5
• tagsoup-0.14
• template-haskell-2.11.0.0
• terminal-size-0.3.2.1
• text-1.2.2.1
• tf-random-0.5
• time >= 1.6.0.1 <= 1.8.0.2
• time-locale-compat-0.1.1.3
• transformers-0.5.2.0
• transformers-base-0.4.4
• transformers-compat-0.5.1.4
• tree-fun-0.8.1.0
• type-level-sets-0.8.0.0
• unexceptionalio-0.3.0
• unification-fd-0.10.0.1
• union-find-0.2
• union-find-array-0.1.0.2
• unicode-transforms-0.2.0
• unordered-containers-0.2.7.1
• uri-bytestring-0.2.2.1
• utf8-string-1.0.1.1
• uuid-types-1.0.3
• vault-0.3.0.6
• vector-0.11.0.0
• vector-algorithms-0.7.0.1
• vector-binary-instances-0.2.3.3
• vinyl-0.5.1.1
• void-0.7.1
• wai-3.2.1.1
• word8-0.1.2
• xhtml-3000.2.1
• xml-types-0.3.6
• xmlhtml-0.2.3.5

Unsupported Packages

These packages are heavy on FFI dependencies and don't make sense in the context of the JVM, hence no effort will be made to port them.

• None for now

Built-in Packages

These packages have special meaning in the Eta compiler and hence are provided upon installation.

• base-4.8.2.0
• integer-0.5.1.0
  • NOTE: Due to the drastic differences between the Integer implementations, the public API between the corresponding GHC package is slightly different.
• ghc-prim-0.4.0.0
  • NOTE: Due to the introduction of new primitives for Eta, the public API between the corresponding GHC package is slightly different.

Contributing

Patching a Library

Suppose that you find a library you want to patch or fix an existing patch, say somepackage-0.1.2.3.

Prerequisites

If you have already forked this repository, then skip to step 3.

1. Fork this repository.

2. Clone the forked repository.

   git clone http://github.org/your-name-here/eta-hackage
   

3. Checkout the master branch and pull any changes.

   git checkout master
   git pull
   

4. Create a new branch with the same name as the package.

   $ git checkout -b somepackage
   

Patching

1. Fetch the package and navigate to it.

   etlas get somepackage-0.1.2.3
   cd somepackage-0.1.2.3/
   

2. If the message "Found patch in eta-hackage for somepackage-0.1.2.3" appeared in step 1, skip to step 3.

   Otherwise, initialize a Git repository and make an initial commit.

   git init && git add . && git commit -m "First"
   

3. Build the package.

   etlas build
   

4. Apply the desired changes and go back to step 3 as long as the build fails.

5. Once the build succeeds, make a commit.

   git add . && git commit -m "Patched"
   

6. Create a patch.

   git format-patch HEAD~ --stdout > somepackage-0.1.2.3.patch
   

7. If you have changed the .cabal file of the package in your patch, make a copy and rename it from somepackage.cabal to somepackage-0.1.2.3.cabal.

   cp somepackage.cabal somepackage-0.1.2.3.cabal
   

8. Copy the patch file and the cabal file (if changed) to the patches directory in your local clone of your fork of the eta-hackage repository.

   NOTE: $YOUR_FORK_PATH should be replaced with the path to the local clone of your forked version of eta-hackage.

   If the cabal file didn't change:

   cp somepackage-0.1.2.3.patch $YOUR_FORK_PATH/patches/ 
   

   If the cabal file changes:

   cp somepackage-0.1.2.3.cabal somepackage-0.1.2.3.patch $YOUR_FORK_PATH/patches/ 
   

9. Update this README.md with the package name (in alphabetical order) in the Supported Packages section in the same format as the other packages.

10. In your eta-hackage repository,

    $ git add .
    $ git commit -m "Patched somepackage-0.1.2.3"
    $ git push origin
    

11. Submit a pull request to this repository for review.