oculus 0.1.1

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

# 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 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 all tests
	@echo "Running 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'"