oculus 0.1.3

Unified telemetry system for monitoring and observability
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

# Oculus Makefile

.DEFAULT_GOAL := all

# =============================================================================
# Configuration
# =============================================================================
CARGO            := cargo
CARGO_FLAGS      := --locked
TAILWIND_BIN     := ./tools/tailwindcss
TAILWIND_INPUT   := templates/static/css/tailwind.input.css
TAILWIND_OUTPUT  := templates/static/css/tailwind.css
TAILWIND_CONTENT := "templates/**/*.html src/**/*.rs"

# =============================================================================
# PHONY Targets
# =============================================================================
.PHONY: all fmt lint lint-rust lint-md check test doc doc-open build release install run download-tailwind tailwind tailwind-watch clean help

# =============================================================================
# Development Workflow
# =============================================================================

## Primary Targets
all: fmt lint check test-all doc build    ## Run full CI pipeline

## Code Quality
fmt:                                  ## Format code with rustfmt
	@echo "Formatting code..."
	@$(CARGO) fmt

lint: lint-rust lint-md               ## Run all linters

lint-rust:                            ## Lint Rust code with clippy
	@echo "Linting Rust code..."
	@$(CARGO) clippy $(CARGO_FLAGS) --all-targets --all-features -- -D warnings

lint-md:                              ## Lint Markdown files
	@echo "Linting Markdown files..."
	@markdownlint .

check:                                ## Type-check without building
	@echo "Type-checking code..."
	@$(CARGO) check $(CARGO_FLAGS) --all-targets --all-features

# =============================================================================
# Testing
# =============================================================================

test:                                 ## Run unit tests
	@echo "Running unit tests..."
	@$(CARGO) test $(CARGO_FLAGS) --lib --bins

test-integration:                     ## Run integration tests
	@echo "Running integration tests..."
	@$(CARGO) test $(CARGO_FLAGS) --test '*'

test-all:                             ## Run all tests (unit + integration + doc)
	@echo "Running all tests..."
	@$(CARGO) test $(CARGO_FLAGS) --all-targets --all-features

# =============================================================================
# Documentation
# =============================================================================

doc:                                  ## Build documentation
	@echo "Building documentation..."
	@$(CARGO) doc $(CARGO_FLAGS) --no-deps

doc-open:                             ## Build and open documentation
	@echo "Building and opening documentation..."
	@$(CARGO) doc $(CARGO_FLAGS) --no-deps --open

# =============================================================================
# Build & Run
# =============================================================================

build: tailwind                       ## Build debug binary
	@echo "Building debug binary..."
	@$(CARGO) build $(CARGO_FLAGS)

release: tailwind                     ## Build optimized release binary
	@echo "Building release binary..."
	@$(CARGO) build $(CARGO_FLAGS) --release

install: tailwind                      ## Install binary to ~/.cargo/bin
	@echo "Installing oculus..."
	@$(CARGO) install $(CARGO_FLAGS) --path .
run: tailwind                          ## Run (use ARGS="..." for arguments)
	@$(CARGO) run $(CARGO_FLAGS) -- $(ARGS)
# =============================================================================
# Assets
# =============================================================================

download-tailwind:                    ## Download Tailwind CSS CLI if not present
	@if [ ! -f $(TAILWIND_BIN) ]; then \
		echo "Downloading Tailwind CSS CLI..."; \
		mkdir -p tools; \
		curl -sL https://github.com/tailwindlabs/tailwindcss/releases/latest/download/tailwindcss-macos-arm64 -o $(TAILWIND_BIN); \
		chmod +x $(TAILWIND_BIN); \
		echo "✓ Tailwind CSS CLI installed to $(TAILWIND_BIN)"; \
	else \
		echo "✓ Tailwind CSS CLI already present"; \
	fi

tailwind: download-tailwind           ## Build bundled Tailwind CSS (offline)
	@echo "Building Tailwind CSS..."
	@mkdir -p $(dir $(TAILWIND_OUTPUT))
	@test -f $(TAILWIND_INPUT) || { echo "Missing $(TAILWIND_INPUT); add @import \"tailwindcss\""; exit 1; }
	@$(TAILWIND_BIN) -i $(TAILWIND_INPUT) -o $(TAILWIND_OUTPUT) --minify --content $(TAILWIND_CONTENT)

# =============================================================================
# Maintenance
# =============================================================================

clean:                                ## Remove build artifacts
	@echo "Cleaning build artifacts..."
	@$(CARGO) clean

update:                               ## Update dependencies
	@echo "Updating dependencies..."
	@$(CARGO) update

# =============================================================================
# Help
# =============================================================================

help:                                 ## Show available targets
	@echo "Oculus - Available targets:"
	@echo ""
	@awk 'BEGIN {FS = ":.*##"} /^[a-zA-Z_-]+:.*##/ { \
		printf "  \033[36m%-18s\033[0m %s\n", $$1, $$2 \
	}' $(MAKEFILE_LIST)
	@echo ""
	@echo "Examples:"
	@echo "  make                # Run full CI pipeline"
	@echo "  make run ARGS='--help'"