zaz 0.0.1

cross-platform textual UI toolkit with bindings for Rust, C++, Zig and etc
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

.PHONY: all clean bindings lib zig-example help test

# Default target
all: bindings zig-example

# Build the Rust library (cdylib for C bindings)
lib:
	@echo "Building Rust library..."
	cargo build --release

# Generate C bindings header
bindings: lib
	@echo "C header generated at: bindings/h"

# Build Zig examples
zig-example: bindings zig-basic zig-mosaic

zig-basic: bindings
	@echo "Building Zig basic example..."
	@if ! command -v zig &> /dev/null; then \
		echo "Error: zig not found. Please install Zig from https://ziglang.org/"; \
		exit 1; \
	fi
	cd bindings/zig && zig build -Doptimize=ReleaseSafe

zig-mosaic: zig-basic
	@echo "Zig mosaic example built with basic example"

# Run Zig basic example
run-zig: zig-basic
	@echo "Running Zig basic example..."
	@echo "Note: This requires a terminal (TTY). Run directly if make fails:"
	@echo "  On macOS:   DYLD_LIBRARY_PATH=target/release ./bindings/zig/zig-out/bin/basic"
	@echo "  On Linux:   LD_LIBRARY_PATH=target/release ./bindings/zig/zig-out/bin/basic"
	@echo ""
	@if [ "$(shell uname)" = "Darwin" ]; then \
		DYLD_LIBRARY_PATH=target/release ./bindings/zig/zig-out/bin/basic; \
	else \
		LD_LIBRARY_PATH=target/release ./bindings/zig/zig-out/bin/basic; \
	fi

# Run Zig mosaic example
run-zig-mosaic: zig-mosaic
	@echo "Running Zig mosaic example..."
	@echo "Note: This requires a terminal (TTY). Run directly if make fails:"
	@echo "  On macOS:   DYLD_LIBRARY_PATH=target/release ./bindings/zig/zig-out/bin/mosaic"
	@echo "  On Linux:   LD_LIBRARY_PATH=target/release ./bindings/zig/zig-out/bin/mosaic"
	@echo ""
	@if [ "$(shell uname)" = "Darwin" ]; then \
		DYLD_LIBRARY_PATH=target/release ./bindings/zig/zig-out/bin/mosaic; \
	else \
		LD_LIBRARY_PATH=target/release ./bindings/zig/zig-out/bin/mosaic; \
	fi

# Run Rust tests
test:
	@echo "Running Rust tests..."
	cargo test

# Clean build artifacts
clean:
	@echo "Cleaning build artifacts..."
	cargo clean
	rm -rf bindings/zig/zig-out
	rm -rf bindings/zig/.zig-cache

# Display help
help:
	@echo "Library Bindings - Makefile targets:"
	@echo ""
	@echo "  make                - Build everything (lib + bindings + zig examples)"
	@echo "  make lib            - Build the Rust library"
	@echo "  make bindings       - Generate C header file"
	@echo "  make zig-example    - Build all Zig examples"
	@echo "  make zig-basic      - Build basic Zig example"
	@echo "  make zig-mosaic     - Build mosaic Zig example"
	@echo "  make run-zig        - Build and run basic Zig example"
	@echo "  make run-zig-mosaic - Build and run mosaic Zig example"
	@echo "  make test           - Run Rust tests"
	@echo "  make clean          - Remove all build artifacts"
	@echo "  make help           - Show this help message"
	@echo ""
	@echo "Requirements:"
	@echo "  - Rust (cargo)"
	@echo "  - Zig compiler (for building Zig examples)"
	@echo ""