Properly setup building and packaging of the lib.

Splitted the lib and the executable.
Added some macrodefs to properly link the library.
Replaced int in the signature with a enum. Should have the same size and not break compatibility, but increase clarity. Also changed its values hardcoded into the code to the names in the enum.
Added support of CMake.
Added CPack packaging.
Added license as a separate file.
Added ReadMe.md with some text.

Author: KOLANICH

.gitignore

@@ -0,0 +1 @@
+/build

.gitmodules

@@ -0,0 +1,13 @@
+[submodule "tests/testDataset"]
+	path = tests/testDataset
+	url = https://codeberg.org/implode-compression-impls/implode_test_files
+	branch = merged
+	shallow = true
+[submodule "cmake/Boilerplate"]
+	path = cmake/Boilerplate
+	url = https://codeberg.org/KOLANICH-libs/Boilerplate.cmake
+	branch = master
+[submodule "cmake/DoxygenUtils"]
+	path = cmake/DoxygenUtils
+	url = https://codeberg.org/KOLANICH-libs/DoxygenUtils.cmake
+	branch = master

CMakeLists.txt

@@ -0,0 +1,50 @@
+cmake_minimum_required(VERSION 3.13)
+
+set(CMAKE_USE_RELATIVE_PATHS TRUE)
+project("blast")
+set("PROJECT_DESCRIPTION" "Free open source PKWare Data Compression Library (DCL) implementation")
+set("PROJECT_HOMEPAGE_URL" "https://github.com/madler/zlib/tree/master/contrib/blast")
+set(CPACK_PACKAGE_VENDOR "Mark Adler")
+
+set(CPACK_PACKAGE_VERSION_MAJOR "1")
+set(CPACK_PACKAGE_VERSION_MINOR "2")
+set(CPACK_PACKAGE_VERSION_PATCH "9")
+set(CPACK_PACKAGE_VERSION "${CPACK_PACKAGE_VERSION_MAJOR}.${CPACK_PACKAGE_VERSION_MINOR}.${CPACK_PACKAGE_VERSION_PATCH}")
+
+set(OUR_CMAKE_MODULES_DIR "${CMAKE_CURRENT_SOURCE_DIR}/cmake")
+set(OUR_CMAKE_3PARTY_MODULES_DIR "${OUR_CMAKE_MODULES_DIR}/thirdParty")
+set(CMAKE_MODULE_PATH ${CMAKE_MODULE_PATH} "${OUR_CMAKE_MODULES_DIR}" "${OUR_CMAKE_MODULES_DIR}/Boilerplate" "${OUR_CMAKE_MODULES_DIR}/DoxygenUtils" "${OUR_CMAKE_3PARTY_MODULES_DIR}")
+
+include(Boilerplate)
+
+set(Include_dir "${CMAKE_CURRENT_SOURCE_DIR}/include")
+file(GLOB_RECURSE HDRFILES "${Include_dir}/*.h" "${Include_dir}/*.hpp")
+
+set(LibSource_dir "${CMAKE_CURRENT_SOURCE_DIR}/lib")
+set(BinSource_dir "${CMAKE_CURRENT_SOURCE_DIR}/bin")
+set(PackagingTemplatesDir "${CMAKE_CURRENT_SOURCE_DIR}/packaging")
+set(tests_dir "${CMAKE_CURRENT_SOURCE_DIR}/tests")
+
+
+set(CPACK_PACKAGE_MAINTAINER "${CPACK_PACKAGE_VENDOR}")
+set(CPACK_DEBIAN_PACKAGE_NAME "${CPACK_PACKAGE_NAME}")
+set(CPACK_RPM_PACKAGE_NAME "${CPACK_PACKAGE_NAME}")
+
+add_subdirectory("${LibSource_dir}")
+add_subdirectory("${BinSource_dir}")
+
+option(WITH_TESTS ON "Enable testing")
+
+if(WITH_TESTS)
+	add_subdirectory("${tests_dir}")
+	enable_testing()
+endif()
+
+set(CPACK_DEB_COMPONENT_INSTALL ON)
+set(CPACK_RPM_COMPONENT_INSTALL ON)
+set(CPACK_NSIS_COMPONENT_INSTALL ON)
+#set(CPACK_DEBIAN_ENABLE_COMPONENT_DEPENDS ON)
+set(CPACK_RPM_ENABLE_COMPONENT_DEPENDS ON)
+set(CPACK_DEBIAN_COMPRESSION_TYPE "xz")
+
+include(CPack)

License.md

@@ -0,0 +1,24 @@
+The zlib/libpng License
+=======================
+
+Copyright (C) 2003, 2012, 2013 Mark Adler
+
+This software is provided 'as-is', without any express or implied warranty. In
+no event will the authors be held liable for any damages arising from the use of
+this software.
+
+Permission is granted to anyone to use this software for any purpose, including
+commercial applications, and to alter it and redistribute it freely, subject to
+the following restrictions:
+
+1.  The origin of this software must not be misrepresented; you must not claim
+    that you wrote the original software. If you use this software in a product,
+    an acknowledgment in the product documentation would be appreciated but is
+    not required.
+
+2.  Altered source versions must be plainly marked as such, and must not be
+    misrepresented as being the original software.
+
+3.  This notice may not be removed or altered from any source distribution.
+
+Mark Adler    [email protected]

Makefile

@@ -1,8 +1,11 @@
-blast: blast.c blast.h
-	cc -DTEST -o blast blast.c
+libblast: ./src/blast.c ./include/blast.h
+	cc -shared -o ./build/lib/libblast.so ./lib/blast.c -I./include
 
-test: blast
-	blast < test.pk | cmp - test.txt
+blast: ./src/blast.c ./include/blast.h libblast
+	cc -o ./build/bin/blast ./src/blast.c -I./include -l:./build/lib/libblast.so
+
+test: ./build/bin/blast
+	./build/bin/blast < ./tests/test.pk | cmp - ./tests/test.txt
 
 clean:
-	rm -f blast blast.o
+	rm -f ./build/blast ./build/blast.o

README

@@ -0,0 +1,28 @@
+libblast (modified for better packaging)
+========
+
+It is the modified version of [Mark @madler Adler](https://github.com/madler)'s [libblast](https://github.com/madler/zlib/tree/master/contrib/blast).
+
+`libblast` is a free and open-source library implementing decompression of PKWare Data Compression Library (DCL) compressed format.
+
+Modifications:
+
+* splitted into a separate git repo for the convenience of ones who want to inline it as a submodule
+* changed repo layout for convenience and clarity
+* implemented building with CMake
+* implemented packaging with CPack
+* implemented hardening with [Hardening.cmake](https://codeberg.org/KOLANICH-libs/Hardening.cmake)
+
+
+Bindings
+--------
+* https://codeberg.org/implode-compression-impls/pkblast.py - Python bindings of this lib
+
+
+Other impls
+-----------
+
+* https://github.com/agrif/explode - a reimplementation of this lib in Rust.
+* https://codeberg.org/implode-compression-impls/pklib - an impl extracted from [Ladislav Zezula](https://github.com/ladislav-zezula)'s [StormLib](https://github.com/ladislav-zezula/StormLib). Contains a compressor, [`libimplode](https://github.com/implode-compression-impls/pklib/tree/master/src/implode)
+* https://github.com/Schallaven/pwexplode - a pure python lib for decompression, but it is under GPL-3.0-or-later
+* https://github.com/ShieldBattery/implode-decoder - An impl in JS. Based on `libexplode`.

ReadMe.md

@@ -0,0 +1,28 @@
+file(GLOB_RECURSE SRCFILES "${CMAKE_CURRENT_SOURCE_DIR}/*.c" "${CMAKE_CURRENT_SOURCE_DIR}/*.cpp")
+
+add_executable(blast "${SRCFILES}")
+target_include_directories(blast PUBLIC "${Include_dir}")
+target_link_libraries(blast PRIVATE libblast)
+harden(blast)
+
+cpack_add_component(blast
+	DISPLAY_NAME "binary"
+	DESCRIPTION "The decompressor binary for PKWare Data Compression Library (DCL) format"
+	DEPENDS "library" "library_sdk"
+)
+
+install(TARGETS "blast"
+	RUNTIME
+	COMPONENT "blast"
+)
+
+set("CPACK_DEBIAN_BLAST_PACKAGE_NAME" "blast")
+set("CPACK_RPM_BLAST_PACKAGE_NAME" "blast")
+
+set("CPACK_DEBIAN_BLAST_PACKAGE_DEPENDS" "${CPACK_DEBIAN_LIBBLAST_PACKAGE_NAME}")
+set("CPACK_RPM_BLAST_PACKAGE_DEPENDS" "${CPACK_RPM_LIBBLAST_PACKAGE_NAME}")
+
+
+list(APPEND CPACK_COMPONENTS_ALL "blast")  # strangely, not populated automatically correctly
+
+pass_through_cpack_vars()

bin/CMakeLists.txt

@@ -0,0 +1,73 @@
+/* blast.c
+ * Copyright (C) 2003, 2012, 2013 Mark Adler
+ * For conditions of distribution and use, see copyright notice in blast.h
+ * version 1.3, 24 Aug 2013
+ *
+ * blast.c decompresses data compressed by the PKWare Compression Library.
+ * This function provides functionality similar to the explode() function of
+ * the PKWare library, hence the name "blast".
+ *
+ * This decompressor is based on the excellent format description provided by
+ * Ben Rudiak-Gould in comp.compression on August 13, 2001.  Interestingly, the
+ * example Ben provided in the post is incorrect.  The distance 110001 should
+ * instead be 111000.  When corrected, the example byte stream becomes:
+ *
+ *    00 04 82 24 25 8f 80 7f
+ *
+ * which decompresses to "AIAIAIAIAIAIA" (without the quotes).
+ */
+
+/*
+ * Change history:
+ *
+ * 1.0  12 Feb 2003     - First version
+ * 1.1  16 Feb 2003     - Fixed distance check for > 4 GB uncompressed data
+ * 1.2  24 Oct 2012     - Add note about using binary mode in stdio
+ *                      - Fix comparisons of differently signed integers
+ * 1.3  24 Aug 2013     - Return unused input from blast()
+ *                      - Fix test code to correctly report unused input
+ *                      - Enable the provision of initial input to blast()
+ */
+
+/* Example of how to use blast() */
+#include <stdio.h>
+#include <stdlib.h>
+
+#include <blast.h>
+
+#define CHUNK 16384
+
+static unsigned inf(void *how, unsigned char **buf)
+{
+    static unsigned char hold[CHUNK];
+
+    *buf = hold;
+    return fread(hold, 1, CHUNK, (FILE *)how);
+}
+
+static int outf(void *how, unsigned char *buf, unsigned len)
+{
+    return fwrite(buf, 1, len, (FILE *)how) != len;
+}
+
+/* Decompress a PKWare Compression Library stream from stdin to stdout */
+int main(void)
+{
+    int ret;
+    unsigned left;
+
+    /* decompress to stdout */
+    left = 0;
+    ret = blast(inf, stdin, outf, stdout, &left, NULL);
+    if (ret != 0)
+        fprintf(stderr, "blast error: %d\n", ret);
+
+    /* count any leftover bytes */
+    while (getchar() != EOF)
+        left++;
+    if (left)
+        fprintf(stderr, "blast warning: %u unused bytes of input\n", left);
+
+    /* return blast() error code */
+    return ret;
+}