dstep 0.1.0+dub

A tool for translating C and Objective-C headers to D modules

To use this package, run the following command in your project's root directory:


DStep is a tool for translating C and Objective-C headers to D modules.


For the latest release see: releases/latest.

Pre-compiled binaries are available for Mac OS X, Linux and FreeBSD. As 32 and 64bit. See the releases section.

Arch packages are available in [community] repository (thanks to Михаил Страшун):



The source code is available under the Boost Software License 1.0




  1. Install all requirements, see below
  2. Clone the repository by running:
    $ git clone --recursive git://github.com/jacob-carlborg/dstep.git
  3. run ./build.sh


$ dstep Foo.h -o Foo.d

For translating Objective-C headers add the -ObjC flag.

$ dstep Foo.h -o Foo.d -ObjC

Use -h for usage information. Any flags recognized by Clang can be used.



This tool requires libclang. Any version that is 3.1 or later and binary compatible with 3.1 should work. Either download the pre-compatible libraries from the LLVM site or use libclang shipping with your system or available from the system package manager.

Some header files will require "stdarg.h" and/or "stddef.h". These are so called builtin includes and are shipped with Clang. They need to be placed in the standard header locations or explicitly referenced with the -I flag. For more information see the Clang FAQ.

Download the pre-compiled libraries here:


Alternatively compile libclang yourself:

$ git clone http://llvm.org/git/llvm.git
$ cd llvm
$ git checkout release_31
$ cd tools
$ git clone http://llvm.org/git/clang.git
$ cd clang
$ git checkout release_31
$ cd ../..
$ ./configure --enable-optimized
$ cp Release+Asserts/lib/libclang.<dylib|so> <path/to/dstep>


$ git clone https://github.com/SiegeLord/Tango-D2
$ cd Tango-D2
$ ./build/script/bob.rb -r dmd -c dmd .
$ cp libtango.a <path/to/dstep>

Limitations/Known issues

  • Doesn't translate preprocessor macros of any kind
  • Doesn't translate #include to import. A few standard C headers are translated
  • Doesn't translate C++ at all
  • Umbrella headers. Some headers just serve to include other headers. If these other headers contain some form of protection, like #error, to be included directly this can cause problems for DStep
  • Some headers are designed to always be included together with other header files. These headers may very well use symbols from other header files without including them itself. Since DStep is designed to convert header files one-by-one this doesn't work. There are two workarounds for this:
    1. Add #include-directives for the header files the header file is actually using
    2. Use the -include <file> flag available in Clang to indicate the given <file> should be processed before the file that should be translated. DStep accepts all flags Clang accepts
  • Jacob Carlborg
1.0.1 2019-Apr-28
1.0.0 2019-Apr-19
0.2.3 2017-Nov-27
0.2.2 2016-Jan-17
0.2.1 2016-Jan-16
Show all 15 versions
Download Stats:
  • 0 downloads today

  • 3 downloads this week

  • 8 downloads this month

  • 793 downloads total

Short URL: