smxi/dws: A tiny utility to check the position of a distro on distrowatch.com. A tiny utility, but fun. - Codeberg.org

====================================================================
README for distrowatch.com stats tool: dws
====================================================================
FILE: README.txt
VERSION: 1.3
DATE: 2023年09月16日
====================================================================
Please file issue reports or feature requests at:
https://codeberg.org/smxi/dws
The Codeberg repos will be mirrored to Github until the end of 2023, after that,
no updates to github repos will be made. Some time after that, the code will be
removed.
Please take the time to read this helpful article from the Software Freedom
Conservancy:
https://sfconservancy.org/GiveUpGitHub/
Any use of this project's code by GitHub Copilot, past or present, is done 
without my permission. I do not consent to GitHub's use of this project's code 
in Copilot.
====================================================================
INSTALLING:
git clone https://codeberg.org/smxi/dws 
Install dws. Note that the -U (update) option means that only the
initial install is required:
wget -O dws https://codeberg.org/smxi/dws/raw/master/dws
Shortcut download path for codeberg (easier to remember and type):
wget -O dws smxi.org/dws
====================================================================
BASICS:
dws is a simple tool designed to check either a set of distro names 
or a top / bottom x number of distros from distrowatch.com.
You can use either -r or -d, but not both. Default is -r 10, -t 7.
--------------------------------------------------------------------
-d distro list:
The -d option is used like this:
dws -d arch,debian,ubuntu,fedora,opensuse
Note that no spaces or dashes are used in the distro names, and some,
like linux lite, are shortened to lite, e.g. PC-BSD is pcbsd, 
Ubunut Gnome is ubuntugnome, Tiny Core is tinycore, and so on. Only
ASCII characters can be used.
Known exceptions to distro naming:
Debian Edu: -d skolelinux
DragonFly: dragonflybsd
Emmabuntüs: -d emmabuntus
GoboLinux: -d gobo
HandyLinux: -d handy
Linux Lite: -d lite
MakuluLinux: -d makulu
MX Linux: -d mx
SparkyLinux: -d sparky
SUSE: -d sle
Ubuntu Christian: -d ubuntuce
-d overrides -r or configuration -r values.
--------------------------------------------------------------------
-r range:
-r with a positive integer between 1 and 99 shows the top x distros.
-r with a negative integer between -1 and -99 shows the bottom x
distros.
--------------------------------------------------------------------
-t time span:
The -t option sets the time interval. Accepts values 7 or 30 (days),
3, 6, or 12 months, and years from 2002 to current year. Output will
show for the requested interval. Default is 7 days. See below for 
examples.
--------------------------------------------------------------------
-U update:
This updates dws using codeberg sources.
====================================================================
OUTPUT FORMAT:
From yesterday: + = rising; ~ = unchanged; - = falling. Does not show 
for year output.
Print Name: [ranking] (hits per day +~-) [working name, value for -d]
====================================================================
CHANGE DEFAULTS:
You can change the program defaults at top of program variable 
settings to what you want, just change the values of these top 
variables and $SELF_NAME 
will show by default what you want to see with no arguments/options:
DISTROS='debian,ubuntu,arch,antix' # show these distros by default
# or
RANGE=20 # show top 20 distros by default
TIME_SPAN='6' # show last 6 months
To make overrides permanent, put them into configuration file: 
/etc/dws.conf 
====================================================================
SAMPLES:
Here are a few samples to give you an idea of how the output looks.
--------------------------------------------------------------------
Default:
dws
Distrowatch.com 7 day rankings:
elementary: 1 (2509+) [elementary]
Manjaro: 2 (2458+) [manjaro]
MX Linux: 3 (1521+) [mx]
Mint: 4 (1358+) [mint]
Ubuntu: 5 (1278+) [ubuntu]
KaOS: 6 (872+) [kaos]
Debian: 7 (739+) [debian]
MidnightBSD: 8 (658-) [midnightbsd]
Lubuntu: 9 (624+) [lubuntu]
Fedora: 10 (559+) [fedora]
--------------------------------------------------------------------
Using negative Range, and Time:
dws -r -10 -t 12
Distrowatch.com 12 month rankings:
Neptune: 100 (122+) [neptune]
Vector: 99 (126~) [vector]
Black Lab: 98 (128~) [blacklab]
Parabola: 97 (129-) [parabola]
NuTyX: 96 (130-) [nutyx]
Container: 95 (130~) [container]
BunsenLabs: 94 (130~) [bunsenlabs]
AUSTRUMI: 93 (130~) [austrumi]
Elive: 92 (131~) [elive]
SteamOS: 91 (132~) [steamos]
--------------------------------------------------------------------
Using Positive Range, and Time:
dws -r 10 -t 12
Distrowatch.com 12 month rankings:
Manjaro: 1 (3356+) [manjaro]
Mint: 2 (2574-) [mint]
Ubuntu: 3 (1553-) [ubuntu]
elementary: 4 (1494+) [elementary]
Debian: 5 (1336-) [debian]
MX Linux: 6 (1268+) [mx]
Solus: 7 (1015-) [solus]
Fedora: 8 (892~) [fedora]
openSUSE: 9 (760~) [opensuse]
Antergos: 10 (728-) [antergos]
--------------------------------------------------------------------
Using Distro List, and Time
dws -d arch,gentoo,freebsd,sam,midnightbsd,fred,gus -t 30
Distrowatch.com 30 day rankings:
Arch: 15 (469-) [arch]
Gentoo: 60 (185-) [gentoo]
FreeBSD: 24 (368+) [freebsd]
sam: not ranked
MidnightBSD: 28 (329+) [midnightbsd]
fred: not ranked
gus: not ranked
--------------------------------------------------------------------
Using Postive Range, and Year 
dws -r 6 -t 2015
Distrowatch.com 2015 year rankings:
Mint: 1 (3084) [mint]
Debian: 2 (1810) [debian]
Ubuntu: 3 (1617) [ubuntu]
openSUSE: 4 (1341) [opensuse]
Fedora: 5 (1148) [fedora]
Mageia: 6 (1026) [mageia]