Package and build management system for D
D Shell NSIS Other
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github use xml comments in issue template Nov 29, 2017
bin dub will be build into the bin directory, so that when the dub execut… Mar 19, 2013
changelog Merge pull request #1516 from andre2007/fix_issue_1158 Aug 13, 2018
examples Add SDL based example project. Jul 12, 2015
scripts Add build type syntax Jul 12, 2018
source update version to v1.11.0-beta.1 Aug 16, 2018
test Merge pull request #1516 from andre2007/fix_issue_1158 Aug 13, 2018
.codecov.yml Force CodeCov to be informational only Jul 7, 2018
.editorconfig add .editorconfig Aug 9, 2014
.gitignore Ability to run a single test + output overview log May 8, 2018
.travis.yml Merge pull request #1520 from wilzbach/semaphore-gdc Aug 7, 2018
ARCHITECTURE.md some basic information on the architecture Dec 20, 2017
CHANGELOG.md link to dub changelog on dlang.org Jun 28, 2018
CONTRIBUTING.md generate dlang.org changelog from fragments (tools/changed) May 1, 2018
Jenkinsfile load ci repo as shared jenkins library Oct 6, 2017
LICENSE Add a MIT License file that can be detected by GitHub Mar 26, 2018
README.md spelling fixes Apr 11, 2017
appveyor.yml Test stable branch on AppVeyor. Mar 13, 2018
architecture.graphmlz some basic information on the architecture Dec 20, 2017
architecture.png some basic information on the architecture Dec 20, 2017
build-files.txt Split-up package suppliers into individual modules May 8, 2018
build-gdc.sh Add support for DragonFlyBSD Jan 14, 2018
build.cmd The default compiler should not depend on DUB's own build environment Sep 12, 2015
build.sh Use -flto=full for the release builds Apr 6, 2018
curl.lib Added files necessary to build on Windows. Feb 22, 2013
dub.sdl Update author list based on amount of contributions. May 16, 2018
dub.selections.json Bump stdx-allocator version to 2.77.2 Jul 5, 2018
release.sh Use -flto=full for the release builds Apr 6, 2018
semaphore-ci.sh Use GDC from Semaphore and upgrade the minimally required host compiler Jul 29, 2018
travis-ci.sh Merge remote-tracking branch 'upstream/stable' into merge_stable Feb 1, 2018

README.md

dub package manager

Package and build manager for D applications and libraries.

There is a central package registry located at http://code.dlang.org.

GitHub tag Build Status Coverage Status

Introduction

DUB emerged as a more general replacement for vibe.d's package manager. It does not imply a dependency to vibe.d for packages and was extended to not only directly build projects, but also to generate project files (currently VisualD). Mono-D also supports the use of dub.json (dub's package description) as the project file.

The project's philosophy is to keep things as simple as possible. All that is needed to make a project a dub package is to write a short dub.json file and put the source code into a source subfolder. It can then be registered on the public package registry to be made available for everyone. Any dependencies specified in dub.json are automatically downloaded and made available to the project during the build process.

Key features

  • Simple package and build description not getting in your way
  • Integrated with Git, avoiding maintenance tasks such as incrementing version numbers or uploading new project releases
  • Generates VisualD project/solution files, integrated into MonoD
  • Support for DMD, GDC and LDC (common DMD flags are translated automatically)
  • Supports development workflows by optionally using local directories as a package source

Future direction

To make things as flexible as they need to be for certain projects, it is planned to gradually add more options to the package file format and eventually to add the possibility to specify an external build tool along with the path of it's output files. The idea is that DUB provides a convenient build management that suffices for 99% of projects, but is also usable as a bare package manager that doesn't get in your way if needed.

Installation

DUB comes precompiled for Windows, OS X and Linux. It needs to have libcurl with SSL support installed (except on Windows).

The dub executable then just needs to be accessible from PATH and can be invoked from the root folder of any DUB enabled project to build and run it.

If you want to build for yourself, just install DMD and libcurl development headers and run ./build.sh. On Windows you can simply run build.cmd without installing anything besides DMD.

Arch Linux

Михаил Страшун (Dicebot) maintains a dub package of the latest release in Community, for x86_64 and i686. Moritz Maxeiner has created a PKGBUILD file for GIT master: https://aur.archlinux.org/packages/dub-git/

Debian/Ubuntu Linux

Jordi Sayol maintains a DEB package as part of his D APT repository. Run sudo apt-get install dub to install.

OS X

Chris Molozian has added DUB to Homebrew. Use brew install dub to install the stable version, optionally adding --HEAD/--devel to install the latest git master or development release respectively.

There is also a MacPorts package available. Type sudo port install dub to install the latest stable version.

Windows

Daniel Jost maintains a dub package on chocolatey. Use cinst dub or cinst dub -version #.#.# to install stable or a custom version respectively.

Using DUB as a library

The DUB package of DUB can be used as a library to load or manipulate packages, or to resemble any functionality of the command line tool. The former task can be achieved by using the Package class. For examples on how to replicate the command line functionality, see commandline.d.