tl;dr Cache your code-gen results with the codegenrs crate.

Lately, there has been talk talk about improving build times, with a focus on reducing bloat like regex breaking out logic into features that can be disabled, cargo-bloat going on a diet, new cargo features to identify slow-to-build dependencies. The area that has been impacting me lately is I've been code-generating compile-time hash tables (phf) which has added several dependencies to my build and takes a while.

Let's use imperative as an example. imperative is a simple way to check a word is in the imperative-mood. The logic was taken from pydocstyle where it was used to ensure the subject-line for a doc-comment should start with an imperative-mood verb.

imperative uses:

And relies on the following unique dependencies:

What if instead of code-generating in as part of imperative and all dependents' builds, we checked in the result? The main risks are:

We can mitigate these risks by having the CI run a --check mode in the code-generator that ensures the output matches what should be generated.

To setup imperative-codegen:

Now let's look at some very unscientific numbers for clean builds of imperative (a lib crate):

imperativecargo checkcargo build
build.rs39.94 s35.65 s
codegenrs22.55 s26.06 s

Note that this technique might also help make crates work better with alternative build systems.