ghc-lib-parser-ex: Algorithms on GHC parse trees
Please see the README on GitHub at https://github.com/shayne-fletcher/ghc-lib-parser-ex#readme
[Skip to Readme]
| Versions [faq] | 0.20200102, 0.20200201, 0.20200201.1.0, 8.8.1.20191204, 8.8.2, 8.8.3.0, 8.8.4.0 |
|---|---|
| Change log | ChangeLog.md |
| Dependencies | base (>=4.7 && <5), bytestring (>=0.10.8.2), ghc (==8.8.*), ghc-boot-th, ghc-lib-parser, uniplate (>=1.5) [details] |
| License | BSD-3-Clause |
| Copyright | Copyright © 2020, Shayne Fletcher. All rights reserved. |
| Author | Shayne Fletcher |
| Maintainer | shayne@shaynefletcher.org |
| Category | Development |
| Home page | https://github.com/shayne-fletcher/ghc-lib-parser-ex#readme |
| Bug tracker | https://github.com/shayne-fletcher/ghc-lib-parser-ex/issues |
| Source repo | head: git clone https://github.com/shayne-fletcher/ghc-lib-parser-ex |
| Uploaded | by shayne_fletcher at Sat Feb 1 22:04:11 UTC 2020 |
| Distributions | NixOS:8.8.3.0 |
| Downloads | 390 total (390 in the last 30 days) |
| Rating | (no votes yet) [estimated by Bayesian average] |
| Your Rating | |
| Status | Docs available [build log] Last success reported on 2020-02-02 [all 1 reports] |
Modules
[Index] [Quick Jump]
Flags
| Name | Description | Default | Type |
|---|---|---|---|
| ghc-lib | Force dependency on ghc-lib-parser even if GHC API in the ghc package is supported | Disabled | Manual |
Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info
Downloads
- ghc-lib-parser-ex-8.8.4.0.tar.gz [browse] (Cabal source package)
- Package description (as included in the package)
Readme for ghc-lib-parser-ex-8.8.4.0
[back to package description]ghc-lib-parser-ex 
Copyright © 2020, Shayne Fletcher. All rights reserved. SPDX-License-Identifier: BSD-3-Clause
The ghc-lib-parser-ex package contains GHC API parse tree utilities. It works with or without ghc-lib-parser.
Using ghc-lib-parser-ex
Package ghc-lib-parser-ex is on Hackage e.g. cabal install ghc-lib-parser-ex. Like ghc-lib-parser, there are two release streams within the ghc-lib-parser-ex name.
Version numbers are of the form α.β.γ.δ where α.β corresponds to a GHC series and γ.δ are the major and minor parts of the ghc-lib-ex-parser package release. Examples:
- Version 8.10.1.3 is compatible with any
ghc-lib-parser-8.10.*(orghc-8.10.*) package; - Version 0.20190204.2.0 is compatible with
ghc-lib-parser-0.20190204.
The major part γ of the release number indicates an interface breaking change from the previous release. The minor part δ indicates a non-interface breaking change from the previous release.
Building ghc-lib-parser-ex
You can build with stack build and test with stack test. Produce ghc-lib-parser-ex package distributions by executing the CI script:
# Setup
git clone git@github.com:shayne-fletcher/ghc-lib-parser-ex.git
cd ghc-lib-parser-ex
stack runhaskell --package extra --package optparse-applicative CI.hs
Run stack runhaskell --package extra --package optparse-applicative CI.hs -- --help for more options.
To run hlint on this repository, hlint --cpp-include cbits --cpp-define GHCLIB_API_XXX . (where XXX at this time is one of 808, 810 or 811).
Releasing ghc-lib-parser-ex (notes for maintainers)
Update the changelog, git tag <version> && git push origin <version> then build via the above instructions and upload the resulting .tar.gz files to Hackage.