Add more autoprecompilation controls and Pkg.precompile() do to delay precompilation until after operations.

[IanButterworth]

i.e. with this it will precompile the env at the end of this, not after every step

Pkg.precompile() do
    Pkg.instantiate()
    Pkg.rm("Foo")
    Pkg.add("Bar")
    Pkg.dev("Baz")
end

Also a non-scoped version:

Pkg.autoprecompilation_enabled(false)
...
Pkg.autoprecompilation_enabled(true)

TODO:

• Add to docs
• Add tests

[IanButterworth]

@KristofferC what do you think about this?

[IanButterworth]

Bump @KristofferC

[KristofferC]

Probably makes sense to have, yes.

[Copilot]

Pull Request Overview

Adds scoped and global controls for automatic package precompilation by introducing a Pkg.precompile() do ... end block to defer compilation and a Pkg.autoprecompilation_enabled(state::Bool) API to toggle auto-precompilation.

• Introduce Pkg.precompile() do ... end syntax that disables auto-precompilation inside the block and runs a single compile at the end.
• Add Pkg.autoprecompilation_enabled(state::Bool) for session-wide enable/disable of automatic precompilation.
• Update tests, documentation, and the changelog to reflect the new features.

Reviewed Changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
test/api.jl	Add tests covering the do-block precompile behavior and global toggle
src/Pkg.jl	Implement global/scoped flags, extend should_autoprecompile, add docstrings
src/API.jl	Define the precompile(f, args...; kwargs...) method for do-block syntax
docs/src/environments.md	Document both environment-variable, programmatic, and scoped controls
docs/src/api.md	Add Pkg.autoprecompilation_enabled to the API index
CHANGELOG.md	Record the new block syntax and global toggle additions

Comments suppressed due to low confidence (2)

docs/src/environments.md:207

• Clarify this bullet to highlight the do-block syntax users will write (e.g. Pkg.precompile() do ... end) rather than referring to the internal function signature.

- **Scoped control**: Use `Pkg.precompile(f, args...; kwargs...)` to execute a function `f` with auto-precompilation temporarily disabled, then automatically trigger precompilation afterward if any packages were modified during the execution.

src/Pkg.jl:228

• [nitpick] This sentence is a fragment; consider rephrasing to To delay auto-precompilation until after a batch of Pkg actions, use the do-block syntax: for clarity.

To delay autoprecompilation of multiple Pkg actions until the end use.