purescript-psa

psa
===

A pretty, flexible error/warning reporting frontend for the PureScript compiler
(psc).

* Colors!
* Original source spans in errors
* Fine-grained warning filtering
* Warning persistence

Install
-------

``
npm install -g purescript-psa
`

Sample Usage
------------

Censor all warnings:
`
psa --censor-warnings
`

Censor library warnings:
`
psa --censor-lib
`

Censor source warnings:
`
psa --censor-src
`

Censor specific warning codes:
`
psa --censor-codes=ShadowedName,ImplicitImport,MissingTypeDeclaration
`

Only show specific warning codes:
`
psa --filter-codes=DeprecatedOperatorDecl,DeprecatedClassExport
`

Turn source warnings into errors:
`
psa --strict
`

Note: It's assumed psc is in your path. If you'd like to use a custom
binary location you can set the --psc=/foo/bar/psc flag.

Persisting Warnings
-------------------

psc does not persist warnings between compilations, but psa can do it with
the --stash flag. This serializes the set of warnings to disk and merges it
with the new set on each compilation.

`
psa --stash
`

If you are compiling multiple projects from the same root, you can specify
which stash file should be used:

`
psa --stash=.foo-stash
`

Usage with pulp
---------------

Pulp supports building with psa: it will be used by default if it is installed, and options will be passed through, eg:

`
pulp build -- --stash --censor-lib
``