apicentric 0.7.0

Toolkit for building, recording, and sharing mock APIs
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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145

#   ___  ______ _____ _____ _____ _   _ _____ ______ _____ _____ 
#  / _ \ | ___ \_   _/  __ \  ___| \ | |_   _|| ___ \_   _/  __ \
# / /_\ \| |_/ / | | | /  \/ |__ |  \| | | |  | |_/ / | | | /  \/
# |  _  ||  __/  | | | |   |  __|| . ` | | |  |    /  | | | |    
# | | | || |    _| |_| \__/\ |___| |\  | | |  | |\ \ _| |_| \__/\
# \_| |_/\_|    \___/ \____\____/\_| \_/ \_/  \_| \_|\___/ \____/
#                                                                
# High-performance API Simulator & Digital Twin Framework

.PHONY: all help build build-backend build-frontend run dev test lint format clean docker-build package doctor demo install

# Variables
BINARY=target/debug/apicentric
RELEASE_BINARY=target/release/apicentric
SERVICES_DIR=examples
DB_PATH=data/apicentric.db

# Default target
all: build

help:
	@printf '                                                                \n'
	@printf '  \033[1;36m___  ______ _____ _____ _____ _   _ _____ ______ _____ _____ \033[0m\n'
	@printf '  \033[1;36m/ _ \\ | ___ \\_   _/  __ \\  ___| \\ | |_   _|| ___ \\_   _/  __ \\\\ \033[0m\n'
	@printf '  \033[1;36m/ /_\\ \\| |_/ / | | | /  \\/ |__ |  \\| | | |  | |_/ / | | | /  \\/\033[0m\n'
	@printf '  \033[1;36m|  _  ||  __/  | | | |   |  __|| . ` | | |  |    /  | | | |    \033[0m\n'
	@printf '  \033[1;36m| | | || |    _| |_| \\__/\\ |___| |\\  | | |  | |\\ \\ _| |_| \\__/\033[0m\n'
	@printf '  \033[1;36m\\_| |_/\\_|    \\___/ \\____\\____/\\_| \\_/ \\_/  \\_| \\_|\\___/ \\____/\033[0m\n'
	@printf '                                                                \n'
	@printf '  \033[1;33m⚡ Core Commands:\033[0m\n'
	@printf '    \033[1;32mmake build\033[0m          - 🏗️  Build complete project (Backend & Frontend)\n'
	@printf '    \033[1;32mmake run\033[0m            - 🏃 Start simulator with examples\n'
	@printf '    \033[1;32mmake dev\033[0m            - 🚀 Hot-reload development environment\n'
	@printf '    \033[1;32mmake wizard\033[0m         - 🧙 Interactive project management wizard\n'
	@printf '  \n'
	@printf '  \033[1;33m🎮 Interfaces:\033[0m\n'
	@printf '    \033[1;32mmake tui\033[0m            - 🖥️  Launch Terminal User Interface\n'
	@printf '    \033[1;32mmake gui\033[0m            - 🎨 Launch Desktop GUI Administration\n'
	@printf '  \n'
	@printf '  \033[1;33m🔬 Simulation & Testing:\033[0m\n'
	@printf '    \033[1;32mmake twin\033[0m           - 🤖 Run IoT Digital Twin simulator\n'
	@printf '    \033[1;32mmake contract\033[0m       - 📝 Execute contract-driven API tests\n'
	@printf '    \033[1;32mmake cloud\033[0m          - ☁️  Start server in cloud-ready mode\n'
	@printf '  \n'
	@printf '  \033[1;33m🛠️  Development & QA:\033[0m\n'
	@printf '    \033[1;32mmake test\033[0m           - 🧪 Run full test suite\n'
	@printf '    \033[1;32mmake lint\033[0m           - 🧹 Static analysis & linting\n'
	@printf '    \033[1;32mmake format\033[0m         - 🎨 Auto-format all source code\n'
	@printf '    \033[1;32mmake doctor\033[0m         - 🩺 Run project diagnostics\n'
	@printf '  \n'
	@printf '  \033[1;33m📦 Distribution:\033[0m\n'
	@printf '    \033[1;32mmake package\033[0m        - 📦 Create production tarball\n'
	@printf '    \033[1;32mmake docker-build\033[0m   - 🐳 Build release Docker image\n'
	@printf '    \033[1;32mmake demo\033[0m           - 🎬 Run visual demonstration\n'
	@printf '  \n'
	@printf '  \033[1;33m🧹 Utility:\033[0m\n'
	@printf '    \033[1;32mmake clean\033[0m          - 🗑️  Deep clean build artifacts\n'
	@printf '    \033[1;32mmake install\033[0m        - 📥 Bootstrap dependencies\n'
	@printf '  \n'
install:
	@echo "📦 Installing dependencies..."
	cargo fetch
	cd webui && npm install

build: build-backend build-frontend

build-backend:
	@echo "🦀 Building backend (debug)..."
	cargo build --features full

build-frontend:
	@echo "📦 Building frontend..."
	cd webui && npm run build

run: build-backend
	@echo "🏃 Starting simulator..."
	mkdir -p data
	$(BINARY) --db-path $(DB_PATH) simulator start --services-dir $(SERVICES_DIR)

dev:
	@echo "🚀 Starting development environment..."
	# This runs both in parallel, might need adjustment for local workflow
	(cargo watch -x run & cd webui && npm run dev)

test:
	@echo "🧪 Running tests..."
	cargo test
	# Run scripts/test_mcp.sh if it exists
	@[ -f scripts/test_mcp.sh ] && ./scripts/test_mcp.sh || echo "No MCP tests found"

lint:
	@echo "🧹 Linting..."
	cargo clippy -- -D warnings
	cd webui && npm run lint

format:
	@echo "🎨 Formatting..."
	cargo fmt
	cd webui && npm run format

clean:
	@echo "🧹 Cleaning up..."
	cargo clean
	rm -rf webui/.next
	rm -rf logs/*
	rm -rf demo_output

doctor: build-backend
	@$(BINARY) doctor

demo: build-backend
	@echo "🎬 Running demo..."
	./scripts/demo_all.sh

package:
	@echo "📦 Packaging for production..."
	./scripts/build-production.sh

tui: build-backend
	@echo "🖥️  Launching TUI..."
	$(BINARY) tui

gui: build-backend
	@echo "🎨 Launching GUI..."
	$(BINARY) gui

twin: build-backend
	@echo "🤖 Starting IoT Digital Twin..."
	$(BINARY) twin run --device examples/iot/smarthome/thermostat-nest.yaml

contract: build-backend
	@echo "📝 Running contract tests..."
	$(BINARY) simulator test --path examples/iot/smarthome/thermostat-nest.yaml --url http://localhost:9005

cloud: build-backend
	@echo "☁️  Starting cloud mode..."
	$(BINARY) cloud --port 8080

wizard:
	@chmod +x scripts/wizard.sh
	@./scripts/wizard.sh

docker-build:
	@echo "🐳 Building Docker images..."
	docker build -t apicentric:latest .