[thorimur]

This PR revamps mk_all to

1. correctly find the source directory and paths from the (already available) lean_libs and rely on more robust Lake API more broadly
2. use a Config internally that accounts for the mathlib-specific exceptions, so that in the future downstream projects could read this from json instead
3. checks that we are not overwriting a file that includes more than just imports, and demands --clobber to do so
4. (misc.) allow multiple libraries/roots to be specified with --lib Foo,Bar,Baz

This also generally refactors the code somewhat to make it more principled and (hopefully) maintainable.

We also change the behavior of API in Mathlib.Util.GetAllModules as appropriate in order to rely on more robust paths.

---

• depends on: [Merged by Bors] - chore: modulize docs #45107

[github-actions]

PR summary 68ac51c9b7

Import changes for modified files

No significant changes to the import graph

Import changes for all files

Files	Import difference

---

Declarations diff (regex)

+ Config
+ Config.mkAllLibs
+ Config.mkAllRoots
+ Root
+ dir
+ fileName
+ findRoot
+ getWorkspace
+ handleRoot
+ lt
+ mathlibConfig
+ mk
+ mkOnlyRoots
+ needsModule
+ ofLeanLib
- getLeanLibs

You can run this locally as follows

## from your `mathlib4` directory:
git clone https://github.com/leanprover-community/mathlib-ci.git ../mathlib-ci

## summary with just the declaration names:
../mathlib-ci/scripts/pr_summary/declarations_diff.sh <optional_commit>

## more verbose report:
../mathlib-ci/scripts/pr_summary/declarations_diff.sh long <optional_commit>

The doc-module for scripts/pr_summary/declarations_diff.sh in the mathlib-ci repository contains some details about this script.

Declarations diff (Lean)

✅ Lean-aware diff — post-build, computed from the Lean environment (commit 68ac51c).

• +0 new declarations
• −0 removed declarations

No declaration differences.

---

No changes to strong technical debt.
No changes to weak technical debt.

Current commit 68ac51c9b7
Reference commit 4dc43842a1

This script lives in the mathlib-ci repository. To run it locally, from your mathlib4 directory:

git clone https://github.com/leanprover-community/mathlib-ci.git ../mathlib-ci
../mathlib-ci/scripts/reporting/technical-debt-metrics.py pr_summary

• The relative value is the weighted sum of the differences with weight given by the inverse of the current value of the statistic.
• The absolute value is the relative value divided by the total sum of the inverses of the current values (i.e. the weighted average of the differences).

[grunweg]

Two small comments. The change to Mathlib/Util/GetAllModules.lean LGTM already.

[grunweg]

This comment is not yet clear to me.

[thorimur]

Specifically the folder path bit? If so, is something like

Assumes that (as with lean_lib roots) the folder from which the given module should import is adjacent to the module, e.g. mathlib4/Mathlib/Tactic.lean imports the modules in mathlib4/Mathlib/Tactic/.

clearer? Or, is the issue the whole thing? (Tentatively changed.)

[mathlib-dependent-issues]

This PR/issue depends on:

• [Merged by Bors] - chore: modulize docs #45107
  By Dependent Issues (🤖). Happy coding!