Files
fish-config/functions/qr.fish
T
rootiest dccf897c9f docs(functions): add missing EXIT STATUS header docs
Fills the gaps recorded in JOB-BRIEF-FINDINGS.md for the functions
converted to header-driven --help: 16 argument-less functions gain an
EXIT STATUS section (check_fish_deps, claude-docs, claude-pr, cleanup,
fast, fzf-update, gip, gip4, hist, limine-edit, lock, ports,
screensleep, steam-dl, swapstat, tmux-clean), and 8 functions that
already document ARGUMENTS gain EXIT STATUS too (lD, lsr, lss, lstree,
lt, ltr, lx, qr).

Not touched: gip6, ld, parur, sudo-toggle, upgrade, the JOB-BRIEF's
'missing ARGUMENTS' group. Re-checked their bodies against that claim
-- none of the five take a positional argument ($argv only appears
forwarded to the --help check), so an ARGUMENTS section would document
something that doesn't exist. All five already have EXIT STATUS.
2026-09-08 01:12:04 -04:00

42 lines
1017 B
Fish

# Copyright (C) 2026 Rootiest
# SPDX-License-Identifier: AGPL-3.0-or-later
# CATEGORY
# 10-network
#
# SYNOPSIS
# qr [text...]
#
# DESCRIPTION
# Generates a UTF-8 QR code from the given text or from stdin if no
# argument is provided. Uses qrencode locally if available, otherwise
# falls back to the qrenco.de API via curl.
#
# ARGUMENTS
# text... Text to encode; reads from stdin if omitted
#
# EXIT STATUS
# Exit status of qrencode, or curl if qrencode is unavailable
#
# EXAMPLE
# qr "https://example.com"
# echo "hello" | qr
function qr --description 'Generate a QR code from text or pipe'
__fish_help_header (status current-function) $argv; and return 0
if type -q qrencode
if set -q argv[1]
echo $argv | qrencode -t utf8
else
cat | qrencode -t utf8
end
else
if set -q argv[1]
curl -s "qrenco.de/$argv"
else
set -l input (cat)
curl -s "qrenco.de/$input"
end
end
end