calx - Display calendar, with highlighted dates
This document describes version 0.009 of calx (from Perl distribution App-calx), released on 2023-06-22.
# show calendar for the current month, with dates from Calendar::Dates::ID::Holiday % calx -c ID::Holiday # show calendar for the current month, with dates from Calendar::Dates::ID::Holiday and Calendar::Dates::SG::Holiday % calx -c ID::Holiday -c SD::Holiday # show calendar for the current month, with dates from all installed Calendar::Dates::* modules % calx -a # show calendar for the whole year % calx 2019 -c ID::Holiday # show calendar for a certain month and year % calx 2 2019 -c ID::Holiday # echo -e "2023-05-30\n2023-05-31\n2023-06-01\n" | calx
This command provides a variant of cal utility for displaying ASCII calendar on the command-line. It focuses on highlighting certain dates. It currently always starts the week at Monday and can get the list of dates from command-line option (`--date`) or stdin or one or more Calendar::Dates::* modules.
% calx [opts] [[month] year]
Most options follow cal. Not all options from cal are supported/recognized. Some options are specific to calx.
Show a single month of calendar (the default).
Show three months of calendar (previous, current, next).
Turn off highlighting of today.
Show one year (12 months) of calendar (the default if only year is specified).
Get dates from a Calendar::Dates module (value is name of module without the "Calendar::Dates::" prefix). Can be specified multiple times.
Get dates from all installed Calendar::Dates::* modules.
Calendar::Dates::*
Highlight one or more dates. You can also supply the dates from stdin. The dates must be in ISO8601 YYYY-MM-DD format.
YYYY-MM-DD
Please visit the project's homepage at https://metacpan.org/release/App-calx.
Source repository is at https://github.com/perlancar/perl-App-calx.
cal Unix utility
Calendar::Dates
cal Unix utility.
Other cal variants: cal-idn (from App::cal::idn).
perlancar <perlancar@cpan.org>
To contribute, you can send patches by email/via RT, or send pull requests on GitHub.
Most of the time, you don't need to build the distribution yourself. You can simply modify the code, then test via:
% prove -l
If you want to build the distribution (e.g. to try to install it locally on your system), you can install Dist::Zilla, Dist::Zilla::PluginBundle::Author::PERLANCAR, Pod::Weaver::PluginBundle::Author::PERLANCAR, and sometimes one or two other Dist::Zilla- and/or Pod::Weaver plugins. Any additional steps required beyond that are considered a bug and can be reported to me.
This software is copyright (c) 2023, 2019 by perlancar <perlancar@cpan.org>.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=App-calx
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
To install App::calx, copy and paste the appropriate command in to your terminal.
cpanm
cpanm App::calx
CPAN shell
perl -MCPAN -e shell install App::calx
For more information on module installation, please visit the detailed CPAN module installation guide.