ghc-lib-parser-ex

Algorithms on GHC parse trees

https://github.com/shayne-fletcher/ghc-lib-parser-ex#readme

Version on this page:8.10.0.16
LTS Haskell 22.36:9.6.0.2
Stackage Nightly 2024-10-03:9.8.0.2
Latest on Hackage:9.10.0.0

See all snapshots ghc-lib-parser-ex appears in

BSD-3-Clause licensed by Shayne Fletcher
Maintained by [email protected]
This version can be pinned in stack with:ghc-lib-parser-ex-8.10.0.16@sha256:766ccf1ab6508ffcd9ae70a5b383ddb43ecc2cc08fee96fb404429b29b3435a1,3627

Module documentation for 8.10.0.16

Used by 1 package in lts-16.11(full list with versions):
hlint

ghc-lib-parser-ex License BSD3 Hackage version Stackage version Build Status

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.

Versioning policy

Package ghc-lib-parser-ex does not conform to the Haskell Package Versioning Policy. 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.* (or ghc-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 [email protected]: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.

Changes

Changelog for ghc-lib-parser-ex

8.10.0.16 released 2020-08-08

  • Update to ghc-8.10.2.

0.20200801 released 2020-08-01

  • Update to ghc-lib-0.20200801

8.8.6.1 released 2020-07-16

0.20200704 released 2020-07-04

  • New function isImportQualifiedPost

8.10.0.15 released 2020-07-04

  • New function isImportQualifiedPost

8.10.0.14 released 2020-06-10

  • New function isSymbolRdrName
  • New module
    • Language.Haskell.GhclibParserEx.GHC.Settings.Config to replace Language.Haskell.GhclibParserEx.Config (which remains for now but deprecated and will be removed in a future release)

0.20200601 released 2020-06-01

8.10.0.13 released 2020-05-31

  • Sync extra with HLint

8.10.0.12 released 2020-05-31

  • New module Language.Haskell.GhclibParserEx.GHC.Hs

8.10.0.11 released 2020-05-18

  • Upgrade to ghc-lib-parser-8.10.1.20200523

8.10.0.10 released 2020-05-18

  • Upgrade to ghc-lib-parser-8.10.1.20200518

8.10.0.9 released 2020-05-16

  • New modules
    • Language.Haskell.GhclibParserEx.GHC.Hs.Binds
    • Language.Haskell.GhclibParserEx.GHC.Hs.ImpExp

8.10.0.8 released 2020-05-14

  • New module Language.Haskell.GhclibParserEx.GHC.Types.Name.Reader

8.10.0.7 released 2020-05-13

  • New function fixitiesFromModule

8.10.0.6 released 2020-05-05

  • Bugfix in parsePragmasIntoDynFlags that meant that default enabled/disabled extensions subsequently disabled/enabled via pragma weren’t getting disabled/enabled

8.10.0.5 released 2020-05-02

  • New modules
    • Language.Haskell.GhclibParserEx.GHC.Parser, Language.Haskell.GhcLibParserEx.GHC.Utils.Outputable to replace Language.Haskell.GhclibParserEx.Parse and Language.Haskell.GhclibParserEx.Outputable (which remain for now but deprecated and will be removed in a future release)

0.20200501 released 2020-05-01

8.10.0.4 released 2020-04-04

  • Add expression predicates isWholeFrac, isFieldPunUpdate, isStrictMatch, isMultiIf, isProc, isTransStmt;
  • Add pattern predicate isPFieldPun.

8.10.0.3 released 2020-04-03

  • strToPat now returns an LPat GhcPs
  • parseExpression now returns an ParseResult (LHsExpr GhcPs) (>= ghc-8.10)

0.20200401 released 2020-04-01

8.10.0.2 released 2020-03-30

  • Rework cabal flags; allow full configurability with a good default:
    • Have two flags auto and no-ghc-lib. Default behavior exactly as hlint linking ghc-lib-parser-8.10.* if not on ghc-8.10.* and ghc-8.10.* otherwise.

8.10.0.1 released 2020-03-28

  • Unless the Cabal flag ghc-lib is true link native ghc-libs (without regard for the compiler version)
  • Change the signature of hasPFieldsDotDot
    • This has no impact on 8.8 parse trees but matters when it comes to >= 8.10
  • Change the signature of isPFieldWildcard
    • This has no impact on 8.8 parse trees but matters when it comes to >= 8.10

8.10.0.0 released 2020-03-24

  • First release of the ghc-8.10 series

8.8.6.0 released 2020-03-22

  • Language.Haskell.GhclibParserEx.DynFlags is now Language.Haskell.GhclibParserEx.GHC.Driver.Session

8.8.5.8 released 2020-03-17

8.8.5.7 released 2020-03-16

8.8.5.6 released 2020-03-13

  • From Language.Haskell.GhclibParserEx.Fixity:
    • Expose infixr_, infixl_, infix_ and fixity

8.8.5.5 released 2020-03-12

  • Remove from Language.Haskell.GhclibParserEx.Fixity:
    • preludeFixities
    • baseFixities

8.8.5.4 released 2020-03-11

  • Expose from Language.Haskell.GhclibParserEx.Fixity:
    • preludeFixities
    • baseFixities
    • lensFixities
    • otherFixities

0.20200301 released 2020-03-01

8.8.5.3 released 2020-02-25

  • New modules:
    • Language.Haskell.GhclibParserEx.Pat
    • Language.Haskell.GhclibParserEx.Types
    • Language.Haskell.GhclibParserEx.Decls

8.8.5.2 released 2020-02-16

  • New DynFlags functions readExtension, extensionImplications.

8.8.5.1 released 2020-02-09

  • Expression predicate tests.

8.8.5.0 released 2020-02-07

8.8.4.0 released 2020-02-01

  • New modules:
    • Language.Haskell.GhclibparserEx.GHC.Hs.Expr
  • Moved modules:
    • Language.Haskell.GhclibparserEx.HsExtendInstances -> Language.Haskell.GhclibparserEx.GHC.Hs.ExtendInstances;

0.20200201.1.0 released 2020-02-01

  • New modules:
    • Language.Haskell.GhclibparserEx.HsExtendInstances.

8.8.3.0 released 2020-01-25

  • Change in versioning scheme;
  • New modules:
    • Language.Haskell.GhclibParserEx.Config
    • Language.Haskell.GhclibParserEx.DynFlags
  • parsePragmasIntoDynFlags signature change.

8.8.1.20191204, 8.8.2, 0.20200102 released 2020-01-18

  • First releases