]>
Commit | Line | Data |
---|---|---|
1 | # purs-loader | |
2 | ||
3 | > [PureScript](http://www.purescript.org) loader for [webpack](http://webpack.github.io) | |
4 | ||
5 | ## Install | |
6 | ||
7 | Install with [npm](https://npmjs.org/package/purs-loader) | |
8 | ||
9 | ``` | |
10 | npm install purs-loader --save-dev | |
11 | ``` | |
12 | ||
13 | ## Options | |
14 | ||
15 | ###### `noPrelude` (Boolean) | |
16 | ||
17 | Toggles `--no-prelude` that omits the Prelude. | |
18 | ||
19 | ###### `noTco` (Boolean) | |
20 | ||
21 | Toggles `--no-tco` that disables tail-call optimizations. | |
22 | ||
23 | ###### `noMagicDo` (Boolean) | |
24 | ||
25 | Toggles `--no-magic-do` that disables optimizations overloading the do keyword generating efficient code for the `Eff` monad. | |
26 | ||
27 | ###### `noOpts` (Boolean) | |
28 | ||
29 | Toggles `--no-opts` that skips the optimization phase. | |
30 | ||
31 | ###### `verboseErrors` (Boolean) | |
32 | ||
33 | Toggles `--verbose-errors` that displays verbose error messages. | |
34 | ||
35 | ###### `comments` (Boolean) | |
36 | ||
37 | Toggles `--comments` that includes comments in generated code. | |
38 | ||
39 | ###### `output` (String) | |
40 | ||
41 | Sets `--output=<string>` the specifies the output directory, `output` by default. | |
42 | ||
43 | ###### `noPrefix` (Boolean) | |
44 | ||
45 | Toggles `--no-prefix` that does not include the comment header. | |
46 | ||
47 | ###### `ffi` (String Array) | |
48 | ||
49 | Specifies the PureScript FFI files setting `--ffi=<string>`. Glob syntax is supported. This option is specified as `ffi[]=path`. | |
50 | ||
51 | ###### `src` (String Array) | |
52 | ||
53 | Specifies the PureScript source files. Glob syntax is supported. This option is specified as `src[]=path`. | |
54 | ||
55 | ## Example | |
56 | ||
57 | ```js | |
58 | // webpack.config.js | |
59 | ||
60 | var path = require('path'); | |
61 | ||
62 | var srcs = ['src[]=bower_components/purescript-*/src/**/*.purs', 'src[]=src/**/*.purs']; | |
63 | ||
64 | var ffis = ['ffi[]=bower_components/purescript-*/src/**/*.js']; | |
65 | ||
66 | var output = 'output'; | |
67 | ||
68 | var modulesDirectories = [ | |
69 | 'node_modules', | |
70 | // The bower component for purescript-prelude is specified here to | |
71 | // allow JavaScript files to require the 'Prelude' module globally. | |
72 | 'bower_components/purescript-prelude/src' | |
73 | ]; | |
74 | ||
75 | var config | |
76 | = { entry: './src/entry' | |
77 | , output: { path: __dirname | |
78 | , pathinfo: true | |
79 | , filename: 'bundle.js' | |
80 | } | |
81 | , module: { loaders: [ { test: /\.purs$/ | |
82 | , loader: 'purs-loader?output=' + output + '&' + srcs.concat(ffis).join('&') | |
83 | } ] } | |
84 | , resolve: { modulesDirectories: modulesDirectories | |
85 | , extensions: ['', '.js', '.purs'] | |
86 | } | |
87 | , resolveLoader: { root: path.join(__dirname, 'node_modules') } | |
88 | } | |
89 | ; | |
90 | ||
91 | module.exports = config; | |
92 | ``` | |
93 | ||
94 | See the [example](https://github.com/ethul/purs-loader/tree/master/example) directory for a complete example. | |
95 | ||
96 | ## Notes | |
97 | ||
98 | A `.psci` file is generated during each run of the loader. |