heatmap_cli
A console program that generates yearly calendar heatmap.
Installation
Stable version From PyPI using pipx:
uv tool install heatmap_cli
Stable version From PyPI using pip:
uv tool upgrade heatmap_cli
Usage
heatmap -h -v
usage: heatmap_cli [--demo [NUMBER_OF_COLORMAP]] [--seed SEED] [-y YEAR]
[-w WEEK] [-e END_DATE] [-s START_DATE] [-O OUTPUT_DIR]
[-o] [-p] [-t TITLE] [-u AUTHOR] [-f IMAGE_FORMAT]
[-c COLORMAP] [-i COLORMAP_MIN_VALUE]
[-x COLORMAP_MAX_VALUE] [-b]
[-a | --annotate | --no-annotate] [--animate-by-week] [-q]
[-Y] [-d] [-E] [-V] [-h]
[CSV_FILENAME]
A console program that generates yearly calendar heatmap.
website: https://github.com/kianmeng/heatmap_cli
changelog: https://github.com/kianmeng/heatmap_cli/blob/master/CHANGELOG.md
issues: https://github.com/kianmeng/heatmap_cli/issues
positional arguments:
CSV_FILENAME
CSV filename (required unless --demo is used)
options:
--demo [NUMBER_OF_COLORMAP]
generate number of heatmaps by colormaps (default: '194'). Implied: covers the current ISO year; -y/-w/-s/-e/-c are ignored.
--seed SEED
set random seed for reproducible --demo output (default: None)
-y, --year YEAR
filter by year from the CSV file (default: 'None')
-w, --week WEEK
filter until week of the year from the CSV file (default: current week)
-e, --end-date END_DATE
filter until the date of the year from the CSV file and this will overwrite -y and -w option (default: None)
-s, --start-date START_DATE
filter from the date of the year from the CSV file and this will overwrite -y and -w option (default: None)
-O, --output-dir OUTPUT_DIR
set default output folder (default: 'output')
-o, --open
open the generated heatmap using the default program (default: False)
-p, --purge
remove all leftover artifacts set by --output-dir folder (default: False)
-t, --title TITLE
set title for the heatmap (default: None)
-u, --author AUTHOR
set author for the heatmap (default: kianmeng.org)
-f, --format IMAGE_FORMAT
set the default image format (default: 'png')
-c, --cmap COLORMAP
Set default colormap. (default: 'RdYlGn_r')
Available colormaps:
Accent, Accent_r, afmhot, afmhot_r, autumn, autumn_r
berlin, berlin_r, binary, binary_r, Blues, Blues_r
bone, bone_r, BrBG, BrBG_r, brg, brg_r
BuGn, BuGn_r, BuPu, BuPu_r, bwr, bwr_r
cividis, cividis_r, CMRmap, CMRmap_r, cool, cool_r
coolwarm, coolwarm_r, copper, copper_r, crest, crest_r
cubehelix, cubehelix_r, Dark2, Dark2_r, flag, flag_r
flare, flare_r, gist_earth, gist_earth_r, gist_gray, gist_gray_r
gist_grey, gist_grey_r, gist_heat, gist_heat_r, gist_ncar, gist_ncar_r
gist_rainbow, gist_rainbow_r, gist_stern, gist_stern_r, gist_yarg, gist_yarg_r
gist_yerg, gist_yerg_r, GnBu, GnBu_r, gnuplot, gnuplot2
gnuplot2_r, gnuplot_r, gray, gray_r, Grays, Grays_r
Greens, Greens_r, grey, grey_r, Greys, Greys_r
hot, hot_r, hsv, hsv_r, icefire, icefire_r
inferno, inferno_r, jet, jet_r, magma, magma_r
mako, mako_r, managua, managua_r, nipy_spectral, nipy_spectral_r
ocean, ocean_r, okabe_ito, okabe_ito_r, Oranges, Oranges_r
OrRd, OrRd_r, Paired, Paired_r, Pastel1, Pastel1_r
Pastel2, Pastel2_r, pink, pink_r, PiYG, PiYG_r
plasma, plasma_r, PRGn, PRGn_r, prism, prism_r
PuBu, PuBu_r, PuBuGn, PuBuGn_r, PuOr, PuOr_r
PuRd, PuRd_r, Purples, Purples_r, rainbow, rainbow_r
RdBu, RdBu_r, RdGy, RdGy_r, RdPu, RdPu_r
RdYlBu, RdYlBu_r, RdYlGn, RdYlGn_r, Reds, Reds_r
rocket, rocket_r, seismic, seismic_r, Set1, Set1_r
Set2, Set2_r, Set3, Set3_r, Spectral, Spectral_r
spring, spring_r, summer, summer_r, tab10, tab10_r
tab20, tab20_r, tab20b, tab20b_r, tab20c, tab20c_r
terrain, terrain_r, turbo, turbo_r, twilight, twilight_r
twilight_shifted, twilight_shifted_r, vanimo, vanimo_r, viridis, viridis_r
vlag, vlag_r, winter, winter_r, Wistia, Wistia_r
YlGn, YlGn_r, YlGnBu, YlGnBu_r, YlOrBr, YlOrBr_r
YlOrRd, YlOrRd_r
-i, --cmap-min COLORMAP_MIN_VALUE
Set the minimum value of the colormap range (default: None)
-x, --cmap-max COLORMAP_MAX_VALUE
Set the maximum value of the colormap range (default: None)
-b, --cbar
show colorbar (default: False)
-a, --annotate, --no-annotate
add count to each heatmap region (use --no-annotate to disable)
--animate-by-week
create an animation for each day of the current week
-q, --quiet
suppress all logging
-Y, --yes
yes to prompt
-d, --debug
show debugging log and stack trace
-E, --env
print environment information for bug reporting
-V, --version
show program's version number and exit
-h, --help
show this help message and exit.
Copyright and License
Copyright (C) 2023,2024 Kian-Meng Ang
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.
The fish logo used in the documentation generated by Sphinx is a public domain drawing of male freshwater phase Steelhead (Oncorhynchus mykiss) from https://commons.wikimedia.org/entity/M2787008.
1 maintainer
Metadata
1 maintainer
Release files for heatmap_cli 0.27.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| heatmap_cli-0.27.1.tar.gz | 48.2 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| heatmap_cli-0.27.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 82.4 kB
Release files / heatmap_cli-0.27.1.tar.gz
| Download URL | heatmap_cli-0.27.1.tar.gz |
|---|---|
| Size | 48.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e51fea02e14be2a4458717a13503473f148a7f3f44748c4b94359931e66dfd8c
|
|
BLAKE2b-256 checksum How to use checksums |
50d8f043172b3af972edf28b2f4507cda34995afe9ba74426200526831614a75
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / heatmap_cli-0.27.1-py3-none-any.whl
| Download URL | heatmap_cli-0.27.1-py3-none-any.whl |
|---|---|
| Size | 34.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ac6b0ad2cada4d844a19974e0f3175e7a7cdc91eed4d202744f26b3591336650
|
|
BLAKE2b-256 checksum How to use checksums |
3b143e3178cf4c1ff0dfdd925f86524995756f9e5def86b5b71dc15060dc4746
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for heatmap_cli 0.27.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
