cli.go 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536
  1. package raft
  2. import (
  3. "bufio"
  4. "bytes"
  5. "fmt"
  6. "net"
  7. "os"
  8. "os/exec"
  9. "path/filepath"
  10. "regexp"
  11. "runtime"
  12. "sort"
  13. "strconv"
  14. "strings"
  15. "sync"
  16. "text/tabwriter"
  17. "time"
  18. )
  19. const (
  20. ColorReset = "\033[0m"
  21. ColorDim = "\033[90m" // Dark Gray
  22. ColorRed = "\033[31m"
  23. ColorGreen = "\033[32m"
  24. ColorYellow = "\033[33m"
  25. ColorBlue = "\033[34m"
  26. ColorCyan = "\033[36m"
  27. )
  28. // CLICommand defines a CLI command handler
  29. type CLICommand struct {
  30. Name string
  31. Description string
  32. Handler func(parts []string, server *KVServer)
  33. }
  34. // CLI manages the command line interface
  35. type CLI struct {
  36. server *KVServer
  37. commands map[string]CLICommand
  38. mu sync.RWMutex
  39. }
  40. // NewCLI creates a new CLI instance
  41. func NewCLI(server *KVServer) *CLI {
  42. cli := &CLI{
  43. server: server,
  44. commands: make(map[string]CLICommand),
  45. }
  46. cli.registerDefaultCommands()
  47. return cli
  48. }
  49. // Helper to calculate visible length of string ignoring ANSI codes
  50. var ansiRegex = regexp.MustCompile(`\x1b\[[0-9;]*m`)
  51. func visibleLen(s string) int {
  52. clean := ansiRegex.ReplaceAllString(s, "")
  53. return len([]rune(clean))
  54. }
  55. func printBoxed(content string) {
  56. lines := strings.Split(strings.TrimSpace(content), "\n")
  57. maxWidth := 0
  58. for _, line := range lines {
  59. l := visibleLen(line)
  60. if l > maxWidth {
  61. maxWidth = l
  62. }
  63. }
  64. // Min width to look decent
  65. if maxWidth < 20 {
  66. maxWidth = 20
  67. }
  68. // Add padding
  69. contentWidth := maxWidth + 2
  70. fmt.Println() // Start new line before box
  71. // Top Border
  72. fmt.Printf("%s╭%s╮%s\n", ColorDim, strings.Repeat("─", contentWidth), ColorReset)
  73. // Content
  74. for _, line := range lines {
  75. visLen := visibleLen(line)
  76. padding := contentWidth - visLen - 1 // -1 for the space after │
  77. // Ensure padding is not negative
  78. if padding < 0 { padding = 0 }
  79. fmt.Printf("%s│%s %s%s%s│%s\n", ColorDim, ColorReset, line, strings.Repeat(" ", padding), ColorDim, ColorReset)
  80. }
  81. // Bottom Border
  82. fmt.Printf("%s╰%s╯%s\n", ColorDim, strings.Repeat("─", contentWidth), ColorReset)
  83. fmt.Println() // End new line after box
  84. }
  85. func formatBytes(bytes int64) string {
  86. const unit = 1024
  87. if bytes < unit {
  88. return fmt.Sprintf("%d B", bytes)
  89. }
  90. div, exp := int64(unit), 0
  91. for n := bytes / unit; n >= unit; n /= unit {
  92. div *= unit
  93. exp++
  94. }
  95. return fmt.Sprintf("%.1f %cB", float64(bytes)/float64(div), "KMGTPE"[exp])
  96. }
  97. // scanCRLF is a split function for a Scanner that returns each line of
  98. // text, stripped of any trailing end-of-line marker. The returned line may
  99. // be empty. The end-of-line marker is one optional carriage return followed
  100. // by one mandatory newline, OR just a carriage return.
  101. func scanCRLF(data []byte, atEOF bool) (advance int, token []byte, err error) {
  102. if atEOF && len(data) == 0 {
  103. return 0, nil, nil
  104. }
  105. if i := bytes.IndexByte(data, '\n'); i >= 0 {
  106. // We have a full newline-terminated line.
  107. return i + 1, dropCR(data[0:i]), nil
  108. }
  109. if i := bytes.IndexByte(data, '\r'); i >= 0 {
  110. // We have a CR-terminated line.
  111. return i + 1, data[0:i], nil
  112. }
  113. // If we're at EOF, we have a final, non-terminated line. Return it.
  114. if atEOF {
  115. return len(data), dropCR(data), nil
  116. }
  117. // Request more data.
  118. return 0, nil, nil
  119. }
  120. // dropCR drops a terminal \r from the data.
  121. func dropCR(data []byte) []byte {
  122. if len(data) > 0 && data[len(data)-1] == '\r' {
  123. return data[0 : len(data)-1]
  124. }
  125. return data
  126. }
  127. // Start starts the command line interface
  128. func (c *CLI) Start() {
  129. // Attempt to fix terminal settings if they are messed up (e.g. missing ICRNL)
  130. // This helps when Enter sends \r but the terminal driver expects \n
  131. cmd := exec.Command("stty", "sane")
  132. cmd.Stdin = os.Stdin
  133. cmd.Stdout = os.Stdout
  134. _ = cmd.Run()
  135. // Boxed startup message
  136. var sb strings.Builder
  137. sb.WriteString(fmt.Sprintf("Node %s%s%s CLI Started\n", ColorGreen, c.server.Raft.nodeID, ColorReset))
  138. sb.WriteString("Type 'help' for commands.")
  139. printBoxed(sb.String())
  140. // Initialize history handling
  141. historyPath := filepath.Join(os.TempDir(), fmt.Sprintf(".raft_history_%s", c.server.Raft.nodeID))
  142. historyFile, err := os.OpenFile(historyPath, os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
  143. if err != nil {
  144. // Just warn, don't fail
  145. fmt.Printf("%sWarning: Could not open history file: %v%s\n", ColorYellow, err, ColorReset)
  146. }
  147. defer func() {
  148. if historyFile != nil {
  149. historyFile.Close()
  150. }
  151. }()
  152. // State Monitor Loop
  153. go func() {
  154. var lastState string
  155. var lastTerm uint64
  156. stats := c.server.GetStats()
  157. lastState = stats.State
  158. lastTerm = stats.Term
  159. ticker := time.NewTicker(100 * time.Millisecond)
  160. defer ticker.Stop()
  161. for {
  162. select {
  163. case <-c.server.stopCh:
  164. return
  165. case <-ticker.C:
  166. stats := c.server.GetStats()
  167. if stats.State != lastState || stats.Term != lastTerm {
  168. msg := fmt.Sprintf("%s[State Change] %s (Term %d) -> %s (Term %d)%s",
  169. ColorYellow, lastState, lastTerm, stats.State, stats.Term, ColorReset)
  170. fmt.Printf("\n%s\n> ", msg)
  171. lastState = stats.State
  172. lastTerm = stats.Term
  173. }
  174. }
  175. }
  176. }()
  177. scanner := bufio.NewScanner(os.Stdin)
  178. scanner.Split(scanCRLF)
  179. fmt.Print("> ")
  180. for scanner.Scan() {
  181. text := strings.TrimSpace(scanner.Text())
  182. if text == "" {
  183. fmt.Print("> ")
  184. continue
  185. }
  186. // Save command to history
  187. if historyFile != nil {
  188. if _, err := historyFile.WriteString(text + "\n"); err != nil {
  189. // Ignore write error
  190. }
  191. }
  192. parts := strings.Fields(text)
  193. cmdName := strings.ToLower(parts[0])
  194. c.mu.RLock()
  195. cmd, exists := c.commands[cmdName]
  196. c.mu.RUnlock()
  197. if exists {
  198. cmd.Handler(parts, c.server)
  199. } else {
  200. // Check aliases
  201. switch cmdName {
  202. case "binlog", "db", "stats":
  203. c.mu.RLock()
  204. if infoCmd, ok := c.commands["info"]; ok {
  205. infoCmd.Handler(parts, c.server)
  206. }
  207. c.mu.RUnlock()
  208. case "history":
  209. c.printHistory(historyPath)
  210. default:
  211. printBoxed("Unknown command. Type 'help'.")
  212. }
  213. }
  214. fmt.Print("> ")
  215. }
  216. }
  217. // printHistory prints the command history
  218. func (c *CLI) printHistory(path string) {
  219. content, err := os.ReadFile(path)
  220. if err != nil {
  221. printBoxed("No history found.")
  222. return
  223. }
  224. lines := strings.Split(string(content), "\n")
  225. // Show last 20 lines
  226. start := 0
  227. if len(lines) > 20 {
  228. start = len(lines) - 20
  229. }
  230. var sb strings.Builder
  231. sb.WriteString(fmt.Sprintf("%sCommand History (Last 20):%s\n", ColorCyan, ColorReset))
  232. for i := start; i < len(lines); i++ {
  233. line := strings.TrimSpace(lines[i])
  234. if line != "" {
  235. sb.WriteString(fmt.Sprintf("%d: %s\n", i+1, line))
  236. }
  237. }
  238. printBoxed(sb.String())
  239. }
  240. // RegisterCommand registers a new CLI command
  241. func (c *CLI) RegisterCommand(name, description string, handler func(parts []string, server *KVServer)) {
  242. c.mu.Lock()
  243. defer c.mu.Unlock()
  244. c.commands[strings.ToLower(name)] = CLICommand{
  245. Name: name,
  246. Description: description,
  247. Handler: handler,
  248. }
  249. }
  250. func (c *CLI) registerDefaultCommands() {
  251. c.RegisterCommand("set", "Set value (set <key> <val>)", func(parts []string, server *KVServer) {
  252. if len(parts) != 3 {
  253. printBoxed("Usage: set <key> <value>")
  254. return
  255. }
  256. key, val := parts[1], parts[2]
  257. if err := server.Set(key, val); err != nil {
  258. printBoxed(fmt.Sprintf("%sError:%s %v", ColorRed, ColorReset, err))
  259. } else {
  260. printBoxed(fmt.Sprintf("%sOK%s", ColorGreen, ColorReset))
  261. }
  262. })
  263. c.RegisterCommand("get", "Get value (get <key>)", func(parts []string, server *KVServer) {
  264. if len(parts) != 2 {
  265. printBoxed("Usage: get <key>")
  266. return
  267. }
  268. key := parts[1]
  269. if val, ok, err := server.GetLinear(key); err != nil {
  270. printBoxed(fmt.Sprintf("%sError:%s %v", ColorRed, ColorReset, err))
  271. } else if !ok {
  272. printBoxed(fmt.Sprintf("%sNot Found%s", ColorYellow, ColorReset))
  273. } else {
  274. printBoxed(fmt.Sprintf("%s%s%s = %s%s%s", ColorCyan, key, ColorReset, ColorYellow, val, ColorReset))
  275. }
  276. })
  277. c.RegisterCommand("del", "Delete key (del <key>)", func(parts []string, server *KVServer) {
  278. if len(parts) != 2 {
  279. printBoxed("Usage: del <key>")
  280. return
  281. }
  282. key := parts[1]
  283. if err := server.Del(key); err != nil {
  284. printBoxed(fmt.Sprintf("%sError:%s %v", ColorRed, ColorReset, err))
  285. } else {
  286. printBoxed(fmt.Sprintf("%sDeleted%s", ColorGreen, ColorReset))
  287. }
  288. })
  289. c.RegisterCommand("join", "Add node to cluster (join <id> <addr>)", func(parts []string, server *KVServer) {
  290. if len(parts) != 3 {
  291. printBoxed("Usage: join <nodeID> <address>")
  292. return
  293. }
  294. nodeID := parts[1]
  295. addr := parts[2]
  296. if err := server.Join(nodeID, addr); err != nil {
  297. printBoxed(fmt.Sprintf("%sError joining node:%s %v", ColorRed, ColorReset, err))
  298. } else {
  299. printBoxed(fmt.Sprintf("%sJoin request sent for node %s%s", ColorGreen, nodeID, ColorReset))
  300. }
  301. })
  302. c.RegisterCommand("leave", "Remove node from cluster (leave <id>)", func(parts []string, server *KVServer) {
  303. if len(parts) != 2 {
  304. printBoxed("Usage: leave <nodeID>")
  305. return
  306. }
  307. nodeID := parts[1]
  308. if err := server.Leave(nodeID); err != nil {
  309. printBoxed(fmt.Sprintf("%sError leaving node:%s %v", ColorRed, ColorReset, err))
  310. } else {
  311. printBoxed(fmt.Sprintf("%sLeave request sent for node %s%s", ColorGreen, nodeID, ColorReset))
  312. }
  313. })
  314. c.RegisterCommand("search", "Search keys (search <pat> [lim] [off])", func(parts []string, server *KVServer) {
  315. if len(parts) < 2 {
  316. printBoxed("Usage: search <pattern> [limit] [offset]")
  317. return
  318. }
  319. pattern := parts[1]
  320. limit := 20 // Default limit
  321. offset := 0
  322. if len(parts) >= 3 {
  323. if l, err := strconv.Atoi(parts[2]); err == nil {
  324. limit = l
  325. }
  326. }
  327. if len(parts) >= 4 {
  328. if o, err := strconv.Atoi(parts[3]); err == nil {
  329. offset = o
  330. }
  331. }
  332. // Construct SQL for DB Engine
  333. sql := fmt.Sprintf("key like \"%s\" LIMIT %d OFFSET %d", pattern, limit, offset)
  334. results, err := server.DB.Query(sql)
  335. if err != nil {
  336. printBoxed(fmt.Sprintf("%sError:%s %v", ColorRed, ColorReset, err))
  337. return
  338. }
  339. // Format Table to Buffer
  340. var buf bytes.Buffer
  341. w := tabwriter.NewWriter(&buf, 0, 0, 2, ' ', 0)
  342. fmt.Fprintln(w, "Key\tValue\tCommitIndex")
  343. fmt.Fprintln(w, "---\t-----\t-----------")
  344. for _, r := range results {
  345. fmt.Fprintf(w, "%s\t%s\t%d\n", r.Key, r.Value, r.CommitIndex)
  346. }
  347. w.Flush()
  348. summary := fmt.Sprintf("\n%sFound %d records (showing max %d)%s", ColorDim, len(results), limit, ColorReset)
  349. printBoxed(buf.String() + summary)
  350. })
  351. c.RegisterCommand("count", "Count keys (count <pat>)", func(parts []string, server *KVServer) {
  352. if len(parts) < 2 {
  353. printBoxed("Usage: count <pattern> (e.g. 'count *', 'count user.*')")
  354. return
  355. }
  356. pattern := parts[1]
  357. sql := ""
  358. if pattern == "*" {
  359. sql = "*"
  360. } else {
  361. sql = fmt.Sprintf("key like \"%s\"", pattern)
  362. }
  363. start := time.Now()
  364. count, err := server.DB.Count(sql)
  365. duration := time.Since(start)
  366. if err != nil {
  367. printBoxed(fmt.Sprintf("%sError:%s %v", ColorRed, ColorReset, err))
  368. } else {
  369. printBoxed(fmt.Sprintf("%sCount: %d%s (took %v)", ColorGreen, count, ColorReset, duration))
  370. }
  371. })
  372. c.RegisterCommand("info", "Show all system stats", func(parts []string, server *KVServer) {
  373. // 1. Gather all data
  374. var m runtime.MemStats
  375. runtime.ReadMemStats(&m)
  376. dbSize := server.GetDBSize()
  377. logSize := server.GetLogSize()
  378. stats := server.GetStats()
  379. health := server.HealthCheck()
  380. dbApplied := server.DB.GetLastAppliedIndex()
  381. // 2. Build Output
  382. var sb strings.Builder
  383. // Section: Node Status
  384. sb.WriteString(fmt.Sprintf("%sNode Status:%s\n", ColorCyan, ColorReset))
  385. sb.WriteString(fmt.Sprintf(" ID: %s%s%s\n", ColorGreen, health.NodeID, ColorReset))
  386. sb.WriteString(fmt.Sprintf(" State: %s\n", health.State))
  387. sb.WriteString(fmt.Sprintf(" Term: %d\n", health.Term))
  388. sb.WriteString(fmt.Sprintf(" Leader: %s\n", health.LeaderID))
  389. sb.WriteString(fmt.Sprintf(" Healthy: %v\n", health.IsHealthy))
  390. sb.WriteString("\n")
  391. // Section: Storage Stats
  392. sb.WriteString(fmt.Sprintf("%sStorage & Memory:%s\n", ColorCyan, ColorReset))
  393. sb.WriteString(fmt.Sprintf(" DB Size: %s\n", formatBytes(dbSize)))
  394. sb.WriteString(fmt.Sprintf(" Raft Log: %s\n", formatBytes(logSize)))
  395. sb.WriteString(fmt.Sprintf(" Mem Alloc: %s\n", formatBytes(int64(m.Alloc))))
  396. sb.WriteString(fmt.Sprintf(" Mem Sys: %s\n", formatBytes(int64(m.Sys))))
  397. sb.WriteString(fmt.Sprintf(" NumGC: %d\n", m.NumGC))
  398. sb.WriteString("\n")
  399. // Section: Raft & DB Indices
  400. sb.WriteString(fmt.Sprintf("%sConsensus Indices:%s\n", ColorCyan, ColorReset))
  401. sb.WriteString(fmt.Sprintf(" Commit Index: %d\n", stats.CommitIndex))
  402. sb.WriteString(fmt.Sprintf(" Applied Index:%d\n", stats.LastApplied))
  403. sb.WriteString(fmt.Sprintf(" Last Log Idx: %d\n", stats.LastLogIndex))
  404. sb.WriteString(fmt.Sprintf(" DB Applied: %d\n", dbApplied))
  405. sb.WriteString("\n")
  406. // Section: Cluster Members
  407. sb.WriteString(fmt.Sprintf("%sCluster Members (%d):%s", ColorCyan, stats.ClusterSize, ColorReset))
  408. for id, addr := range stats.ClusterNodes {
  409. // Determine status color
  410. statusColor := ColorDim
  411. nodeID := server.Raft.nodeID // Assuming local nodeID is accessible
  412. if id == nodeID {
  413. statusColor = ColorCyan // Self
  414. } else {
  415. // Quick check
  416. conn, err := net.DialTimeout("tcp", addr, 50*time.Millisecond)
  417. if err == nil {
  418. statusColor = ColorGreen
  419. conn.Close()
  420. }
  421. }
  422. // Marker for Leader
  423. marker := ""
  424. if id == health.LeaderID {
  425. marker = fmt.Sprintf(" %s(Leader)%s", ColorYellow, ColorReset)
  426. }
  427. sb.WriteString(fmt.Sprintf("\n - %s%s%s: %s%s", statusColor, id, ColorReset, addr, marker))
  428. }
  429. printBoxed(sb.String())
  430. })
  431. c.RegisterCommand("quit", "Gracefully shutdown the node", func(parts []string, server *KVServer) {
  432. printBoxed("Shutting down node...")
  433. if err := server.Stop(); err != nil {
  434. printBoxed(fmt.Sprintf("%sError stopping server:%s %v", ColorRed, ColorReset, err))
  435. } else {
  436. printBoxed(fmt.Sprintf("%sNode stopped successfully.%s", ColorGreen, ColorReset))
  437. }
  438. os.Exit(0)
  439. })
  440. c.RegisterCommand("clear", "Clear screen", func(parts []string, server *KVServer) {
  441. fmt.Print("\033[H\033[2J")
  442. })
  443. c.RegisterCommand("help", "Show commands", func(parts []string, server *KVServer) {
  444. var sb strings.Builder
  445. sb.WriteString(fmt.Sprintf("%sCommands:%s\n", ColorGreen, ColorReset))
  446. // Sort commands
  447. c.mu.RLock()
  448. var cmds []CLICommand
  449. for _, cmd := range c.commands {
  450. cmds = append(cmds, cmd)
  451. }
  452. c.mu.RUnlock()
  453. sort.Slice(cmds, func(i, j int) bool {
  454. return cmds[i].Name < cmds[j].Name
  455. })
  456. // Find max length for padding
  457. maxNameLen := 0
  458. for _, cmd := range cmds {
  459. if len(cmd.Name) > maxNameLen {
  460. maxNameLen = len(cmd.Name)
  461. }
  462. }
  463. for _, cmd := range cmds {
  464. padding := strings.Repeat(" ", maxNameLen-len(cmd.Name))
  465. sb.WriteString(fmt.Sprintf(" %s%s%s%s %s%s%s\n", ColorGreen, cmd.Name, ColorReset, padding, ColorDim, cmd.Description, ColorReset))
  466. }
  467. printBoxed(sb.String())
  468. })
  469. }