X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=README.md;h=9d6166b075cbf7a4ef537ecd0da3afff4a6f0458;hb=5b28db7d119dc46c382e666fbb2110b611398c4a;hp=0e1ce2fc1b1b5529409ca588a80d73b9da890cc8;hpb=d78112147d02e263a5b000cb0b3b9ff84aa5c89a;p=github%2Ffretlink%2Fpurs-loader.git diff --git a/README.md b/README.md index 0e1ce2f..9d6166b 100644 --- a/README.md +++ b/README.md @@ -2,54 +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). -This loader works in conjunction with the [PureScript webpack plugin](https://npmjs.org/package/purescript-webpack-plugin). Ensure the plugin is installed and configured accordingly. - ``` +// For PureScript 0.9 and newer npm install purs-loader --save-dev -``` - -## Options -###### `bundleOutput` (String) - -Relative path to the bundled JavaScript file generated by the `PurescriptWebpackPlugin`. The default value is `output/bundle.js`. +// Fore PureScript 0.8 +npm install purs-loader@purescript-0.8 --save-dev +``` ## Example -```js -// webpack.config.js -'use strict'; - -var PurescriptWebpackPlugin = require('purescript-webpack-plugin'); - -var src = ['bower_components/purescript-*/src/**/*.purs', 'src/**/*.purs']; - -var ffi = ['bower_components/purescript-*/src/**/*.js', 'src/**/*FFI.js']; - -var modulesDirectories = [ - 'node_modules', - 'bower_components' -]; - -var config - = { entry: './src/entry' - , output: { path: __dirname - , pathinfo: true - , filename: 'bundle.js' - } - , module: { loaders: [ { test: /\.purs$/ - , loader: 'purs-loader' - } ] } - , resolve: { modulesDirectories: modulesDirectories } - , plugins: [ new PurescriptWebpackPlugin({src: src, ffi: ffi}) ] +```javascript +const webpackConfig = { + // ... + loaders: [ + // ... + { + test: /\.purs$/, + loader: 'purs-loader', + exclude: /node_modules/, + query: { + psc: 'psa', + src: ['bower_components/purescript-*/src/**/*.purs', 'src/**/*.purs'] + } } - ; + // ... + ] + // ... +} +``` -module.exports = config; +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) + pscIdeArgs: {}, // for example, to use different psc-ide-server port: {port: 4088} + 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') + ] +} ``` -See the [example](https://github.com/ethul/purs-loader/tree/master/example) directory for a complete example. +### Instant rebuilds (experimental) + +Experimental support for instant rebuilds using `psc-ide-server` can be enabled +via the `pscIde: true` option. +You can use an already running `psc-ide-server` instance by specifying the port in `pscIdeArgs`.