build: Add automated packaging workflow for distribution releases

Add 'package' target to Makefile for creating versioned zip archives with HTML documentation (pandoc) and update Inno Setup installer for Windows. Reads version from environment and prepares for GitHub Actions automation.

Author: peter277

Makefile

@@ -1,10 +1,11 @@
 # sqlcw: SQL Code Wrapper - Build Configuration
 
 # Directory structure
-BUILD_DIR := build
-SRC_DIR := src
-OBJ_DIR = $(BUILD_DIR)/obj
+BUILD_DIR := $(CURDIR)/build
+SRC_DIR := $(CURDIR)/src
+OBJ_DIR := $(BUILD_DIR)/obj
 BUILD_INFO_FILE := $(BUILD_DIR)/build_info.h
+PACKAGE_DIR := $(BUILD_DIR)/package
 
 # Discover all C++ source files in the source directory
 SOURCE_FILES := $(wildcard $(SRC_DIR)/*.cpp)
@@ -36,11 +37,13 @@ BUILD_VERSION_STR := $(if $(and $(ENV_BUILD_VERSION_MAJOR),$(ENV_BUILD_VERSION_M
 # Platform-specific configuration
 ifdef MSYSTEM
 	# Building on Windows (MSYS2/MinGW)
+	PLATFORM := win64
 	TARGET := $(BUILD_DIR)/sqlcw.exe
 	# Boost libraries on Windows use -mt suffix (multi-threaded)
 	LIBS := $(addsuffix -mt, $(addprefix -l,$(BOOST_LIBS)))
 else
 	# Building on Linux/Unix
+	PLATFORM := linux_$(shell uname -m)
 	TARGET := $(BUILD_DIR)/sqlcw
 	LIBS := $(addprefix -l,$(BOOST_LIBS))
 endif
@@ -94,9 +97,22 @@ else
 WINDRES_OBJECT_FILE :=
 endif
 
-# Placeholder for packaging step (e.g., creating zip/tarball)
+# Package application executable and documentation for distribution
 package: $(TARGET)
-	@echo "Generating package..."
+	@echo "Generating documentation and creating distribution packages..."
+	BUILD_VERSION=$(BUILD_VERSION_STR) pandoc README.md -o $(BUILD_DIR)/README.html --embed-resources --standalone  --lua-filter=scripts/pandoc-link-rewriter.lua
+	BUILD_VERSION=$(BUILD_VERSION_STR) pandoc LICENSE.md -o $(BUILD_DIR)/LICENSE.html --embed-resources --standalone  --lua-filter=scripts/pandoc-link-rewriter.lua
+
+	mkdir -p $(PACKAGE_DIR)/bin
+	cp $(TARGET) $(PACKAGE_DIR)/bin
+	cp $(BUILD_DIR)/README.html $(BUILD_DIR)/LICENSE.html -t $(PACKAGE_DIR)
+	cp -r doc/library-licenses doc/examples -t $(PACKAGE_DIR)
+	cd $(PACKAGE_DIR) && zip -r $(BUILD_DIR)/sqlcw-$(BUILD_VERSION_STR)-$(PLATFORM).zip .
+	rm -rf $(PACKAGE_DIR)
+
+ifeq ($(OS),Windows_NT)
+	iscc -Obuild -Q installer/sqlcw_installer.iss
+endif
 
 # Remove all generated files
 clean:

doc/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019-2025 peter277 - https://github.com/peter277
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

installer/sqlcw_installer.iss

@@ -1,8 +1,17 @@
 #define MyAppName "sqlcw"
-#define MyAppVersion "1.1"
-#define MyAppURL "https://sourceforge.net/projects/sqlcw/"
+#define MyAppURL "https://github.com/peter277/sqlcw"
 #define MyAppExeName "sqlcw.exe"
-#define ProjectDir "X:\Projects\sqlcw"
+#define ProjectDir ExtractFileDir(ExtractFileDir(SourcePath))
+
+#define VerMajor GetEnv("ENV_BUILD_VERSION_MAJOR")
+#define VerMinor GetEnv("ENV_BUILD_VERSION_MINOR")
+#define VerPatch GetEnv("ENV_BUILD_VERSION_PATCH") != "" ? GetEnv("ENV_BUILD_VERSION_PATCH") : "0"
+
+#if VerMajor != "" && VerMinor != ""
+  #define MyAppVersion VerMajor + "." + VerMinor + "." + VerPatch
+#else
+  #define MyAppVersion "dev"
+#endif
 
 [Setup]
 ; NOTE: The value of AppId uniquely identifies this application. Do not use the same AppId value in installers for other applications.
@@ -11,13 +20,14 @@ AppId={{0D0F4C50-15D5-4CDF-A7C7-316375B5359A}
 AppName={#MyAppName}
 AppVersion={#MyAppVersion}
 AppVerName={#MyAppName} {#MyAppVersion}
+;AppPublisher={#MyAppPublisher}
 AppPublisherURL={#MyAppURL}
 AppSupportURL={#MyAppURL}
 AppUpdatesURL={#MyAppURL}
 DefaultDirName={autopf}\{#MyAppName}
 DefaultGroupName={#MyAppName}
 AllowNoIcons=yes
-LicenseFile={#ProjectDir}\doc\LICENSE_GPL-3.0.txt
+LicenseFile={#ProjectDir}\doc\LICENSE.txt
 ; Remove the following line to run in administrative install mode (install for all users.)
 PrivilegesRequired=lowest
 PrivilegesRequiredOverridesAllowed=dialog commandline
@@ -27,13 +37,13 @@ SolidCompression=yes
 WizardStyle=modern
 ChangesEnvironment=true
 
-; "ArchitecturesAllowed=x64" specifies that Setup cannot run on
+; "ArchitecturesAllowed=x64compatible" specifies that Setup cannot run on
 ; anything but x64.
-ArchitecturesAllowed=x64
-; "ArchitecturesInstallIn64BitMode=x64" requests that the install be
+ArchitecturesAllowed=x64compatible
+; "ArchitecturesInstallIn64BitMode=x64compatible" requests that the install be
 ; done in "64-bit mode" on x64, meaning it should use the native
 ; 64-bit Program Files directory and the 64-bit view of the registry.
-ArchitecturesInstallIn64BitMode=x64
+ArchitecturesInstallIn64BitMode=x64compatible
 
 ; Specify a particular icon file to display for the Uninstall entry in the Add/Remove Programs Control Panel applet
 UninstallDisplayIcon={app}\bin\{#MyAppExeName}
@@ -42,17 +52,20 @@ UninstallDisplayIcon={app}\bin\{#MyAppExeName}
 Name: "english"; MessagesFile: "compiler:Default.isl"
 
 [Files]
-Source: "{#ProjectDir}\bin\Release\sqlcw.exe"; DestDir: "{app}\bin"; Flags: ignoreversion
-Source: "{#ProjectDir}\doc\README.txt"; DestDir: "{app}"; Flags: ignoreversion
+Source: "{#ProjectDir}\build\sqlcw.exe"; DestDir: "{app}\bin"; Flags: ignoreversion
+Source: "{#ProjectDir}\build\README.html"; DestDir: "{app}"; Flags: ignoreversion
+Source: "{#ProjectDir}\build\LICENSE.html"; DestDir: "{app}"; Flags: ignoreversion
 Source: "{#ProjectDir}\doc\examples\*"; DestDir: "{app}\examples"; Flags: ignoreversion recursesubdirs createallsubdirs
+Source: "{#ProjectDir}\doc\library-licenses\*"; DestDir: "{app}\library-licenses"; Flags: ignoreversion recursesubdirs createallsubdirs
 ; NOTE: Don't use "Flags: ignoreversion" on any shared system files
 
 [Icons]
 ;Name: "{group}\{#MyAppName}"; Filename: "{app}\{#MyAppExeName}"
 Name: "{group}\{cm:ProgramOnTheWeb,{#MyAppName}}"; Filename: "{#MyAppURL}"
 Name: "{group}\Examples"; Filename: "{app}\examples"
 Name: "{group}\{cm:UninstallProgram,{#MyAppName}}"; Filename: "{uninstallexe}"
-Name: "{group}\{#MyAppName} Readme"; Filename: "{app}\README.txt"
+Name: "{group}\{#MyAppName} Readme"; Filename: "{app}\README.html"
+Name: "{group}\{#MyAppName} License"; Filename: "{app}\LICENSE.html"
 
 [Tasks]
 Name: modifypath; Description: &Add application executable to environmental path

scripts/pandoc-link-rewriter.lua

@@ -0,0 +1,39 @@
+--[[
+Pandoc filter to rewrite relative links to versioned GitHub URLs.
+
+Reads BUILD_VERSION from environment:
+  - Set to version number: links to /blob/v{version}/
+  - Set to "dev" or unset: links to /blob/main/
+
+Usage example: pandoc input.md -o out.html --lua-filter=scripts/pandoc-link-rewriter.lua
+--]]
+
+-- Read version from environment, fallback to 'main'
+local version = os.getenv("BUILD_VERSION") or os.getenv("BUILD_VERSION_STR")
+local base_url
+
+-- Use main branch if no version, or if version is 'dev'
+if version and version ~= "dev" then
+  -- Use tag URL: /blob/v1.1.1/
+  io.stderr:write("Using version tag: v" .. version .. "\n")
+  base_url = "https://github.com/peter277/sqlcw/blob/v" .. version .. "/"
+else
+  -- Fallback to main branch (no version or dev build)
+  if version == "dev" then
+    io.stderr:write("Development build detected, using main branch\n")
+  else
+    io.stderr:write("No version found, using main branch\n")
+  end
+  base_url = "https://github.com/peter277/sqlcw/blob/main/"
+end
+
+function Link(el)
+  -- Only rewrite relative links (not absolute URLs or anchors)
+  if not el.target:match("^https?://") and
+     not el.target:match("^#") and
+     not el.target:match("^mailto:")
+   then
+    el.target = base_url .. el.target
+  end
+  return el
+end

src/main.cpp

@@ -80,7 +80,7 @@ int main(int argc, char **argv)
             cout << "SQLCW - SQL CODE WRAPPER, VERSION " << BUILD_VERSION_STR << endl
                  << "Build Date     : " << BUILD_DATE << endl
                  << "Build Compiler : " << BUILD_COMPILER << endl
-                 << "Website        : http://sqlcw.sourceforge.net/" << endl
+                 << "Website        : https://github.com/peter277/sqlcw" << endl
                  << "License        : MIT" << endl
             ;
             return 0;