New example - Custom Server

examples/C/custom_web_server/GNUmakefile

@@ -0,0 +1,140 @@
+# WebUI C99 Example
+
+# == 1. VARIABLES =============================================================
+
+PROJECT_DIR := $(shell git rev-parse --show-toplevel)
+TARGET := $(firstword $(MAKECMDGOALS))
+LIB_DIR := $(PROJECT_DIR)/dist
+ifeq ($(TARGET), debug)
+LIB_DIR := $(LIB_DIR)/debug
+endif
+INCLUDE_DIR := $(PROJECT_DIR)/include
+WEBUI_LIB_NAME = webui-2
+ifeq ($(WEBUI_USE_TLS), 1)
+WEBUI_LIB_NAME = webui-2-secure
+endif
+
+# ARGS
+# Set a compiler when running on Linux via `make CC=gcc` / `make CC=clang`
+CC = gcc
+# Build the WebUI library if running via `make BUILD_LIB=true`
+BUILD_LIB ?=
+
+# BUILD FLAGS
+STATIC_BUILD_FLAGS = main.c -I"$(INCLUDE_DIR)" -L"$(LIB_DIR)"
+DYN_BUILD_FLAGS = main.c -I"$(INCLUDE_DIR)" -L"$(LIB_DIR)"
+
+# Platform conditions
+ifeq ($(OS),Windows_NT)
+	# Windows
+	PLATFORM := windows
+	SHELL := CMD
+	STATIC_BUILD_FLAGS += -l$(WEBUI_LIB_NAME)-static -lws2_32 -Wall -luser32 -static
+	COPY_LIB_CMD := @copy "$(LIB_DIR)\$(WEBUI_LIB_NAME).dll" "$(WEBUI_LIB_NAME).dll"
+	DYN_BUILD_FLAGS += "$(WEBUI_LIB_NAME).dll" -lws2_32 -Wall -luser32
+	STATIC_OUT := main.exe
+	DYN_OUT := main-dyn.exe
+	LWS2_OPT := -lws2_32
+	STRIP_OPT := --strip-all
+	CONSOLE_APP := -Wl,-subsystem=console
+	GUI_APP := -Wl,-subsystem=windows
+else
+	STATIC_BUILD_FLAGS += -lpthread -lm -l$(WEBUI_LIB_NAME)-static
+	DYN_BUILD_FLAGS += -lpthread -lm
+	STATIC_OUT := main
+	DYN_OUT := main-dyn
+	CONSOLE_APP := 
+	GUI_APP := 
+	ifeq ($(shell uname),Darwin)
+		# MacOS
+		PLATFORM := macos
+		CC = clang
+		COPY_LIB_CMD := @cp "$(LIB_DIR)/$(WEBUI_LIB_NAME).dylib" "$(WEBUI_LIB_NAME).dylib"
+		DYN_BUILD_FLAGS += "./$(WEBUI_LIB_NAME).dylib"
+	else
+		# Linux
+		PLATFORM := linux
+		COPY_LIB_CMD := @cp "$(LIB_DIR)/$(WEBUI_LIB_NAME).so" "$(WEBUI_LIB_NAME).so"
+		DYN_BUILD_FLAGS += "./$(WEBUI_LIB_NAME).so"
+		STRIP_OPT := --strip-all
+		ifeq ($(CC),clang)
+			LLVM_OPT := llvm-
+		endif
+	endif
+endif
+
+# == 2.TARGETS ================================================================
+
+all: release
+
+debug: --validate-args
+ifeq ($(BUILD_LIB),true)
+	@cd "$(PROJECT_DIR)" && $(MAKE) debug
+endif
+#	Static with Debug info
+ifneq ($(WEBUI_USE_TLS), 1)
+	@echo "Build C99 Example ($(CC) debug static)..."
+	@$(CC) -g $(CONSOLE_APP) $(STATIC_BUILD_FLAGS) $(LWS2_OPT) -o $(STATIC_OUT)
+endif
+#	Dynamic with Debug info
+	@echo "Build C99 Example ($(CC) debug dynamic)..."
+	$(COPY_LIB_CMD)
+	@$(CC) -g $(CONSOLE_APP) $(DYN_BUILD_FLAGS) $(LWS2_OPT) -o $(DYN_OUT)
+#	Clean
+ifeq ($(PLATFORM),windows)
+	@- del *.o >nul 2>&1
+else
+	@- rm -f *.o
+	@- rm -rf *.dSYM # macOS
+endif
+	@echo "Done."
+
+release: --validate-args
+ifeq ($(BUILD_LIB),true)
+	@cd "$(PROJECT_DIR)" && $(MAKE)
+endif
+#	Static Release
+ifneq ($(WEBUI_USE_TLS), 1)
+	@echo "Build C99 Example ($(CC) release static)..."
+	@$(CC) -Os $(GUI_APP) $(STATIC_BUILD_FLAGS) $(LWS2_OPT) -o $(STATIC_OUT)
+	@$(LLVM_OPT)strip $(STRIP_OPT) $(STATIC_OUT)
+endif
+#	Dynamic Release
+	@echo "Build C99 Example ($(CC) release dynamic)..."
+	$(COPY_LIB_CMD)
+	@$(CC) $(GUI_APP) $(DYN_BUILD_FLAGS) $(LWS2_OPT) -o $(DYN_OUT)
+	@$(LLVM_OPT)strip $(STRIP_OPT) $(DYN_OUT)
+#	Clean
+ifeq ($(PLATFORM),windows)
+	@- del *.o >nul 2>&1
+else
+	@- rm -f *.o
+	@- rm -rf *.dSYM # macOS
+endif
+	@echo "Done."
+
+clean: --clean-$(PLATFORM)
+
+# INTERNAL TARGETS
+
+--validate-args:
+ifneq ($(filter $(CC),gcc clang aarch64-linux-gnu-gcc arm-linux-gnueabihf-gcc musl-gcc),$(CC))
+$(error Invalid compiler specified: `$(CC)`)
+endif
+
+--clean-linux: --clean-unix
+
+--clean-macos: --clean-unix
+
+--clean-unix:
+	- rm -f *.o
+	- rm -f *.a
+	- rm -f *.so
+	- rm -f *.dylib
+	- rm -rf *.dSYM
+
+--clean-windows:
+	- del *.o >nul 2>&1
+	- del *.dll >nul 2>&1
+	- del *.a >nul 2>&1
+	- del *.exe >nul 2>&1

examples/C/custom_web_server/Makefile

@@ -0,0 +1,65 @@
+# WebUI C99 Example
+# Windows - Microsoft Visual C
+
+SHELL = CMD
+LIB_DIR = ../../../dist
+INCLUDE_DIR = ../../../include
+WEBUI_LIB_NAME = webui-2
+!IF "$(WEBUI_USE_TLS)" == "1"
+WEBUI_LIB_NAME = webui-2-secure
+!ENDIF
+
+# Build the WebUI library if running `nmake BUILD_LIB=true`
+BUILD_LIB =
+
+all: release
+
+debug:
+!IF "$(BUILD_LIB)" == "true"
+	@cd "$(LIB_DIR)" && cd .. && $(MAKE) debug
+!ENDIF
+#	Static with Debug info
+!IF "$(WEBUI_USE_TLS)" != "1"
+	@echo Build C99 Example (Static Debug)...
+	@cl /Zi main.c /I"$(INCLUDE_DIR)" /link /LIBPATH:"$(LIB_DIR)\debug" /MACHINE:X64 /SUBSYSTEM:CONSOLE $(WEBUI_LIB_NAME)-static.lib user32.lib Advapi32.lib Shell32.lib /OUT:main.exe 1>NUL 2>&1
+!ENDIF
+#	Dynamic with Debug info
+	@echo Build C99 Example (Dynamic Debug)...
+	@copy "$(LIB_DIR)\debug\$(WEBUI_LIB_NAME).dll" "$(WEBUI_LIB_NAME).dll"
+	@cl /Zi main.c /I"$(INCLUDE_DIR)" /link /LIBPATH:"$(LIB_DIR)\debug" /MACHINE:X64 /SUBSYSTEM:CONSOLE $(WEBUI_LIB_NAME).lib user32.lib Advapi32.lib Shell32.lib /OUT:main-dyn.exe 1>NUL 2>&1
+#	Clean
+	@- del *.exp >nul 2>&1
+	@- del *.ilk >nul 2>&1
+	@- del *.lib >nul 2>&1
+	@- del *.obj >nul 2>&1
+	@- del *.pdb >nul 2>&1
+	@echo Done.
+
+release:
+!IF "$(BUILD_LIB)" == "true"
+	@cd "$(LIB_DIR)" && cd .. && $(MAKE)
+!ENDIF
+#	Static Release
+!IF "$(WEBUI_USE_TLS)" != "1"
+	@echo Build C99 Example (Static Release)...
+	@cl main.c /I"$(INCLUDE_DIR)" /link /LIBPATH:"$(LIB_DIR)" /MACHINE:X64 /SUBSYSTEM:WINDOWS $(WEBUI_LIB_NAME)-static.lib user32.lib Advapi32.lib Shell32.lib /OUT:main.exe 1>NUL 2>&1
+!ENDIF
+#	Dynamic Release
+	@echo Build C99 Example (Dynamic Release)...
+	@copy "$(LIB_DIR)\$(WEBUI_LIB_NAME).dll" "$(WEBUI_LIB_NAME).dll"
+	@cl main.c /I"$(INCLUDE_DIR)" /link /LIBPATH:"$(LIB_DIR)" /MACHINE:X64 /SUBSYSTEM:WINDOWS $(WEBUI_LIB_NAME).lib user32.lib Advapi32.lib Shell32.lib /OUT:main-dyn.exe 1>NUL 2>&1
+#	Clean
+	@- del *.exp >nul 2>&1
+	@- del *.ilk >nul 2>&1
+	@- del *.lib >nul 2>&1
+	@- del *.obj >nul 2>&1
+	@- del *.pdb >nul 2>&1
+	@echo Done.
+
+clean:
+	- del *.obj >nul 2>&1
+	- del *.ilk >nul 2>&1
+	- del *.pdb >nul 2>&1
+	- del *.exp >nul 2>&1
+	- del *.exe >nul 2>&1
+	- del *.lib >nul 2>&1

examples/C/custom_web_server/index.html

@@ -0,0 +1,18 @@
+<!doctype html>
+<html>
+	<head>
+		<meta charset="UTF-8" />
+		<title>WebUI - Custom Web-Server Example (C99)</title>
+		<!-- Connect this window to the back-end app -->
+		<script src="http://localhost:8081/webui.js"></script>
+	</head>
+	<body>
+		<h3>Custom Web-Server Example (C99)</h3>
+		<p>
+			This HTML page is handled by a custom Web-Server other than WebUI.<br />
+			This window is connected to the back-end because we used: <pre>http://localhost:8081/webui.js</pre>
+		</p>
+		<h4><a href="second.html">Simple link example (Local file)</a></h4>
+		<button onclick="my_backend_func(123, 456, 789);">Call my_backend_func()</button>
+	</body>
+</html>

examples/C/custom_web_server/main.c

@@ -0,0 +1,74 @@
+// Serve a Folder Example
+
+#include "webui.h"
+
+void events(webui_event_t* e) {
+
+	// This function gets called every time
+	// there is an event
+
+	if (e->event_type == WEBUI_EVENT_CONNECTED)
+		printf("Connected. \n");
+	else if (e->event_type == WEBUI_EVENT_DISCONNECTED)
+		printf("Disconnected. \n");
+	else if (e->event_type == WEBUI_EVENT_MOUSE_CLICK)
+		printf("Click. \n");
+	else if (e->event_type == WEBUI_EVENT_NAVIGATION) {
+		const char* url = webui_get_string(e);
+		printf("Starting navigation to: %s \n", url);
+
+		// Because we used `webui_bind(MyWindow, "", events);`
+		// WebUI will block all `href` link clicks and sent here instead.
+		// We can then control the behaviour of links as needed.
+		webui_navigate(e->window, url);
+	}
+}
+
+void my_backend_func(webui_event_t* e) {
+
+	// JavaScript:
+	// my_backend_func(123, 456, 789);
+	// or webui.my_backend_func(...);
+
+	long long number_1 = webui_get_int_at(e, 0);
+	long long number_2 = webui_get_int_at(e, 1);
+	long long number_3 = webui_get_int_at(e, 2);
+
+	printf("my_backend_func 1: %lld\n", number_1); // 123
+	printf("my_backend_func 2: %lld\n", number_2); // 456
+	printf("my_backend_func 3: %lld\n", number_3); // 789
+}
+
+int main() {
+
+	// Create new windows
+	size_t window = webui_new_window();
+
+	// Bind all events
+	webui_bind(window, "", events);
+
+	// Bind HTML elements with C functions
+	webui_bind(window, "my_backend_func", my_backend_func);
+
+	// Set web server network port WebUI should use
+	// this mean `webui.js` will be available at:
+	// http://localhost:8081/webui.js
+	webui_set_port(window, 8081);
+
+	// Show a new window and show our custom web server
+	// Assuming the custom web server is running on port
+	// 8080...
+	webui_show(window, "http://localhost:8080/");
+
+	// Wait until all windows get closed
+	webui_wait();
+
+	// Free all memory resources (Optional)
+	webui_clean();
+
+	return 0;
+}
+
+#if defined(_MSC_VER)
+int APIENTRY WinMain(HINSTANCE hInst, HINSTANCE hInstPrev, PSTR cmdline, int cmdshow) { return main(); }
+#endif

examples/C/custom_web_server/second.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html>
+	<head>
+		<meta charset="UTF-8" />
+		<title>WebUI - Custom Web-Server second page (C99)</title>
+		<!-- Connect this window to the back-end app -->
+		<script src="http://localhost:8081/webui.js"></script>
+	</head>
+	<body>
+		<h3>This is the second page !</h3>
+		<h4><a href="index.html">Back</a></h4>
+	</body>
+</html>