HACKING.md

Hacking prettier.el

Build environment

You will need a fairly specific build environment which is helpfully provided by the included Vagrant box. Install Vagrant, then run vagrant up --provider=virtualbox in this directory to initialize the environment. Run the below commands prefixed by ./with-vagrant.

If you would rather not use Vagrant, you can derive instructions for how to set up your local build environment from Vagrantfile; if you do so, please consider sending a PR with instructions.

Building

Initially, and after changes to JS code, you will need to build by running make, then force a restart of the daemon process(es) by running prettier-restart.

Linting and testing

To run the linters locally, follow a similar approach to the CI pipeline defined in .github/workflows/, i.e. first set up a sandbox:

./makem.sh -v --sandbox=sandbox --install-{deps,linters}

and then run the linters:

./makem.sh -v --sandbox=sandbox lint

You can also run all tests:

./makem.sh -v --sandbox=sandbox test

or both linters and tests in one go:

./makem.sh -v --sandbox=sandbox all