bosagora/libsodiumd

Simple D bindings for libsodium

Libsodiumd: D bindings for libsodium

Currently supported version: v1.0.18 (released 2019-05-31)

Those bindings are simple translation from C to D. They are simple, stupid, unnanotated - minimal modification has been applied to make sure any new release does not lead to excessive work.

Usage / Documentation

This wrapper provide a package file, just like #include "sodium.h". Just import libsodium; to get all available symbols.

Some unittests are available in said package file. For a more comprehensive documentation, refer directly to libsodium's doc.

Binding generation

The bindings were generated with the following procedure:

• Install dstep.
• Clone the official repository.
• Checkout the required version
• Translate C headers to D modules:

find "$LIBSODIUM_REPO/src/libsodium/include/sodium" -maxdepth 1 -xtype f -name '*.h' \
    -exec ${DSTEP} --collision-action=ignore --skip randombytes_salsa20_implementation '{}' \; \
    -exec sh -c 'mv $(dirname "$0")/*.d ${LIBSODIUMD_PACKAGE}' {}  \;

With $DSTEP, $LIBSODIUM_REPO and $LIBSODIUMD_PACKAGE being the dstep binary and path to git repositories, respectively.

Then, a few manual adjustment were made:

• mv source/libsodium/export.d source/libsodium/export_.d as it conflicts with a D keyword
• Module documentation, module name, and standard import were added:

for file in $(find source/libsodium -name "*.d")
do
echo "\
/*******************************************************************************

    D language bindings for libsodium's $(basename $file | cut -d'.' -f1).h

    License: ISC (see LICENSE.txt)

*******************************************************************************/

module libsodium.$(basename $file | cut -d'.' -f1);

@nogc nothrow:

import libsodium.export_;
" | cat - $file > $file.tmp && mv $file.tmp $file
done

• Turn ULL constants into UL:

for file in $(find source/libsodium -name "*.d")
do
sed -i '' -e 's/([[:digit:]])ULL/\1UL/g' $file
done

• Try to compile and add missing imports
• Generate source/libsodium/package_.d