Clear up two deprecations triggering in unittest ...

Those are trivially fixed by using the new way of doing things.

Introduce readText and make stripUTF8BOM private

Fix #2840: Build collision for single-package and FILE_FULL_PATH ...

By including the package path in the buildid we avoid the problem,
at the expense of not sharing the cache for packages that could be
shared, but we would need to know if the code depends on __FILE__
and __FILE_FULL_PATH__ or not.

Deprecate Project.packageManager ...

There is no reason to expose the PackageManager through the Project.
In fact, the only two places it was used were in generators,
where the PackageManager was stored but never used.
The generators arguably should not have access to the PackageManager,
as all the Packages should have been loaded and handled to them
before the generation starts.

Remove unused iterateDirectory(string) ...

It was actually unused, because al the call sites were doing a useless
round-trip from NativePath to string to NativePath.
There is no need for it anymore so we can just remove it to avoid
this kind of mistakes in the future.

add "cacheArtifactPath" in TargetDescription ...

Allow 3rd party programs (e.g. Meson) to locate artifacts in the cache

reorder statements for code clarity ...

make it clear what part of the code is used for recursive build

add --deep flag to `dub build` ...

Allows to build all dependencies of a static library

Implemented recipe files for dub #2684 (#2685) ...

Co-authored-by: Jan Jurzitza <gh@webfreak.org>

dub.generators.generator: Don't create targetPath dir with --temp-build

checking for duplicates in reverse order ...

cache hits are more likely in the most recent builds

change db filename to "db.json"

add "version" to the cache database

avoid duplicates in cache DB

write cache database Json file

stabilize the cache directory structure

Revert "Make all static library exports contribute to dlls on Windows" ...

This reverts commit 076022c / PR2614.

Make all static library exports contribute to dlls on Windows

Add unittest to test collection of C sources and headers

Make getDUBExePath returns a NativePath

make build names much smaller (#2589)

fix typo(s)

Merge remote-tracking branch 'upstream/stable' into merge_stable

reduce dependency on the working directory ...

Improves library API usage and bugs with the build generator

Don't assume the cache path is relative to CWD ...

It is no longer in `$PACKAGE_ROOT/.dub`, but in a central location.

Remove GeneratorSettings.direct as it is never set

Use a central build cache for all build artifacts ...

Currently the central build cache is not configurable,
but as most build artifacts end up in `~/.dub/packages/` anyway,
this will be a positive change for users.

Move computeBuildID outside of BuildGenerator ...

It does not use anything from 'this', only its input parameters.
Additionally, change the order so it is usable with UFCS.

Replace all instances of mkdirRecurse with ensureDir ...

All usages actually want to ensure the directory is present,
and don't care about having a separation between existence check
and creation.

Unify reading and writing files under a single API ...

This removes the range API and instead uses Appender,
while using a limited and centralized set of functions
to read/write from files.
The end goal is to permit dependency injection,
which is a pre-requisite to extending the test-suite.