mirror of
https://github.com/xoseperez/espurna.git
synced 2026-03-14 04:07:08 +01:00
102 lines
2.2 KiB
Markdown
102 lines
2.2 KiB
Markdown
Builder script is using **Gulp**
|
|
|
|
- https://gulpjs.com
|
|
- https://www.npmjs.com/package/gulp
|
|
|
|
Additional tools used
|
|
- [eslint](https://eslint.org) to validate javascript files
|
|
- [html-validate](https://html-validate.org) to validate html file
|
|
- [vitest](https://vitest.dev/) testing framework
|
|
|
|
All commands must be called from `code/`
|
|
```console
|
|
$ pwd
|
|
/home/dev/espurna/code
|
|
```
|
|
|
|
When `gulp` command is not available globally
|
|
```console
|
|
$ ./node_modules/.bin/gulp
|
|
```
|
|
|
|
# Files
|
|
|
|
- `code/espurna/static/` - .html.ipp, used in the firmware code
|
|
- `code/gulpfile.mjs` - builder script entrypoint
|
|
- `code/html/build` - intermediate build results
|
|
- `code/html/spec` - vitest 'spec' files
|
|
- `code/html/src` - source .mjs, .html, etc.
|
|
- `code/node_modules` - build dependencies
|
|
- `code/package{,-lock}.json` - build dependencies metadata
|
|
|
|
# Installation
|
|
|
|
*(recommended)* Install **exact** dependencies listed in the `package-lock.json`, from the time the builder code was last updated
|
|
```console
|
|
$ npm ci
|
|
```
|
|
|
|
*(optional)* Install dependencies listed in the `package.json`, possibly updating packages listed in the `package-lock.json`
|
|
```console
|
|
$ npm install
|
|
```
|
|
|
|
# Building
|
|
|
|
Run tests and build every .html.ipp (`default` task)
|
|
|
|
```console
|
|
$ gulp
|
|
```
|
|
|
|
Build only (does not run tests)
|
|
|
|
```console
|
|
$ gulp webui
|
|
```
|
|
|
|
Build specific flavour (`webui_...` tasks)
|
|
|
|
```console
|
|
$ gulp webui_small
|
|
```
|
|
|
|
List all available tasks
|
|
```console
|
|
$ gulp --tasks
|
|
```
|
|
|
|
# Development
|
|
|
|
Launches development server on port 8080 with the resulting .html bundle. No minification or compression, using `webui_all` as base
|
|
|
|
```console
|
|
$ gulp dev
|
|
```
|
|
|
|
Only the `default` task depends on the test and lint tasks, call them manually
|
|
|
|
```console
|
|
$ gulp test
|
|
```
|
|
```console
|
|
$ gulp eslint html-validate vitest
|
|
```
|
|
```console
|
|
$ gulp eslint
|
|
$ gulp html-validate
|
|
$ gulp vitest
|
|
```
|
|
|
|
Gulp usually does not allow any task arguments, run these tools manually to select specific files or change command line arguments
|
|
|
|
```console
|
|
$ npm exec --no -- eslint gulpfile.mjs html/src/*.mjs html/spec/*.mjs
|
|
```
|
|
```console
|
|
$ npm exec --no -- html-validate html/src/*.html
|
|
```
|
|
```console
|
|
$ npm exec --no -- vitest --environment jsdom --dir html/spec --run
|
|
```
|