How arsalanyavari/scal works
Project type and purpose
• This is a small suite of UNIX-style command-line utilities (“scal”, “sdate”, “sstat”) written in Rust.
• Purpose:
• scal: display Jalali (Shamsi) calendars
• sdate: convert between Jalali and Gregorian dates
• sstat: display file system stats with Jalali dates
File structure
• Top-level: Cargo.toml (Rust workspace), LICENSE, README, .github/ workflows for CI and binary/package releases, man/ pages.
• src/bin/: three binaries (scal.rs, sdate.rs, sstat.rs) each containing the CLI entry point.
• src/lib.rs: shared library with core logic (calendar calculations, date conversions, file-stat formatting).
• tests/: integration tests targeting library and bin behavior.
Insights from README
• Confirms the three CLI tools, their flags and subcommands.
• Mentions fixed leap-year bugs and added sstat.
• Packaging targets (deb, rpm, zip) via CI workflows.
Final advice
• Every layer: user input → CLI parsing → core logic → OS.
• Don’t forget documentation (man pages) and CI/CD as first-class elements.
• Aim for clarity: a reader should instantly see “three binaries share one library” and “OS & CI boundaries.”