using System.Windows; using AxCopilot.SDK; using AxCopilot.Services; using AxCopilot.Themes; namespace AxCopilot.Handlers; /// /// L11-3: Cron 표현식 설명기 핸들러. "cron" 프리픽스로 사용합니다. /// /// 예: cron * * * * * → 매 분 실행 (설명 + 다음 5회 실행 시간) /// cron 0 9 * * 1-5 → 평일 오전 9시 실행 /// cron 0 0 1 * * → 매월 1일 자정 /// cron 30 18 * * 5 → 매주 금요일 오후 6시 30분 /// cron @daily → 매일 자정 (특수 키워드) /// cron @hourly → 매시간 /// Enter → 표현식을 클립보드에 복사. /// /// 지원 형식: 분(0-59) 시(0-23) 일(1-31) 월(1-12) 요일(0-7) /// public class CronHandler : IActionHandler { public string? Prefix => "cron"; public PluginMetadata Metadata => new( "Cron", "Cron 표현식 설명기 — 다음 실행 시간 · 한국어 설명", "1.0", "AX"); // 특수 키워드 private static readonly Dictionary SpecialKeywords = new(StringComparer.OrdinalIgnoreCase) { ["@yearly"] = "0 0 1 1 *", ["@annually"] = "0 0 1 1 *", ["@monthly"] = "0 0 1 * *", ["@weekly"] = "0 0 * * 0", ["@daily"] = "0 0 * * *", ["@midnight"] = "0 0 * * *", ["@hourly"] = "0 * * * *", }; // 자주 쓰는 예제 private static readonly (string Expr, string Desc)[] CommonExamples = [ ("* * * * *", "매 분 실행"), ("0 * * * *", "매 시간 정각"), ("0 9 * * *", "매일 오전 9시"), ("0 9 * * 1-5", "평일 오전 9시"), ("0 0 * * *", "매일 자정"), ("0 0 1 * *", "매월 1일 자정"), ("0 0 1 1 *", "매년 1월 1일"), ("*/5 * * * *", "5분마다"), ("0 9,18 * * 1-5", "평일 오전 9시·오후 6시"), ("30 23 * * 5", "매주 금요일 오후 11시 30분"), ]; public Task> GetItemsAsync(string query, CancellationToken ct) { var q = query.Trim(); var items = new List(); if (string.IsNullOrWhiteSpace(q)) { items.Add(new LauncherItem("Cron 표현식 설명기", "예: cron 0 9 * * 1-5 / cron @daily / cron */15 * * * *", null, null, Symbol: "\uE823")); foreach (var (expr, desc) in CommonExamples.Take(6)) items.Add(new LauncherItem(expr, desc, null, ("copy", expr), Symbol: "\uE823")); return Task.FromResult>(items); } // 특수 키워드 처리 var expr_ = q; if (SpecialKeywords.TryGetValue(q, out var expanded)) expr_ = expanded; if (!TryParseCron(expr_, out var cron)) { items.Add(new LauncherItem("파싱 실패", $"'{q}'은 유효한 cron 표현식이 아닙니다. 형식: 분 시 일 월 요일", null, null, Symbol: "\uE783")); return Task.FromResult>(items); } // 한국어 설명 var description = Describe(cron); items.Add(new LauncherItem( description, $"표현식: {expr_} · Enter 복사", null, ("copy", expr_), Symbol: "\uE823")); // 다음 5회 실행 시간 var nextRuns = GetNextRuns(cron, DateTime.Now, 5); if (nextRuns.Count > 0) { items.Add(new LauncherItem("─ 다음 실행 시간 ─", "", null, null, Symbol: "\uE823")); foreach (var run in nextRuns) items.Add(new LauncherItem( run.ToString("yyyy-MM-dd HH:mm (ddd)"), GetRelativeTime(run), null, ("copy", run.ToString("yyyy-MM-dd HH:mm:ss")), Symbol: "\uE823")); } // 필드별 설명 items.Add(new LauncherItem("─ 필드 분석 ─", "", null, null, Symbol: "\uE823")); items.Add(new LauncherItem("분", DescribeField(cron.Minute, 0, 59, "분"), null, null, Symbol: "\uE823")); items.Add(new LauncherItem("시", DescribeField(cron.Hour, 0, 23, "시"), null, null, Symbol: "\uE823")); items.Add(new LauncherItem("일", DescribeField(cron.Day, 1, 31, "일"), null, null, Symbol: "\uE823")); items.Add(new LauncherItem("월", DescribeField(cron.Month, 1, 12, "월"), null, null, Symbol: "\uE823")); items.Add(new LauncherItem("요일", DescribeField(cron.DayOfWeek, 0, 7, "요일"), null, null, Symbol: "\uE823")); return Task.FromResult>(items); } public Task ExecuteAsync(LauncherItem item, CancellationToken ct) { if (item.Data is ("copy", string text)) { try { System.Windows.Application.Current.Dispatcher.Invoke( () => Clipboard.SetText(text)); NotificationService.Notify("Cron", "클립보드에 복사했습니다."); } catch { /* 비핵심 */ } } return Task.CompletedTask; } // ── Cron 파서 ───────────────────────────────────────────────────────────── private record CronExpr(string Minute, string Hour, string Day, string Month, string DayOfWeek); private static bool TryParseCron(string expr, out CronExpr result) { result = new CronExpr("*", "*", "*", "*", "*"); var parts = expr.Trim().Split(' ', StringSplitOptions.RemoveEmptyEntries); if (parts.Length != 5) return false; // 각 필드 유효성 검사 if (!IsValidCronField(parts[0], 0, 59)) return false; if (!IsValidCronField(parts[1], 0, 23)) return false; if (!IsValidCronField(parts[2], 1, 31)) return false; if (!IsValidCronField(parts[3], 1, 12)) return false; if (!IsValidCronField(parts[4], 0, 7)) return false; result = new CronExpr(parts[0], parts[1], parts[2], parts[3], parts[4]); return true; } private static bool IsValidCronField(string field, int min, int max) { if (field == "*") return true; foreach (var part in field.Split(',')) { if (part.Contains('/')) { var sp = part.Split('/'); if (sp.Length != 2) return false; if (sp[0] != "*" && !int.TryParse(sp[0], out _)) return false; if (!int.TryParse(sp[1], out var step) || step < 1) return false; } else if (part.Contains('-')) { var sp = part.Split('-'); if (sp.Length != 2) return false; if (!int.TryParse(sp[0], out var a) || !int.TryParse(sp[1], out var b)) return false; if (a < min || b > max || a > b) return false; } else { if (!int.TryParse(part, out var v)) return false; if (v < min || v > max) return false; } } return true; } // ── 다음 실행 시간 계산 ──────────────────────────────────────────────────── private static List GetNextRuns(CronExpr cron, DateTime from, int count) { var results = new List(); // 다음 분부터 시작 var current = from.AddSeconds(-from.Second).AddMinutes(1); var limit = from.AddDays(366); // 최대 1년 탐색 while (results.Count < count && current < limit) { if (MatchesMonth(cron.Month, current.Month) && MatchesDay(cron.Day, current.Day) && MatchesDayOfWeek(cron.DayOfWeek, (int)current.DayOfWeek) && MatchesHour(cron.Hour, current.Hour) && MatchesMinute(cron.Minute, current.Minute)) { results.Add(current); current = current.AddMinutes(1); } else { current = AdvanceCron(cron, current); } } return results; } private static DateTime AdvanceCron(CronExpr cron, DateTime dt) { // 빠른 스킵: 분 단위로 증가 return dt.AddMinutes(1); } private static bool MatchesField(string field, int value, int min, int max) { if (field == "*") return true; foreach (var part in field.Split(',')) { if (part.Contains('/')) { var sp = part.Split('/'); var step = int.Parse(sp[1]); var start = sp[0] == "*" ? min : int.Parse(sp[0]); for (var v = start; v <= max; v += step) if (v == value) return true; } else if (part.Contains('-')) { var sp = part.Split('-'); var a = int.Parse(sp[0]); var b = int.Parse(sp[1]); if (value >= a && value <= b) return true; } else { if (int.Parse(part) == value) return true; } } return false; } private static bool MatchesMinute(string f, int v) => MatchesField(f, v, 0, 59); private static bool MatchesHour(string f, int v) => MatchesField(f, v, 0, 23); private static bool MatchesDay(string f, int v) => MatchesField(f, v, 1, 31); private static bool MatchesMonth(string f, int v) => MatchesField(f, v, 1, 12); private static bool MatchesDayOfWeek(string f, int v) { // 0과 7 모두 일요일 if (f == "*") return true; return MatchesField(f, v, 0, 7) || (v == 0 && MatchesField(f, 7, 0, 7)); } // ── 한국어 설명 ─────────────────────────────────────────────────────────── private static string Describe(CronExpr c) { var parts = new List(); // 분 var minDesc = c.Minute == "*" ? "매 분" : DescribeField(c.Minute, 0, 59, "분"); // 시 var hourDesc = c.Hour == "*" ? "매 시간" : DescribeField(c.Hour, 0, 23, "시"); // 일 var dayDesc = c.Day == "*" ? "" : DescribeField(c.Day, 1, 31, "일"); // 월 var monDesc = c.Month == "*" ? "" : DescribeField(c.Month, 1, 12, "월"); // 요일 var dowDesc = c.DayOfWeek == "*" ? "" : DescribeWeekday(c.DayOfWeek); if (c.Minute == "0" && c.Hour == "0" && c.Day == "*" && c.Month == "*" && c.DayOfWeek == "*") return "매일 자정(00:00)"; if (c.Minute == "0" && c.Hour == "*") return "매 시간 정각"; if (c.Minute == "*" && c.Hour == "*" && c.Day == "*" && c.Month == "*" && c.DayOfWeek == "*") return "매 분 실행"; // 조합 var sb = new System.Text.StringBuilder(); if (!string.IsNullOrEmpty(monDesc)) { sb.Append(monDesc); sb.Append(' '); } if (!string.IsNullOrEmpty(dayDesc)) { sb.Append(dayDesc); sb.Append(' '); } if (!string.IsNullOrEmpty(dowDesc)) { sb.Append(dowDesc); sb.Append(' '); } sb.Append(hourDesc); sb.Append(' '); sb.Append(minDesc); sb.Append(" 실행"); return sb.ToString().Trim(); } private static string DescribeField(string field, int min, int max, string unit) { if (field == "*") return $"모든 {unit}"; if (field.StartsWith("*/")) { var step = field[2..]; return $"{step}{unit}마다"; } if (field.Contains('-')) { var sp = field.Split('-'); return $"{sp[0]}~{sp[1]}{unit}"; } if (field.Contains(',')) { return string.Join(",", field.Split(',')) + unit; } return $"{field}{unit}"; } private static string DescribeWeekday(string field) { string[] days = ["일", "월", "화", "수", "목", "금", "토", "일"]; if (field.Contains('-')) { var sp = field.Split('-'); if (int.TryParse(sp[0], out var a) && int.TryParse(sp[1], out var b)) return $"{days[a]}~{days[Math.Min(b, 7)]}요일"; } if (field.Contains(',')) { var parts = field.Split(',') .Where(p => int.TryParse(p, out _)) .Select(p => days[int.Parse(p) % 8]); return string.Join(",", parts) + "요일"; } if (int.TryParse(field, out var d)) return days[d % 8] + "요일"; return field; } private static string GetRelativeTime(DateTime dt) { var diff = dt - DateTime.Now; if (diff.TotalMinutes < 1) return "1분 이내"; if (diff.TotalHours < 1) return $"{(int)diff.TotalMinutes}분 후"; if (diff.TotalDays < 1) return $"{(int)diff.TotalHours}시간 {diff.Minutes}분 후"; if (diff.TotalDays < 7) return $"{(int)diff.TotalDays}일 {diff.Hours}시간 후"; return $"{(int)diff.TotalDays}일 후"; } }