Repository files navigation

Package and build manager forD applications and libraries.

There is a centralpackage registry located athttp://code.dlang.org.

DUB emerged as a more general replacement forvibe.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 (currentlyVisualD).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 shortdub.json file and put the source code into asource subfolder. Itcan then be registered on the publicpackage registry to be made available for everyone. Any dependencies specified indub.json are automatically downloaded and made available to the project during the build process.

• 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

To make things as flexible as they need to be for certain projects, it is planned to gradually add more options to thepackage 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.

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

Thedub executable then just needs to be accessible fromPATH 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 a D compiler such asDMD and libcurl development headers and run./build.d.

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

Jordi Sayol maintains a DEB package as part of hisD APT repository. Runsudo apt-get install dub to install.

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

There is also aMacPorts package available. Typesudo port install dub to install the latest stable version.

Daniel Jost maintains a dub package onchocolatey. Usecinst dub orcinst dub -version #.#.# to install stable or a custom version respectively.

Mathias (@Geod24) Lang maintains the Alpine Linux packages.It is currently part of 'edge' and can be installed throughapk --no-cache add -X http://dl-cdn.alpinelinux.org/alpine/edge/testing dub.

The port for DUB resides indevel/dub. The compiled package can be installed withpkg install dub.

Brian Callahan (bcallah@) maintains the OpenBSD package. Usepkg_add dub to install it.

TheDUB 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 thePackage class. For examples on how to replicate the command line functionality, seecommandline.d.

In general it is always recommended to build DUB with the latest version of your D compiler.However, currently2.076 is required to build DUB from source.

New contributers are always welcome, there's plenty to work on! For an easy start, take a look at issues markedbootcampThe contributing guidelines can be foundhere