X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=README.md;h=ae54a47c78aa6935e1ef6ee5316185cc17dc5649;hb=4b99e432d63e7a0ce8ad8d2184232417853bfd2b;hp=dcbedf285102349f9d2a002448af136529f1625d;hpb=9f398b64af9025e146362a6cf7a2817255700337;p=github%2Ffretlink%2Fpurs-loader.git diff --git a/README.md b/README.md index dcbedf2..ae54a47 100644 --- a/README.md +++ b/README.md @@ -2,29 +2,73 @@ > [PureScript](http://www.purescript.org) loader for [webpack](http://webpack.github.io) +- Supports hot-reloading and rebuilding of single source files +- Dead code elimination using the `bundle` option +- Colorized build output using `purescript-psa` and the `psc: "psa"` option + ## Install -Install with [npm](https://npmjs.org/package/purs-loader) +Install with [npm](https://npmjs.org/package/purs-loader). ``` npm install purs-loader --save-dev -``` -## Options - - - **no-prelude**: Boolean value that toggles `--no-prelude` - - Do not include the Prelude in the generated Javascript. - - **no-opts**: Boolean value that toggles `--no-opts` - - Disable all optimizations. - - **no-magic-do**: Boolean value that toggles `--no-magic-do` - - Turn off optimizations which inline calls to >>= for the Eff monad. - - **no-tco**: Boolean value that toggles `--no-tco` - - Turn off tail-call elimination. - - **verbose-errors**: Boolean value that toggles `--verbose-errors` - - Generate verbose error messages. - - **output**: String value that sets `--output=` - - Write the generated Javascript to the specified file. +npm install purs-loader@next --save-dev + +npm install purs-loader@purescript-0.8 --save-dev + +npm install purs-loader@purescript-0.9 --save-dev +``` ## Example -See the [example](https://github.com/ethul/purs-loader/tree/topic/bower-components/example) directory for a complete example. +```javascript +const webpackConfig = { + // ... + loaders: [ + // ... + { + test: /\.purs$/, + loader: 'purs-loader', + exclude: /node_modules/, + query: { + psc: 'psa', + src: ['bower_components/purescript-*/src/**/*.purs', 'src/**/*.purs'] + } + } + // ... + ] + // ... +} +``` + +Refer to the [purescript-webpack-example](https://github.com/ethul/purescript-webpack-example) for a more detailed example. + +### Options + +Default options: + +```javascript +{ + psc: 'psc', + pscArgs: {}, + pscBundle: 'psc-bundle', + pscBundleArgs: {}, + pscIde: false, // instant rebuilds using psc-ide-server (experimental) + pscIdeColors: false, // defaults to true if psc === 'psa' + bundleOutput: 'output/bundle.js', + bundleNamespace: 'PS', + bundle: false, + warnings: true, + output: 'output', + src: [ + path.join('src', '**', '*.purs'), + path.join('bower_components', 'purescript-*', 'src', '**', '*.purs') + ] +} +``` + +### Instant rebuilds (experimental) + +Experimental support for instant rebuilds using `psc-ide-server` can be enabled +via the `pscIde: true` option.