Digger can:
- build D from git
- build older versions of D
- build D plus forks and pending pull requests
- bisect D's history to find where regressions are introduced (or bugs fixed)
Digger has a simple command-line interface, as well as a web interface for customizing your custom D build.
On POSIX, Digger needs git, g++, binutils and make.
On Windows, Digger will download and unpack everything it needs (Git, DMC, DMD, 7-Zip, WiX, VS2013 and Windows SDK components).
You can find binaries on the GitHub releases page.
# build latest master branch commit
$ digger build
# build a specific D version
$ digger build v2.064.2
# build for x86-64
$ digger build --model=64 v2.064.2
# build commit from a point in time
$ digger build "@ 3 weeks ago"
# build latest 2.065 (release) branch commit
$ digger build 2.065
# build specified branch from a point in time
$ digger build "2.065 @ 3 weeks ago"
# build with added pull request
$ digger build "master + dmd#123"
# build with added GitHub fork branch
$ digger build "master + Username/dmd/awesome-feature"
# perform incremental build (after changing a few source files)
$ digger rebuild
Run digger
with no arguments for detailed usage help.
Digger does not build all D components - only those that change frequently and depend on one another. You can get a full package by upgrading an installation of a stable DMD release with Digger's build result:
# upgrade the DMD in your PATH with Digger's result
$ digger install
You can undo this at any time by running:
$ digger uninstall
Successive installs will not clobber the backups created by the first digger install
invocation,
so digger uninstall
will revert to the state from before you first ran digger install
.
You can also simultaneously install 32-bit and 64-bit versions of Phobos by first building and installing a 32-bit DMD,
then a 64-bit DMD (--model=64
). digger uninstall
will revert both actions.
To upgrade a system install of DMD on POSIX, simply run digger install
as root, e.g. sudo digger install
.
digger install
should be compatible with DVM or any other DMD installation.
Installation and uninstallation are designed with safety in mind.
When installing, Digger will provide detailed information and ask for confirmation before making any changes
(you can use the --dry-run
/ --yes
switches to suppress the prompt).
Uninstallation will refuse to remove files if they were modified since they were installed,
to prevent accidentally clobbering user work (you can use --force
to override this).
To bisect D's history to find which pull request introduced a bug, first copy bisect.ini.sample
to bisect.ini
, adjust as instructed by the comments, then run:
$ digger bisect path/to/bisect.ini
Run digger-web
to start the web interface, which allows interactively customizing a D version to build.
If you built digger-web
from source, you also need to build digger
itself.
You can optionally configure a few settings using a configuration file.
To do so, copy digger.ini.sample
to digger.ini
and adjust as instructed by the comments.
$ git clone --recursive https://github.com/CyberShadow/Digger
$ cd Digger
$ rdmd --build-only digger
$ rdmd --build-only digger-web
On Windows, you may see:
Warning 2: File Not Found version.lib
This is a benign warning.
The code which builds D and manages the git repository is located in the ae library
(ae.sys.d
package), so as to be reusable.
Currently, the bulk of the code is in ae.sys.d.manager
.
ae.sys.d.manager
clones a meta-repository on BitBucket, which contains the major D components as submodules.
The meta-repository is created and maintained by another program, D-dot-git.
The build requirements are fulfilled by the ae.sys.install
package.
Digger is the frontend to the above library code, implementing configuration, bisecting, etc.
Module list is as follows:
config
- configurationrepo
- customized D repository management, revision parsingbisect
- history bisectioncustom
- custom build managementinstall
- installationdigger
- entry point and command-line UIdigger-web
- web interface, works by launchingdigger
sub-processescommon
- helpers shared bydigger
anddigger-web