Title: Day 4 - Build SentinelCLI (Flagship Project #1)

[CharlesKariuki-001]

Goal

Learn collections (lists, dicts, tuples, sets, comprehensions, nested data) and use them to build the first real flagship project: SentinelCLI, a small toolkit that inspects a file (CSV/JSON/TXT), summarizes it, and flags suspicious lines in log files.

Tasks

• Learn lists, dicts, tuples, sets, comprehensions, and nested data
• Build sentinel.py with functions to inspect CSV, JSON, and TXT/log files
• Use a set for suspicious keyword matching (not a list)
• Add at least one list comprehension somewhere in the code
• Write sample test files (a CSV, a JSON, a log file with some suspicious lines)
• Break it: run it on a malformed file, an empty file, and a huge file
• Write a full README for the project (problem, install, usage, examples, limitations)
• Write NOTES.md explaining what broke and how this connects to real systems

Acceptance Criteria

• Running python sentinel.py <file> correctly identifies file type and prints a report
• Empty files are handled gracefully, not with a raw crash
• Malformed files produce a clear, readable error, not a stack trace dump
• At least 3 suspicious keywords are correctly flagged in the sample log file
• README clearly explains how a stranger could install and run this

Labels

day-4, phase-1, flagship-project, collections