rbnacl-libsodium 1.0.11 → 1.0.13

data/vendor/libsodium/m4/ax_valgrind_check.m4

@@ -1,22 +1,27 @@
 # ===========================================================================
-#     http://www.gnu.org/software/autoconf-archive/ax_valgrind_check.html
+#    https://www.gnu.org/software/autoconf-archive/ax_valgrind_check.html
 # ===========================================================================
 #
 # SYNOPSIS
 #
+#   AX_VALGRIND_DFLT(memcheck|helgrind|drd|sgcheck, on|off)
 #   AX_VALGRIND_CHECK()
 #
 # DESCRIPTION
 #
-#   Checks whether Valgrind is present and, if so, allows running `make
-#   check` under a variety of Valgrind tools to check for memory and
-#   threading errors.
+#   AX_VALGRIND_CHECK checks whether Valgrind is present and, if so, allows
+#   running `make check` under a variety of Valgrind tools to check for
+#   memory and threading errors.
 #
 #   Defines VALGRIND_CHECK_RULES which should be substituted in your
 #   Makefile; and $enable_valgrind which can be used in subsequent configure
 #   output. VALGRIND_ENABLED is defined and substituted, and corresponds to
 #   the value of the --enable-valgrind option, which defaults to being
-#   enabled if Valgrind is installed and disabled otherwise.
+#   enabled if Valgrind is installed and disabled otherwise. Individual
+#   Valgrind tools can be disabled via --disable-valgrind-<tool>, the
+#   default is configurable via the AX_VALGRIND_DFLT command or is to use
+#   all commands not disabled via AX_VALGRIND_DFLT. All AX_VALGRIND_DFLT
+#   calls must be made before the call to AX_VALGRIND_CHECK.
 #
 #   If unit tests are written using a shell script and automake's
 #   LOG_COMPILER system, the $(VALGRIND) variable can be used within the
@@ -28,6 +33,7 @@
 #
 #   configure.ac:
 #
+#     AX_VALGRIND_DFLT([sgcheck], [off])
 #     AX_VALGRIND_CHECK
 #
 #   Makefile.am:
@@ -40,9 +46,15 @@
 #   which includes "@VALGRIND_CHECK_RULES@" (assuming the module has been
 #   configured with --enable-valgrind). Running `make check-valgrind` in
 #   that directory will run the module's test suite (`make check`) once for
-#   each of the available Valgrind tools (out of memcheck, helgrind, drd and
-#   sgcheck), and will output results to test-suite-$toolname.log for each.
-#   The target will succeed if there are zero errors and fail otherwise.
+#   each of the available Valgrind tools (out of memcheck, helgrind and drd)
+#   while the sgcheck will be skipped unless enabled again on the
+#   commandline with --enable-valgrind-sgcheck. The results for each check
+#   will be output to test-suite-$toolname.log. The target will succeed if
+#   there are zero errors and fail otherwise.
+#
+#   Alternatively, a "check-valgrind-$TOOL" rule will be added, for $TOOL in
+#   memcheck, helgrind, drd and sgcheck. These are useful because often only
+#   some of those tools can be ran cleanly on a codebase.
 #
 #   The macro supports running with and without libtool.
 #
@@ -55,13 +67,23 @@
 #   and this notice are preserved.  This file is offered as-is, without any
 #   warranty.
 
-#serial 8
+#serial 15
+
+dnl Configured tools
+m4_define([valgrind_tool_list], [[memcheck], [helgrind], [drd], [sgcheck]])
+m4_set_add_all([valgrind_exp_tool_set], [sgcheck])
+m4_foreach([vgtool], [valgrind_tool_list],
+           [m4_define([en_dflt_valgrind_]vgtool, [on])])
+
+AC_DEFUN([AX_VALGRIND_DFLT],[
+	m4_define([en_dflt_valgrind_$1], [$2])
+])dnl
 
 AC_DEFUN([AX_VALGRIND_CHECK],[
 	dnl Check for --enable-valgrind
 	AC_ARG_ENABLE([valgrind],
-	              [AS_HELP_STRING([--enable-valgrind], [Whether to enable Valgrind on the unit tests (requires GNU make)])],
-	              [enable_valgrind=$enableval],[enable_valgrind=no])
+				  [AS_HELP_STRING([--enable-valgrind], [Whether to enable Valgrind on the unit tests (requires GNU make)])],
+				  [enable_valgrind=$enableval],[enable_valgrind=no])
 
 	AS_IF([test "$enable_valgrind" != "no"],[
 		# Check for Valgrind.
@@ -81,22 +103,45 @@ AC_DEFUN([AX_VALGRIND_CHECK],[
 	AC_SUBST([VALGRIND_ENABLED],[$enable_valgrind])
 
 	# Check for Valgrind tools we care about.
-	m4_define([valgrind_tool_list],[[memcheck], [helgrind], [drd], [exp-sgcheck]])
-
-	AS_IF([test "$VALGRIND" != ""],[
-		m4_foreach([vgtool],[valgrind_tool_list],[
-			m4_define([vgtooln],AS_TR_SH(vgtool))
-			m4_define([ax_cv_var],[ax_cv_valgrind_tool_]vgtooln)
-			AC_CACHE_CHECK([for Valgrind tool ]vgtool,ax_cv_var,[
-				ax_cv_var=
-				AS_IF([`$VALGRIND --tool=vgtool --help >/dev/null 2>&1`],[
-					ax_cv_var="vgtool"
+	[valgrind_enabled_tools=]
+	m4_foreach([vgtool],[valgrind_tool_list],[
+		AC_ARG_ENABLE([valgrind-]vgtool,
+		    m4_if(m4_defn([en_dflt_valgrind_]vgtool),[off],dnl
+[AS_HELP_STRING([--enable-valgrind-]vgtool, [Whether to use ]vgtool[ during the Valgrind tests])],dnl
+[AS_HELP_STRING([--disable-valgrind-]vgtool, [Whether to skip ]vgtool[ during the Valgrind tests])]),
+		              [enable_valgrind_]vgtool[=$enableval],
+		              [enable_valgrind_]vgtool[=])
+		AS_IF([test "$enable_valgrind" = "no"],[
+			enable_valgrind_]vgtool[=no],
+		      [test "$enable_valgrind_]vgtool[" ]dnl
+m4_if(m4_defn([en_dflt_valgrind_]vgtool), [off], [= "yes"], [!= "no"]),[
+			AC_CACHE_CHECK([for Valgrind tool ]vgtool,
+			               [ax_cv_valgrind_tool_]vgtool,[
+				ax_cv_valgrind_tool_]vgtool[=no
+				m4_set_contains([valgrind_exp_tool_set],vgtool,
+				    [m4_define([vgtoolx],[exp-]vgtool)],
+				    [m4_define([vgtoolx],vgtool)])
+				AS_IF([`$VALGRIND --tool=]vgtoolx[ --help >/dev/null 2>&1`],[
+					ax_cv_valgrind_tool_]vgtool[=yes
 				])
 			])
-
-			AC_SUBST([VALGRIND_HAVE_TOOL_]vgtooln,[$ax_cv_var])
+			AS_IF([test "$ax_cv_valgrind_tool_]vgtool[" = "no"],[
+				AS_IF([test "$enable_valgrind_]vgtool[" = "yes"],[
+					AC_MSG_ERROR([Valgrind does not support ]vgtool[; reconfigure with --disable-valgrind-]vgtool)
+				],[
+					enable_valgrind_]vgtool[=no
+				])
+			],[
+				enable_valgrind_]vgtool[=yes
+			])
 		])
+		AS_IF([test "$enable_valgrind_]vgtool[" = "yes"],[
+			valgrind_enabled_tools="$valgrind_enabled_tools ]m4_bpatsubst(vgtool,[^exp-])["
+		])
+		AC_SUBST([ENABLE_VALGRIND_]vgtool,[$enable_valgrind_]vgtool)
 	])
+	AC_SUBST([valgrind_tools],["]m4_join([ ], valgrind_tool_list)["])
+	AC_SUBST([valgrind_enabled_tools],[$valgrind_enabled_tools])
 
 [VALGRIND_CHECK_RULES='
 # Valgrind check
@@ -118,7 +163,6 @@ VALGRIND_drd_FLAGS ?=
 VALGRIND_sgcheck_FLAGS ?=
 
 # Internal use
-valgrind_tools = memcheck helgrind drd sgcheck
 valgrind_log_files = $(addprefix test-suite-,$(addsuffix .log,$(valgrind_tools)))
 
 valgrind_memcheck_flags = --tool=memcheck $(VALGRIND_memcheck_FLAGS)
@@ -129,6 +173,9 @@ valgrind_sgcheck_flags = --tool=exp-sgcheck $(VALGRIND_sgcheck_FLAGS)
 valgrind_quiet = $(valgrind_quiet_$(V))
 valgrind_quiet_ = $(valgrind_quiet_$(AM_DEFAULT_VERBOSITY))
 valgrind_quiet_0 = --quiet
+valgrind_v_use   = $(valgrind_v_use_$(V))
+valgrind_v_use_  = $(valgrind_v_use_$(AM_DEFAULT_VERBOSITY))
+valgrind_v_use_0 = @echo "  USE   " $(patsubst check-valgrind-%,%,$''@):;
 
 # Support running with and without libtool.
 ifneq ($(LIBTOOL),)
@@ -140,13 +187,10 @@ endif
 # Use recursive makes in order to ignore errors during check
 check-valgrind:
 ifeq ($(VALGRIND_ENABLED),yes)
-	-$(foreach tool,$(valgrind_tools), \
-		$(if $(VALGRIND_HAVE_TOOL_$(tool))$(VALGRIND_HAVE_TOOL_exp_$(tool)), \
-			$(MAKE) $(AM_MAKEFLAGS) -k check-valgrind-tool VALGRIND_TOOL=$(tool); \
-		) \
-	)
+	$(A''M_V_at)$(MAKE) $(AM_MAKEFLAGS) -k \
+		$(foreach tool, $(valgrind_enabled_tools), check-valgrind-$(tool))
 else
-	@echo "Need to reconfigure with --enable-valgrind"
+	@echo "Need to use GNU make and reconfigure with --enable-valgrind"
 endif
 
 # Valgrind running
@@ -160,16 +204,22 @@ VALGRIND_LOG_COMPILER = \
 	$(valgrind_lt) \
 	$(VALGRIND) $(VALGRIND_SUPPRESSIONS) --error-exitcode=1 $(VALGRIND_FLAGS)
 
-check-valgrind-tool:
-ifeq ($(VALGRIND_ENABLED),yes)
-	$(MAKE) check-TESTS \
-		TESTS_ENVIRONMENT="$(VALGRIND_TESTS_ENVIRONMENT)" \
-		LOG_COMPILER="$(VALGRIND_LOG_COMPILER)" \
-		LOG_FLAGS="$(valgrind_$(VALGRIND_TOOL)_flags)" \
-		TEST_SUITE_LOG=test-suite-$(VALGRIND_TOOL).log
+define valgrind_tool_rule =
+check-valgrind-$(1):
+ifeq ($$(VALGRIND_ENABLED)-$$(ENABLE_VALGRIND_$(1)),yes-yes)
+	$$(valgrind_v_use)$$(MAKE) check-TESTS \
+		TESTS_ENVIRONMENT="$$(VALGRIND_TESTS_ENVIRONMENT)" \
+		LOG_COMPILER="$$(VALGRIND_LOG_COMPILER)" \
+		LOG_FLAGS="$$(valgrind_$(1)_flags)" \
+		TEST_SUITE_LOG=test-suite-$(1).log
+else ifeq ($$(VALGRIND_ENABLED),yes)
+	@echo "Need to reconfigure with --enable-valgrind-$(1)"
 else
 	@echo "Need to reconfigure with --enable-valgrind"
 endif
+endef
+
+$(foreach tool,$(valgrind_tools),$(eval $(call valgrind_tool_rule,$(tool))))
 
 A''M_DISTCHECK_CONFIGURE_FLAGS ?=
 A''M_DISTCHECK_CONFIGURE_FLAGS += --disable-valgrind
@@ -177,14 +227,15 @@ A''M_DISTCHECK_CONFIGURE_FLAGS += --disable-valgrind
 MOSTLYCLEANFILES ?=
 MOSTLYCLEANFILES += $(valgrind_log_files)
 
-.PHONY: check-valgrind check-valgrind-tool
+.PHONY: check-valgrind $(add-prefix check-valgrind-,$(valgrind_tools))
 ']
 
-	AS_IF([test "$enable_valgrind" != "yes"],[
-VALGRIND_CHECK_RULES='
+	AS_IF([test "$enable_valgrind" != "yes"], [
+		VALGRIND_CHECK_RULES='
 check-valgrind:
 	@echo "Need to use GNU make and reconfigure with --enable-valgrind"'
-])
+	])
+
 	AC_SUBST([VALGRIND_CHECK_RULES])
 	m4_ifdef([_AM_SUBST_NOTMAKE], [_AM_SUBST_NOTMAKE([VALGRIND_CHECK_RULES])])
 ])

data/vendor/libsodium/m4/pkg.m4

@@ -53,7 +53,7 @@ fi[]dnl
 # to PKG_CHECK_MODULES(), but does not set variables or print errors.
 #
 # Please remember that m4 expands AC_REQUIRE([PKG_PROG_PKG_CONFIG])
-# only at the first occurence in configure.ac, so if the first place
+# only at the first occurrence in configure.ac, so if the first place
 # it's called might be skipped (such as if it is within an "if", you
 # have to call PKG_CHECK_EXISTS manually
 # --------------------------------------------------------------

data/vendor/libsodium/msvc-scripts/Makefile.in

@@ -1,7 +1,7 @@
-# Makefile.in generated by automake 1.15 from Makefile.am.
+# Makefile.in generated by automake 1.15.1 from Makefile.am.
 # @configure_input@
 
-# Copyright (C) 1994-2014 Free Software Foundation, Inc.
+# Copyright (C) 1994-2017 Free Software Foundation, Inc.
 
 # This Makefile.in is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -89,7 +89,8 @@ build_triplet = @build@
 host_triplet = @host@
 subdir = msvc-scripts
 ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
-am__aclocal_m4_deps = $(top_srcdir)/m4/ax_check_compile_flag.m4 \
+am__aclocal_m4_deps = $(top_srcdir)/m4/ax_check_catchable_segv.m4 \
+	$(top_srcdir)/m4/ax_check_compile_flag.m4 \
 	$(top_srcdir)/m4/ax_check_define.m4 \
 	$(top_srcdir)/m4/ax_check_link_flag.m4 \
 	$(top_srcdir)/m4/ax_pthread.m4 \
@@ -164,6 +165,10 @@ ECHO_C = @ECHO_C@
 ECHO_N = @ECHO_N@
 ECHO_T = @ECHO_T@
 EGREP = @EGREP@
+ENABLE_VALGRIND_drd = @ENABLE_VALGRIND_drd@
+ENABLE_VALGRIND_helgrind = @ENABLE_VALGRIND_helgrind@
+ENABLE_VALGRIND_memcheck = @ENABLE_VALGRIND_memcheck@
+ENABLE_VALGRIND_sgcheck = @ENABLE_VALGRIND_sgcheck@
 EXEEXT = @EXEEXT@
 FGREP = @FGREP@
 GREP = @GREP@
@@ -214,6 +219,7 @@ SAFECODE_HOME = @SAFECODE_HOME@
 SED = @SED@
 SET_MAKE = @SET_MAKE@
 SHELL = @SHELL@
+SODIUM_LIBRARY_MINIMAL_DEF = @SODIUM_LIBRARY_MINIMAL_DEF@
 SODIUM_LIBRARY_VERSION = @SODIUM_LIBRARY_VERSION@
 SODIUM_LIBRARY_VERSION_MAJOR = @SODIUM_LIBRARY_VERSION_MAJOR@
 SODIUM_LIBRARY_VERSION_MINOR = @SODIUM_LIBRARY_VERSION_MINOR@
@@ -221,10 +227,6 @@ STRIP = @STRIP@
 TEST_LDFLAGS = @TEST_LDFLAGS@
 VALGRIND = @VALGRIND@
 VALGRIND_ENABLED = @VALGRIND_ENABLED@
-VALGRIND_HAVE_TOOL_drd = @VALGRIND_HAVE_TOOL_drd@
-VALGRIND_HAVE_TOOL_exp_sgcheck = @VALGRIND_HAVE_TOOL_exp_sgcheck@
-VALGRIND_HAVE_TOOL_helgrind = @VALGRIND_HAVE_TOOL_helgrind@
-VALGRIND_HAVE_TOOL_memcheck = @VALGRIND_HAVE_TOOL_memcheck@
 VERSION = @VERSION@
 abs_builddir = @abs_builddir@
 abs_srcdir = @abs_srcdir@
@@ -279,6 +281,8 @@ target_alias = @target_alias@
 top_build_prefix = @top_build_prefix@
 top_builddir = @top_builddir@
 top_srcdir = @top_srcdir@
+valgrind_enabled_tools = @valgrind_enabled_tools@
+valgrind_tools = @valgrind_tools@
 EXTRA_DIST = \
 	process.bat \
 	rep.vbs \

data/vendor/libsodium/msvc-scripts/process.bat

@@ -1,4 +1,5 @@
-cscript msvc-scripts/rep.vbs //Nologo s/@VERSION@/1.0.11/ < src\libsodium\include\sodium\version.h.in > tmp
+cscript msvc-scripts/rep.vbs //Nologo s/@VERSION@/1.0.13/ < src\libsodium\include\sodium\version.h.in > tmp
 cscript msvc-scripts/rep.vbs //Nologo s/@SODIUM_LIBRARY_VERSION_MAJOR@/9/ < tmp > tmp2
-cscript msvc-scripts/rep.vbs //Nologo s/@SODIUM_LIBRARY_VERSION_MINOR@/3/ < tmp2 > src\libsodium\include\sodium\version.h
-del tmp tmp2
+cscript msvc-scripts/rep.vbs //Nologo s/@SODIUM_LIBRARY_VERSION_MINOR@/5/ < tmp2 > tmp3
+cscript msvc-scripts/rep.vbs //Nologo s/@SODIUM_LIBRARY_MINIMAL_DEF@// < tmp3 > src\libsodium\include\sodium\version.h
+del tmp tmp2 tmp3

data/vendor/libsodium/packaging/dotnet-core/README.md

@@ -0,0 +1,59 @@
+This directory contains scripts and files to package libsodium for .NET Core.
+
+*Note:* The NuGet package is intended for the implementation of language
+bindings such as [NSec](https://github.com/ektrah/nsec). It does not provide a
+.NET API itself.
+
+In .NET Core, it is customary to provide pre-compiled binaries for all platforms
+as NuGet packages. The purpose of the `prepare.py` script in this directory is
+to generate a `Makefile` that downloads and builds libsodium binaries for a
+number of platforms and assembles them in a NuGet package that can be uploaded
+to [nuget.org](https://nuget.org/).
+
+* For Windows, binaries are obtained from
+  [download.libsodium.org](https://download.libsodium.org/libsodium/releases/).
+* For macOS, binaries are extracted from the
+  [Homebrew libsodium bottle](https://bintray.com/homebrew/bottles/libsodium).
+* For Linux, libsodium is compiled in Docker containers.
+
+See `prepare.py` for the complete list of supported platforms.
+
+The metadata for the NuGet package is located in `libsodium.props`.
+
+
+**Versioning**
+
+Version numbers for the packages for .NET Core consist of three components:
+
+* *libsodium version*  
+  The libsodium version is in the format `X.Y.Z`.
+* *package revision*  
+  It may be necessary to release more than one package for a libsodium version,
+  e.g., when adding support for a new platform or if a release contains a broken
+  binary. In this case, a package revision number is added as a fourth part to
+  the libsodium version, starting at `1`. For example, `1.0.13` is the initial
+  release of the package for libsodium 1.0.13 and `1.0.13.5` is the fifth
+  revision (sixth release) of that package.
+* *pre-release label*  
+  If a package is a pre-release, a label is appended to the version number in
+  `-preview-##` format where `##` is the number of the pre-release, starting at
+  `01`. For example, `1.0.13-preview-01` is the first pre-release of the package
+  for libsodium 1.0.13 and `1.0.13.5-preview-02` the second pre-release of the
+  fifth revision of the package for libsodium 1.0.13.
+
+
+**Making a release**
+
+1. Update any existing Docker images.
+2. Run `python3 prepare.py <version>` to generate the `Makefile`, where
+   `<version>` is the package version number in the format described above.
+3. Take a look at the generated `Makefile`. It uses `sudo` a few times.
+4. Run `make` to download and build the binaries and create the NuGet package.
+   You may need to install `docker`, `make`, `curl`, `tar` and `unzip` first.
+5. Grab a cup of coffee. Downloading the Docker images and compiling the Linux
+   binaries takes a while. When done, the NuGet package is output as a `.nupkg`
+   file in the `build` directory.
+6. Run `make test` to perform a quick test of the NuGet package. Verify that
+   everything else in the `.nupkg` file is in place.
+7. Publish the release by uploading the `.nupkg` file to
+   [nuget.org](https://nuget.org/).

data/vendor/libsodium/packaging/dotnet-core/desktop.targets

@@ -0,0 +1,16 @@
+<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+    <ItemGroup>
+        <None Include="$(MSBuildThisFileDirectory)..\..\runtimes\win7-x86\native\libsodium.dll">
+            <Link>x86\libsodium.dll</Link>
+            <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+            <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
+            <Visible>false</Visible>
+        </None>
+        <None Include="$(MSBuildThisFileDirectory)..\..\runtimes\win7-x64\native\libsodium.dll">
+            <Link>x64\libsodium.dll</Link>
+            <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+            <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
+            <Visible>false</Visible>
+        </None>
+    </ItemGroup>
+</Project>

data/vendor/libsodium/packaging/dotnet-core/libsodium.props

@@ -0,0 +1,33 @@
+<?xml version="1.0"?>
+<Project>
+
+  <PropertyGroup>
+    <TargetFrameworks>netstandard1.1;net46</TargetFrameworks>
+    <DisableImplicitFrameworkReferences>true</DisableImplicitFrameworkReferences>
+    <NoBuild>true</NoBuild>
+    <IncludeBuildOutput>false</IncludeBuildOutput>
+    <PackageOutputPath>$(MSBuildProjectDirectory)</PackageOutputPath>
+    <ProjectFileToPack>$(MSBuildProjectFullPath)</ProjectFileToPack>
+  </PropertyGroup>
+
+  <PropertyGroup>
+    <PackageId>libsodium</PackageId>
+    <Version><!-- set by prepare.py --></Version>
+    <Authors>Frank Denis</Authors>
+    <Description>Internal implementation package not meant for direct consumption. Please do not reference directly.</Description>
+    <Copyright>&#169; 2013-2017 Frank Denis</Copyright>
+    <PackageRequireLicenseAcceptance>true</PackageRequireLicenseAcceptance>
+    <PackageLicenseUrl>https://raw.githubusercontent.com/jedisct1/libsodium/master/LICENSE</PackageLicenseUrl>
+    <PackageProjectUrl>https://libsodium.org/</PackageProjectUrl>
+    <MinClientVersion>4.0</MinClientVersion>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <Content Include="LICENSE" PackagePath="" />
+    <Content Include="AUTHORS" PackagePath="" />
+    <Content Include="ChangeLog" PackagePath="" />
+    <Content Include="runtimes\**\*.*" PackagePath="runtimes\" />
+    <Content Include="build\**\*.*" PackagePath="build\" />
+  </ItemGroup>
+
+</Project>

data/vendor/libsodium/packaging/dotnet-core/prepare.py

@@ -0,0 +1,262 @@
+#!/usr/bin/env python3
+
+import os.path
+import re
+import sys
+
+WINDOWS = [
+  # --------------------- ----------------- #
+  # Runtime ID            Platform          #
+  # --------------------- ----------------- #
+  ( 'win7-x64',           'x64'             ),
+  ( 'win7-x86',           'Win32'           ),
+  # --------------------- ----------------- #
+]
+
+MACOS = [
+  # --------------------- ----------------- #
+  # Runtime ID            Codename          #
+  # --------------------- ----------------- #
+  ( 'osx.10.10-x64',      'yosemite'        ),
+  ( 'osx.10.11-x64',      'el_capitan'      ),
+  ( 'osx.10.12-x64',      'sierra'          ),
+  # --------------------- ----------------- #
+]
+
+LINUX = [
+  # --------------------- ----------------- #
+  # Runtime ID            Docker Image      #
+  # --------------------- ----------------- #
+  ( 'centos.7-x64',       'centos:7.1.1503' ),
+  ( 'debian.8-x64',       'debian:8.2'      ),
+  ( 'fedora.24-x64',      'fedora:24'       ),
+  ( 'fedora.25-x64',      'fedora:25'       ),
+  ( 'fedora.26-x64',      'fedora:26'       ),
+  ( 'opensuse.42.1-x64',  'opensuse:42.1'   ),
+  ( 'ubuntu.14.04-x64',   'ubuntu:trusty'   ),
+  ( 'ubuntu.16.04-x64',   'ubuntu:xenial'   ),
+  ( 'ubuntu.16.10-x64',   'ubuntu:yakkety'  ),
+  # --------------------- ----------------- #
+]
+
+EXTRAS = [ 'LICENSE', 'AUTHORS', 'ChangeLog' ]
+
+PROPSFILE = 'libsodium.props'
+DESKTOPTARGETSFILE = 'desktop.targets'
+MAKEFILE = 'Makefile'
+BUILDDIR = 'build'
+CACHEDIR = 'cache'
+TEMPDIR = 'temp'
+
+PACKAGE = 'libsodium'
+LIBRARY = 'libsodium'
+
+DOCKER = 'sudo docker'
+
+class Version:
+
+  def __init__(self, libsodium_version, package_version):
+    self.libsodium_version = libsodium_version
+    self.package_version = package_version
+
+    self.builddir = os.path.join(BUILDDIR, libsodium_version)
+    self.tempdir = os.path.join(TEMPDIR, libsodium_version)
+    self.projfile = os.path.join(self.builddir, '{0}.{1}.pkgproj'.format(PACKAGE, package_version))
+    self.propsfile = os.path.join(self.builddir, '{0}.props'.format(PACKAGE))
+    self.pkgfile = os.path.join(BUILDDIR, '{0}.{1}.nupkg'.format(PACKAGE, package_version))
+    self.desktoptargetsfile = os.path.join(self.builddir, 'build', 'net46', '{0}.targets'.format(PACKAGE))
+
+class WindowsItem:
+
+  def __init__(self, version, rid, platform):
+    self.url = 'https://download.libsodium.org/libsodium/releases/libsodium-{0}-msvc.zip'.format(version.libsodium_version)
+    self.cachefile = os.path.join(CACHEDIR, re.sub(r'[^A-Za-z0-9.]', '-', self.url))
+    self.packfile = os.path.join(version.builddir, 'runtimes', rid, 'native', LIBRARY + '.dll')
+    self.itemfile = '{0}/Release/v140/dynamic/libsodium.dll'.format(platform)
+    self.tempdir = os.path.join(version.tempdir, rid)
+    self.tempfile = os.path.join(self.tempdir, os.path.normpath(self.itemfile))
+
+  def make(self, f):
+    f.write('\n')
+    f.write('{0}: {1}\n'.format(self.packfile, self.tempfile))
+    f.write('\t@mkdir -p $(dir $@)\n')
+    f.write('\tcp -f $< $@\n')
+    f.write('\n')
+    f.write('{0}: {1}\n'.format(self.tempfile, self.cachefile))
+    f.write('\t@mkdir -p $(dir $@)\n')
+    f.write('\tcd {0} && unzip -q -DD -o {1} \'{2}\'\n'.format(
+      self.tempdir,
+      os.path.relpath(self.cachefile, self.tempdir),
+      self.itemfile
+    ))
+
+class MacOSItem:
+
+  def __init__(self, version, rid, codename):
+    self.url = 'https://bintray.com/homebrew/bottles/download_file?file_path=libsodium-{0}.{1}.bottle.tar.gz'.format(version.libsodium_version, codename)
+    self.cachefile = os.path.join(CACHEDIR, re.sub(r'[^A-Za-z0-9.]', '-', self.url))
+    self.packfile = os.path.join(version.builddir, 'runtimes', rid, 'native', LIBRARY + '.dylib')
+    self.itemfile = 'libsodium/{0}/lib/libsodium.dylib'.format(version.libsodium_version)
+    self.tempdir = os.path.join(version.tempdir, rid)
+    self.tempfile = os.path.join(self.tempdir, os.path.normpath(self.itemfile))
+
+  def make(self, f):
+    f.write('\n')
+    f.write('{0}: {1}\n'.format(self.packfile, self.tempfile))
+    f.write('\t@mkdir -p $(dir $@)\n')
+    f.write('\tcp -f $< $@\n')
+    f.write('\n')
+    f.write('{0}: {1}\n'.format(self.tempfile, self.cachefile))
+    f.write('\t@mkdir -p $(dir $@)\n')
+    f.write('\tcd {0} && tar xzmf {1} \'{2}\'\n'.format(
+      self.tempdir,
+      os.path.relpath(self.cachefile, self.tempdir),
+      os.path.dirname(self.itemfile)
+    ))
+
+class LinuxItem:
+
+  def __init__(self, version, rid, docker_image):
+    self.url = 'https://download.libsodium.org/libsodium/releases/libsodium-{0}.tar.gz'.format(version.libsodium_version)
+    self.cachefile = os.path.join(CACHEDIR, re.sub(r'[^A-Za-z0-9.]', '-', self.url))
+    self.packfile = os.path.join(version.builddir, 'runtimes', rid, 'native', LIBRARY + '.so')
+    self.tempdir = os.path.join(version.tempdir, rid)
+    self.tempfile = os.path.join(self.tempdir, 'libsodium.so')
+    self.docker_image = docker_image
+    self.recipe = rid
+
+  def make(self, f):
+    recipe = self.recipe
+    while not os.path.exists(os.path.join('recipes', recipe)):
+      m = re.fullmatch(r'([^.-]+)((([.][^.-]+)*)[.][^.-]+)?([-].*)?', recipe)
+      if m.group(5) is None:
+        recipe = 'build'
+        break
+      elif m.group(2) is None:
+        recipe = m.group(1)
+      else:
+        recipe = m.group(1) + m.group(3) + m.group(5)
+
+    f.write('\n')
+    f.write('{0}: {1}\n'.format(self.packfile, self.tempfile))
+    f.write('\t@mkdir -p $(dir $@)\n')
+    f.write('\tcp -f $< $@\n')
+    f.write('\n')
+    f.write('{0}: {1}\n'.format(self.tempfile, self.cachefile))
+    f.write('\t@mkdir -p $(dir $@)\n')
+    f.write('\t{0} run --rm '.format(DOCKER) +
+            '-v $(abspath recipes):/io/recipes ' +
+            '-v $(abspath $<):/io/libsodium.tar.gz ' +
+            '-v $(abspath $(dir $@)):/io/output ' +
+            '{0} sh -x -e /io/recipes/{1}\n'.format(self.docker_image, recipe))
+
+class ExtraItem:
+
+  def __init__(self, version, filename):
+    self.url = 'https://download.libsodium.org/libsodium/releases/libsodium-{0}.tar.gz'.format(version.libsodium_version)
+    self.cachefile = os.path.join(CACHEDIR, re.sub(r'[^A-Za-z0-9.]', '-', self.url))
+    self.packfile = os.path.join(version.builddir, filename)
+    self.itemfile = 'libsodium-{0}/{1}'.format(version.libsodium_version, filename)
+    self.tempdir = os.path.join(version.tempdir, 'extras')
+    self.tempfile = os.path.join(self.tempdir, os.path.normpath(self.itemfile))
+
+  def make(self, f):
+    f.write('\n')
+    f.write('{0}: {1}\n'.format(self.packfile, self.tempfile))
+    f.write('\t@mkdir -p $(dir $@)\n')
+    f.write('\tcp -f $< $@\n')
+    f.write('\n')
+    f.write('{0}: {1}\n'.format(self.tempfile, self.cachefile))
+    f.write('\t@mkdir -p $(dir $@)\n')
+    f.write('\tcd {0} && tar xzmf {1} \'{2}\'\n'.format(
+      self.tempdir,
+      os.path.relpath(self.cachefile, self.tempdir),
+      self.itemfile
+    ))
+
+def main(args):
+  m = re.fullmatch(r'((\d+\.\d+\.\d+)(\.\d+)?)(?:-(\w+(?:[_.-]\w+)*))?', args[1]) if len(args) == 2 else None
+
+  if m is None:
+    print('Usage:')
+    print('       python3 prepare.py <version>')
+    print()
+    print('Examples:')
+    print('       python3 prepare.py 1.0.13-preview-01')
+    print('       python3 prepare.py 1.0.13-preview-02')
+    print('       python3 prepare.py 1.0.13-preview-03')
+    print('       python3 prepare.py 1.0.13')
+    print('       python3 prepare.py 1.0.13.1-preview-01')
+    print('       python3 prepare.py 1.0.13.1')
+    print('       python3 prepare.py 1.0.13.2')
+    return 1
+
+  version = Version(m.group(2), m.group(0))
+
+  items = [ WindowsItem(version, rid, platform)   for (rid, platform) in WINDOWS   ] + \
+          [ MacOSItem(version, rid, codename)     for (rid, codename) in MACOS     ] + \
+          [ LinuxItem(version, rid, docker_image) for (rid, docker_image) in LINUX ] + \
+          [ ExtraItem(version, filename)          for filename in EXTRAS           ]
+
+  downloads = {item.cachefile: item.url for item in items}
+
+  with open(MAKEFILE, 'w') as f:
+    f.write('all: {0}\n'.format(version.pkgfile))
+
+    for download in sorted(downloads):
+      f.write('\n')
+      f.write('{0}:\n'.format(download))
+      f.write('\t@mkdir -p $(dir $@)\n')
+      f.write('\tcurl -f#Lo $@ \'{0}\'\n'.format(downloads[download]))
+
+    for item in items:
+      item.make(f)
+
+    f.write('\n')
+    f.write('{0}: {1}\n'.format(version.desktoptargetsfile, DESKTOPTARGETSFILE))
+    f.write('\t@mkdir -p $(dir $@)\n')
+    f.write('\tcp -f $< $@\n')
+
+    f.write('\n')
+    f.write('{0}: {1}\n'.format(version.propsfile, PROPSFILE))
+    f.write('\t@mkdir -p $(dir $@)\n')
+    f.write('\tcp -f $< $@\n')
+
+    f.write('\n')
+    f.write('{0}: {1}\n'.format(version.projfile, version.propsfile))
+    f.write('\t@mkdir -p $(dir $@)\n')
+    f.write('\techo \'' +
+            '<Project Sdk="Microsoft.NET.Sdk">' +
+            '<Import Project="{0}" />'.format(os.path.relpath(version.propsfile, os.path.dirname(version.projfile))) +
+            '<PropertyGroup>' +
+            '<Version>{0}</Version>'.format(version.package_version) +
+            '</PropertyGroup>' +
+            '</Project>\' > $@\n')
+
+    f.write('\n')
+    f.write('{0}:'.format(version.pkgfile))
+    f.write(' \\\n\t\t{0}'.format(version.projfile))
+    f.write(' \\\n\t\t{0}'.format(version.propsfile))
+    f.write(' \\\n\t\t{0}'.format(version.desktoptargetsfile))
+    for item in items:
+      f.write(' \\\n\t\t{0}'.format(item.packfile))
+    f.write('\n')
+    f.write('\t@mkdir -p $(dir $@)\n')
+    f.write('\t{0} run --rm '.format(DOCKER) +
+            '-v $(abspath recipes):/io/recipes ' +
+            '-v $(abspath $(dir $<)):/io/input ' +
+            '-v $(abspath $(dir $@)):/io/output ' +
+            '{0} sh -x -e /io/recipes/{1} {2}\n'.format('microsoft/dotnet:1.1-sdk', 'pack', os.path.relpath(version.projfile, version.builddir)))
+
+    f.write('\n')
+    f.write('test: {0}\n'.format(version.pkgfile))
+    f.write('\t{0} run --rm '.format(DOCKER) +
+            '-v $(abspath recipes):/io/recipes ' +
+            '-v $(abspath $(dir $<)):/io/packages ' +
+            '{0} sh -x -e /io/recipes/{1} "{2}"\n'.format('microsoft/dotnet:1.1-sdk', 'test', version.package_version))
+
+  print('prepared', MAKEFILE, 'to make', version.pkgfile, 'for libsodium', version.libsodium_version)
+  return 0
+
+if __name__ == '__main__':
+  sys.exit(main(sys.argv))