- It's recommended to use Java 8, the project has not been tested with Java 11.
- The project is built with
sbt, to install sbt see https://www.scala-sbt.org/
sbt tests/testinstead of
sbt test, the former runs modestly fast unit tests for the JVM while
sbt testis slower because it runs cross-platform test for Scala.js, tests benchmark code and also compiles the documentation.
- You should be able to import the project into IntelliJ as normal:
File -> New -> Project from existing sourceand pick the
Opening pull requests
- All code PRs should come with: a meaningful description, inline-comments for important things, unit tests (positive and negative), and a green build in CI.
- Format your code with scalafmt. Run
./scalafmtfrom the project root directory.
- PRs for features should generally come with something added to the
Documentation, so people can discover
that it exists. The docs are written in
- Be prepared to discuss/argue-for your changes if you want them merged! You will probably need to refactor so your changes fit into the larger codebase - If your code is hard to unit test, and you don't want to unit test it, that's ok. But be prepared to argue why that's the case!
- It's entirely possible your changes won't be merged, or will get ripped out later. This is also the case for my changes, as the Author!
- Even a rejected/reverted PR is valuable! It helps explore the solution space, and know what works and what doesn't. For every line in the repo, at least three lines were tried, committed, and reverted/refactored, and more than 10 were tried without committing.
- Feel free to send Proof-Of-Concept PRs that you don't intend to get merged.
Please always include concrete code examples with obtained and expected output.
- Try to keep complex logic out of Router.scala, instead move it into a utility
Where do utility functions go?
FormatOps: anything that requires access to fields in
prev/next/owners), which is custom for each source file.
Token/TreeOps: anything that does not require fields in
FormatOps, agnostic to the source file being formatted.
Token/TreeClasses: groups of trees/tokens that belong together and support the