wtftools 0.0.0__py3-none-any.whl

wtftools-0.0.0.data/data/share/bash-completion/completions/wtf.bash-completion

@@ -0,0 +1,134 @@
+# bash completion for `wtf` / `wtftools`
+# Install: copy to /etc/bash_completion.d/ or `source` from your bashrc.
+
+_wtf_complete() {
+    local cur prev cmd
+    COMPREPLY=()
+    cur="${COMP_WORDS[COMP_CWORD]}"
+    prev="${COMP_WORDS[COMP_CWORD-1]}"
+
+    local subcommands="info audit problems crontab doctor services config logs explain history diff top ports events"
+    local global_opts="-h --help -V --version --no-color -v --verbose -q --quiet --config"
+
+    if [[ $COMP_CWORD -eq 1 ]]; then
+        COMPREPLY=( $(compgen -W "$subcommands $global_opts" -- "$cur") )
+        return 0
+    fi
+
+    cmd="${COMP_WORDS[1]}"
+
+    case "$cmd" in
+        info)
+            COMPREPLY=( $(compgen -W "--format" -- "$cur") )
+            [[ "$prev" == "--format" ]] && COMPREPLY=( $(compgen -W "text json" -- "$cur") )
+            ;;
+        audit|problems)
+            local opts="--format --strict --exit-zero --check --only --since --list-checks --brief -b --ignore --serial --check-timeout --alert --alert-on --save --output -o"
+            case "$prev" in
+                --format)   COMPREPLY=( $(compgen -W "text json prometheus csv plain html" -- "$cur") ); return 0 ;;
+                --only)     COMPREPLY=( $(compgen -W "fail warn problems problem skip ok all" -- "$cur") ); return 0 ;;
+                --alert-on) COMPREPLY=( $(compgen -W "fail warn any" -- "$cur") ); return 0 ;;
+                --output|-o) COMPREPLY=( $(compgen -f -- "$cur") ); return 0 ;;
+                --check|--ignore)
+                    local names="uptime system load iowait psi tcp-retrans memory swap disks \
+inodes readonly-mounts failed-units enabled-inactive restart-loops network-errors conntrack \
+journal-disk zombies d-state oom kernel-errors kernel-taint cert-expiry fds pids auth time-sync \
+updates reboot cron-daemon crontab docker hw-temp smart dns http-probes tcp-probes fail2ban"
+                    COMPREPLY=( $(compgen -W "$names" -- "$cur") )
+                    return 0
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "$opts" -- "$cur") )
+            ;;
+        explain)
+            local opts="--check --ignore --since --all --prompt --format --serial --check-timeout --llm --llm-model --llm-timeout"
+            case "$prev" in
+                --format) COMPREPLY=( $(compgen -W "text json" -- "$cur") ); return 0 ;;
+                --llm)    COMPREPLY=( $(compgen -W "ollama claude openai auto" -- "$cur") ); return 0 ;;
+                --check|--ignore)
+                    local names="uptime system load iowait psi tcp-retrans memory swap disks \
+inodes readonly-mounts failed-units enabled-inactive restart-loops network-errors conntrack \
+journal-disk zombies d-state oom kernel-errors kernel-taint cert-expiry fds pids auth time-sync \
+updates reboot cron-daemon crontab docker hw-temp smart dns http-probes tcp-probes fail2ban"
+                    COMPREPLY=( $(compgen -W "$names" -- "$cur") )
+                    return 0
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "$opts" -- "$cur") )
+            ;;
+        diff)
+            local opts="--snapshot --against --format"
+            case "$prev" in
+                --format)  COMPREPLY=( $(compgen -W "text json" -- "$cur") ); return 0 ;;
+                --against) COMPREPLY=( $(compgen -f -- "$cur") ); return 0 ;;
+            esac
+            COMPREPLY=( $(compgen -W "$opts" -- "$cur") )
+            ;;
+        history)
+            COMPREPLY=( $(compgen -W "--limit --format" -- "$cur") )
+            [[ "$prev" == "--format" ]] && COMPREPLY=( $(compgen -W "text json" -- "$cur") )
+            ;;
+        top)
+            local opts="--sort --limit --user --name --format"
+            case "$prev" in
+                --sort)   COMPREPLY=( $(compgen -W "cpu rss" -- "$cur") ); return 0 ;;
+                --format) COMPREPLY=( $(compgen -W "text json" -- "$cur") ); return 0 ;;
+                --user)   COMPREPLY=( $(compgen -u -- "$cur") ); return 0 ;;
+            esac
+            COMPREPLY=( $(compgen -W "$opts" -- "$cur") )
+            ;;
+        ports)
+            local opts="--proto --public-only --format"
+            case "$prev" in
+                --proto)  COMPREPLY=( $(compgen -W "tcp udp all" -- "$cur") ); return 0 ;;
+                --format) COMPREPLY=( $(compgen -W "text json" -- "$cur") ); return 0 ;;
+            esac
+            COMPREPLY=( $(compgen -W "$opts" -- "$cur") )
+            ;;
+        services)
+            local opts="-n --lines --format"
+            case "$prev" in
+                --format) COMPREPLY=( $(compgen -W "text json" -- "$cur") ); return 0 ;;
+            esac
+            local units=$(systemctl list-units --type=service --no-legend --plain 2>/dev/null \
+                          | awk '{ sub(/\.service$/, "", $1); print $1 }')
+            COMPREPLY=( $(compgen -W "$opts $units" -- "$cur") )
+            ;;
+        events)
+            local opts="--since --kind --limit --format"
+            case "$prev" in
+                --kind)   COMPREPLY=( $(compgen -W "reboot oom failed-unit kernel-err auth-fail login" -- "$cur") ); return 0 ;;
+                --format) COMPREPLY=( $(compgen -W "text json" -- "$cur") ); return 0 ;;
+            esac
+            COMPREPLY=( $(compgen -W "$opts" -- "$cur") )
+            ;;
+        logs)
+            local opts="--since --priority -p --units --lines -n --format"
+            case "$prev" in
+                --format)      COMPREPLY=( $(compgen -W "text json" -- "$cur") ); return 0 ;;
+                --priority|-p) COMPREPLY=( $(compgen -W "emerg alert crit err warning notice info debug" -- "$cur") ); return 0 ;;
+            esac
+            COMPREPLY=( $(compgen -W "$opts" -- "$cur") )
+            ;;
+        doctor)
+            COMPREPLY=( $(compgen -W "--format --check-updates" -- "$cur") )
+            [[ "$prev" == "--format" ]] && COMPREPLY=( $(compgen -W "text json" -- "$cur") )
+            ;;
+        crontab)
+            local opts="-S --system -U --user-file -u --username --format --strict --exit-zero"
+            case "$prev" in
+                -S|--system|-U|--user-file) COMPREPLY=( $(compgen -f -- "$cur") ); return 0 ;;
+                -u|--username) COMPREPLY=( $(compgen -u -- "$cur") ); return 0 ;;
+                --format)      COMPREPLY=( $(compgen -W "text json" -- "$cur") ); return 0 ;;
+            esac
+            COMPREPLY=( $(compgen -f -W "$opts" -- "$cur") )
+            ;;
+        config)
+            COMPREPLY=( $(compgen -W "--example --format" -- "$cur") )
+            [[ "$prev" == "--format" ]] && COMPREPLY=( $(compgen -W "text json" -- "$cur") )
+            ;;
+    esac
+}
+
+complete -F _wtf_complete wtf
+complete -F _wtf_complete wtftools

wtftools-0.0.0.dist-info/METADATA

@@ -0,0 +1,246 @@
+Metadata-Version: 2.4
+Name: wtftools
+Version: 0.0.0
+Summary: One command to see what is going on with your Linux server right now.
+Author-email: Aleksandr Pimenov <wachawo@gmail.com>
+Maintainer-email: Aleksandr Pimenov <wachawo@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 Aleksandr Pimenov
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/wachawo/wtftools
+Project-URL: Repository, https://github.com/wachawo/wtftools.git
+Project-URL: Documentation, https://github.com/wachawo/wtftools#readme
+Project-URL: Bug Reports, https://github.com/wachawo/wtftools/issues
+Keywords: devops,sre,linux,diagnostics,monitoring,cron,system,audit,cli
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: System Administrators
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: full
+Requires-Dist: psutil>=5.9.0; extra == "full"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: coverage>=7.0.0; extra == "dev"
+Requires-Dist: ruff>=0.4.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: stdeb>=0.10.0; extra == "dev"
+Requires-Dist: pre-commit>=3.0.0; extra == "dev"
+Dynamic: license-file
+
+# wtftools
+
+> One command to see what is going on with your Linux server right now.
+
+**Status:** v0.0.0 — initial public release. 14 subcommands, 38 built-in
+checks, snapshot/diff/history, LLM-driven explain. One-shot CLI; no daemon,
+no fleet aggregator, no plugin extension API.
+
+> **In a hurry?** See [docs/QUICKSTART.md](docs/QUICKSTART.md) for the 5-minute version.
+
+```
+$ wtf
+─────────── AUDIT ────────────
+[ OK ] uptime                  3d 4h 12m
+[ OK ] load average            0.42 0.51 0.55 / 8 CPU
+[ OK ] memory                  4.1GB / 16.0GB used (25%)
+[WARN] disk /var               17.0GB / 20.0GB used (85%)
+[ OK ] zombie processes        0 zombies
+[FAIL] failed systemd units    1 failed unit(s)
+[ OK ] crontab syntax          14 cron line(s), no errors
+
+  Summary: 12 ok · 1 warn · 1 fail · 2 skip
+```
+
+## Subcommands
+
+| command             | what it does                                                |
+|---------------------|-------------------------------------------------------------|
+| `wtf` / `wtf audit` | green/yellow/red checklist: what is OK and what is not      |
+| `wtf problems`      | alias for `audit --only problems` — show WARN+FAIL only      |
+| `wtf explain`       | per-check actionable advice; `--llm` to pipe to LLM          |
+| `wtf info`          | one-page snapshot: host, uptime, load, mem, disks, top, net |
+| `wtf top`           | focused process top: sort by cpu/rss, filter user/name      |
+| `wtf ports`         | listening sockets with owning PID/user/command              |
+| `wtf services NAME` | drilldown one service: state, restarts, mem, ports, journal |
+| `wtf logs`          | recent ERROR+ journal entries grouped by service            |
+| `wtf events`        | chronological timeline: reboots, OOM, failed units, …       |
+| `wtf history`       | list saved audit snapshots (`wtf audit --save` to create)   |
+| `wtf diff`          | compare current state to a saved snapshot                   |
+| `wtf crontab`       | validate all standard crontab locations + per-user crontabs |
+| `wtf doctor`        | self-diagnostic: which tools wtftools can actually use      |
+| `wtf config`        | show effective config / print example                       |
+
+`wtftools` absorbs and supersedes [`checkcrontab`](https://github.com/wachawo/checkcrontab) — the same cron validator now lives at `wtf crontab`.
+
+## Install
+
+### From PyPI
+
+```bash
+pip install wtftools           # core, stdlib-only
+pip install wtftools[full]     # + psutil for richer metrics
+```
+
+After install the short command `wtf` (and the long alias `wtftools`) is on `$PATH`.
+
+### From apt (Debian/Ubuntu)
+
+```bash
+sudo apt install python3-psutil
+sudo dpkg -i wtftools_0.0.0-1_all.deb
+```
+
+A `.deb` is built from the same source via `scripts/build-deb.sh` (uses `stdeb`).
+
+### From source
+
+```bash
+git clone https://github.com/wachawo/wtftools
+cd wtftools
+pip install -e .
+# or test without installing:
+python3 wtf.py audit
+```
+
+## Usage
+
+```bash
+wtf                      # short audit summary (default)
+wtf problems             # only WARN+FAIL rows
+wtf info                 # detailed system snapshot
+wtf info --format json   # machine-readable
+
+wtf audit                # full audit with [OK]/[WARN]/[FAIL] markers
+wtf audit -v             # show extra detail (failed units, OOM events)
+wtf audit --strict       # exit 1 on warnings (CI-friendly)
+wtf audit --format json  # JSON output for pipelines
+wtf audit --check memory --check disks   # run named checks only
+wtf audit --list-checks  # show all available check short-names
+wtf audit --since 1      # look-back window for OOM/auth/kernel (default 24h)
+wtf audit --brief        # one-line summary for MOTD / SSH banners
+wtf audit --ignore swap --ignore "disk /mnt/Backup"   # silence specific checks
+wtf audit --format csv > audit.csv               # spreadsheet-friendly
+wtf audit --format plain | awk '$1=="fail"'      # shell-pipeline-friendly
+wtf audit --format html -o report.html           # self-contained HTML for tickets
+
+wtf audit --save                 # save snapshot to ~/.cache/wtftools/
+wtf diff                         # what changed vs last snapshot
+wtf diff --snapshot 5            # vs 5 snapshots ago
+wtf history                      # list saved snapshots
+
+wtf explain                                 # per-check actionable advice
+wtf explain --prompt | ollama run llama3    # pipe to local LLM
+wtf explain --llm ollama                    # built-in: call ollama directly
+wtf explain --llm claude                    # anthropic SDK + ANTHROPIC_API_KEY
+wtf explain --llm auto                      # try ollama → claude → openai
+
+wtf audit --alert 'mail -s "wtf $WTF_HOST" sre@example.com'
+wtf audit --alert-on warn --alert 'curl -X POST $SLACK_WEBHOOK -d @-'
+
+wtf top                                       # top processes
+wtf top --sort rss --user www-data --limit 5  # top RAM consumers for one user
+wtf ports                                     # listening TCP + owning process
+
+wtf services nginx       # state + restarts + ports + last 20 journal lines
+wtf logs                                       # last hour, ERROR+
+wtf events --since 48                          # 48-hour incident timeline
+wtf events --kind oom --kind failed-unit       # filter to specific kinds
+
+wtf doctor               # show which CLI tools wtf can use on this host
+wtf doctor --check-updates  # also query PyPI for a newer version
+```
+
+## Exit codes
+
+| code | meaning                                          |
+|------|--------------------------------------------------|
+| 0    | everything OK (`audit`) / no errors (`crontab`)  |
+| 1    | warnings with `--strict`, or crontab errors      |
+| 2    | audit found a `[FAIL]`                           |
+| 130  | interrupted (Ctrl-C)                             |
+
+## Built-in checks
+
+uptime · system state · load average · CPU iowait · PSI cpu/memory/io ·
+TCP retransmits · memory · swap · disk (per mount) · inodes ·
+read-only mounts · failed systemd units · enabled-but-down services ·
+restart loops · network errors · conntrack · journal disk usage · zombies ·
+D-state processes · OOM kills · kernel errors · kernel taint · cert expiry ·
+open file descriptors · process count · failed auth · time sync ·
+pending updates · reboot required · cron daemon · crontab syntax · docker ·
+hw temperatures · disk SMART · DNS · HTTP/TCP probes · fail2ban.
+
+Run `wtf audit --list-checks` for the full list of short names usable with
+`--check` and `--ignore`.
+
+## Config
+
+Drop an INI at any of:
+
+- `/etc/wtftools/config.ini`
+- `/etc/wtf/config.ini`
+- `~/.config/wtftools/config.ini`
+
+Or stack one ad-hoc via `wtf --config /path/to.ini …`. Run `wtf config --example`
+for a fully-commented template. Headlines:
+
+```ini
+[thresholds]
+disk_warn = 85
+disk_fail = 95
+swap_warn = 50
+swap_fail = 90
+tcp_retrans_warn = 1.0
+tcp_retrans_fail = 5.0
+
+[ignore]
+checks = swap, updates
+result_names =
+    disk /mnt/Backup
+    disk /mnt/Video
+```
+
+## Compatibility
+
+- Python 3.8+
+- Linux (any systemd-based distribution is the happy path; the tool degrades
+  gracefully when `systemctl` / `journalctl` are missing)
+- No network access required for the core CLI
+- Optional network: `wtf explain --llm claude/openai`, `wtf doctor --check-updates`
+
+## License
+
+MIT

wtftools-0.0.0.dist-info/RECORD

@@ -0,0 +1,20 @@
+wtftools/__init__.py,sha256=I3Rlis3V3k-KwcZBZXAw3vW2tfer0qK2su7Lbw7P-bE,1948
+wtftools/__main__.py,sha256=Zny7E8bCqptmdOXhKiRmZuKlj7iwBa-3Wz1oc9D_mH0,185
+wtftools/audit.py,sha256=SZyU0gCxysZE9U4FWSuJ28HQjgZviFS7w5xvl7dzIPk,33820
+wtftools/colors.py,sha256=752lq10R0hytgIG-nkug2JvlwM5EjJvQfa8Dyu2pSBQ,2740
+wtftools/config.py,sha256=deq0vFCZNgNPy3Xo89MvAy7wlvF_Pb_e1REIcBSKwrU,7706
+wtftools/cron.py,sha256=qPNSDGWSqn1tXquwQJNZzGet6XCL2NPYD4XSkqqBphs,15375
+wtftools/events.py,sha256=AwXtGaeLZelpGaTems1ubL9O1hw3cug8hCbXxTY42ws,8031
+wtftools/explain.py,sha256=dPoNQFN5c-X6pdp7_wWWGZl6Lf_HHRsx7pk7FH_p7Iw,13919
+wtftools/info.py,sha256=FbiRhn2uoPMsvdPhXPPrhAVglmfjW0gcNpVmW1HlAnU,3662
+wtftools/llm.py,sha256=_hiZ89EkNG4xOwTbNGpdY5HOzcHmxUN7ujOKIJZNDEQ,5139
+wtftools/main.py,sha256=aLOP26hh4dPFxgw0w-Ir43OEYXVJb7fe2unrzNIGjBA,55165
+wtftools/snapshot.py,sha256=szRgR_8i3uFgZAy1AZ1Gzr64HE36YXlOAsC66lirJxU,7012
+wtftools/sysinfo.py,sha256=yAPyfkbJTd4zVtwhkxqz-3HupRAHz16-0mEGLHvPYsk,52665
+wtftools-0.0.0.data/data/share/bash-completion/completions/wtf.bash-completion,sha256=qm5s6_PKCcXR6b8PDDwnptgKJW2KMjbT-PV8AQ3pyCM,6712
+wtftools-0.0.0.dist-info/licenses/LICENSE,sha256=kidhJqld71of5BOrDWhyJAz5KP9J3pB08ZbhlaAmm6o,1074
+wtftools-0.0.0.dist-info/METADATA,sha256=XC1Y-T8G2rrySAUgOB9dkSv7lD9GCpK1zNC7JUwo23g,10374
+wtftools-0.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+wtftools-0.0.0.dist-info/entry_points.txt,sha256=rhtScgQIS_9SycAviC9jZMYeubphov_WY9zg0afvN3U,73
+wtftools-0.0.0.dist-info/top_level.txt,sha256=1izOHsJ1yHhW1Ydbk0L1E-sB5XkJUwhVEFzC0MN3Tu8,9
+wtftools-0.0.0.dist-info/RECORD,,

wtftools-0.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

wtftools-0.0.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+wtf = wtftools.main:main
+wtftools = wtftools.main:main

wtftools-0.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aleksandr Pimenov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

wtftools-0.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+wtftools