aboutsummaryrefslogtreecommitdiff
path: root/wttrin.el
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-05-05 09:48:13 -0500
committerCraig Jennings <c@cjennings.net>2026-05-05 09:48:13 -0500
commitec00dbe1c03527ec46a0faa20545a7acd382da84 (patch)
tree268cd3af685677808654de3f775d60d7693c83ff /wttrin.el
parentb83865a65eb744f6d36c1c672a4d83a59d6383f8 (diff)
downloademacs-wttrin-ec00dbe1c03527ec46a0faa20545a7acd382da84.tar.gz
emacs-wttrin-ec00dbe1c03527ec46a0faa20545a7acd382da84.zip
feat: add wttrin-display-options for wttr.in flag customization (closes #3)
wttr.in accepts single-character flags appended to the URL that control what the report looks like — no Follow line (F), narrow output (n), quiet mode (q), forecast horizon (0/1/2), console-glyph mode (d), and so on. Until now wttrin always used the same default report shape with no way to opt into these. Added a `wttrin-display-options` defcustom that takes a string of concatenated flags, e.g. "0Fq" for current weather only with no Follow line and no header. The flags get appended to every request via `wttrin--build-url`. The defcustom defaults to nil so existing users see no change. I excluded `A` and `T` from the recommended set in the docstring since wttrin needs ANSI output for the xterm-color rendering to produce the colored glyphs. The user could still pass them, but the docstring nudges them away. Tests cover the normal cases (single, multi-flag, with and without unit system), the boundaries (nil and empty string both leave the URL unchanged from baseline, single character works), and a sanity check that the new flags slot in after the always-on `A`. Existing build-url tests stay green because they don't bind the new variable, and the default is nil. Also added `.claude/` to .gitignore — the scheduled-tasks lockfile from local wakeup scheduling shouldn't be tracked.
Diffstat (limited to 'wttrin.el')
-rw-r--r--wttrin.el26
1 files changed, 25 insertions, 1 deletions
diff --git a/wttrin.el b/wttrin.el
index 3caa178..7e67af3 100644
--- a/wttrin.el
+++ b/wttrin.el
@@ -96,6 +96,29 @@ units (default)."
:group 'wttrin
:type 'string)
+(defcustom wttrin-display-options nil
+ "wttr.in display option flags concatenated as a string.
+Each character is a wttr.in flag, as documented at https://wttr.in/:help.
+Common options:
+
+ 0 only current weather (no forecast)
+ 1 current weather + today's forecast
+ 2 current weather + today's + tomorrow's forecast
+ d restrict output to standard console font glyphs
+ F do not show the \"Follow\" line
+ n narrow version (only day and night)
+ q quiet version (no \"Weather report\" text)
+ Q superquiet version (no \"Weather report\", no city name)
+
+Example: \"0Fq\" gives current weather only with no Follow line and no
+header. Default nil means no extra options.
+
+Avoid \"A\" and \"T\" — wttrin manages ANSI output internally so the
+xterm-color rendering produces the colored glyphs."
+ :group 'wttrin
+ :type '(choice (const :tag "None" nil)
+ (string :tag "Options")))
+
(define-obsolete-variable-alias 'wttrin-cache-ttl 'wttrin-refresh-interval "0.3.0")
@@ -271,7 +294,8 @@ Returns \"just now\" for <60s, \"X minutes ago\", \"X hours ago\", or \"X days a
(concat "https://wttr.in/"
(url-hexify-string query)
(wttrin-additional-url-params)
- "A"))
+ "A"
+ (or wttrin-display-options "")))
(defun wttrin--extract-http-status ()
"Return the HTTP status code from the current buffer, or nil.