How guardino/trova works
Project Type and Purpose
• This is an open-source suite of command-line utilities written in Perl.
• It contains four standalone scripts—trova.pl, confronta.pl, quale.pl, forte.pl—each providing a file-system or code-analysis function, plus a Windows build script (build.bat) to package them as executables.
Top-Level Components
• User (CLI)
• Perl Interpreter (runtime)
• Scripts (trova.pl, confronta.pl, quale.pl, forte.pl)
• Build Script (build.bat) / PAR-based packager
• File System (directories, files to search/compare)
• External Tools
• diff tool (for confronta.pl)
• Graphviz ‘dot’ (for forte.pl)
• OS PATH lookup (for quale.pl)
Interactions and Data Flows
• User invokes one of the scripts or the packaged .exe
→ Script parses arguments and options
→ Script invokes a directory/file walker (Perl’s File::Find or custom recursion)
→ Script applies regex filters or patterns to file names or contents
→ Based on flags, script may
– Print matches or counts
– Rename, delete, or substitute text in files (trova)
– Launch an external diff program to compare directories (confronta)
– Search PATH environment for executables (quale)
– Build a call graph, then invoke Graphviz dot to render an image (forte)
→ Script writes results to STDOUT, or generates files/images
Important Design Principles and Patterns
• Single-Responsibility: each script encapsulates one distinct CLI utility
• Modular option parsing: use of Getopt::Long or similar for consistent flags
• Separation of concerns:
• CLI interface → argument parsing
• Core logic → file recursion + regex matching
• External integration → system calls to diff or dot
• Platform abstraction: scripts detect OS (Windows vs. Linux) and handle path separators, packaging