nolint:funlen

Get returns a valid (non-expired) cache entry for the given key. Returns nil if the key does not exist or the entry has expired.

Text returns a translated string by key. It should be used for messages, captions, v1/v2 keys, etc. Do NOT pass condition codes here.

Close releases any resources held by the cache (connections, goroutines, etc.). Optional for in-memory implementations, required for networked caches.

Safe parsing helpers

Remove deletes the entry (and any in-progress marker) for the given key. Typically called when the upstream response should not be cached (e.g. status

Set stores a completed response in the cache under the given key. This should clear any in-progress state for the same key.

Parse parses the raw query string (the part after the ? character) and returns a populated *options.Options struct with all valid, active options set.

Open opens log file.

pad ensures the string has exactly `mustLen` visible runes, preserving ANSI codes.

Example accessors GetFile returns content of a file preserving original path

Write writes p to log, and returns number f bytes written. Implements io.Writer interface.

displayWidth returns the number of columns a string occupies on a terminal. It correctly handles emojis, wide characters, combining characters, etc.

New creates a new L10n wrapper bound to the language specified in Options. Falls back to English if no language is set.

NewLRU creates and returns a new LRU-based Cacher.

NewOnelineRenderer creates a new instance of the one-line renderer. At the moment it is stateless, so the constructor is very simple. It is kept as a

Helper: create a true-color (RGB)

colorize returns the string with ANSI background color (46 = cyan bg)

Helper width functions

Helper extractors (clean and reusable)

isValidLanguageCode checks if the provided code is a valid 2-letter language code. This is a simplified check; in a real application, you'd have a lis

isValidView checks if the provided string is a valid view name. This is a placeholder; in a real application, you'd have a list of supported views.

parseTimeStr converts "HH:MM:SS" (or "??:??:??") into a time.Time on the same day as `ref`. Falls back to `ref` on error — matches Python’s try/except

NewAddressFromString parses the location cache entry s, and return location, or error, if the cache entry is invalid.

NewV2Renderer creates a renderer for the v2 rich panel weather view.

ParseQueryString parses a wttr.in query string into a map of option names to values. It validates option names, types, content, and values based on th

Read returns location information from the cache, if found, or types.ErrNotFound if not found. If the entry is found, but its format is invalid, types

Resolve returns location data — first from cache (LRU → persistent), then from external search.

ToMap converts Options back to map[string]string. Only non-zero / non-default values are included.

getLatLonAndTZ extracts latitude, longitude, and timezone from RenderContext Returns: - lat, lon: coordinates (0,0 if missing/invalid) - loc: timezone

getTranslatedDesc returns the best available translation (lang_xx first, then English)

interpolate resamples data to targetWidth using cubic spline interpolation. Falls back to linear (or constant) for very short inputs.

panicRecovery is a middleware that recovers from panics in handlers

Simple min/max helpers

ApplyParsedMap populates Options from a validated map[string]string. All values are already validated by options.ParseQueryString().

Condition returns translated weather condition by numeric code.

ConditionByName returns translated condition by its English name.

File returns raw file content (help.txt, etc.)

Helper methods (optional but very convenient)

LoadDefsFromAssets loads and merges all .yaml / .yml files under spec/ in the embedded FS. Slices are appended; other fields are overridden by later f

NewBundle creates and preloads all languages from the embedded FS.

NewNoOpCacher returns a new no-op cache.

NewQueryParser returns a new QueryParser that uses the provided configuration

NewRequestLogger creates a new request logger. If filename is empty, logs are dropped silently. period must be > 0, otherwise it defaults to 1 minute.

NewV1Renderer creates a new v1 renderer.

parseCurrentCondition extracts and normalizes current weather data from the raw JSON bytes returned by the upstream weather service.

ReadUserIP returns IP address of the client from http.Request, taking into account the HTTP headers.

RenderConditionEmoji returns emoji/symbol + appropriate spacing. Now uses the new profile-based system (?emoji=...) while preserving backwards compati

SetCellColor sets foreground/background color for a specific cell.

SetInProgressIfNotExists marks that a request for this key is currently being processed. Used to prevent duplicate upstream requests (coalescing).

WaitForCompletion blocks until the in-progress state for this key is cleared (i.e., the first request has finished and Set() has been called), or unti

WriteText writes a string at (row, col) with optional foreground/background color. Stops at screen edges. Supports \n.

── Utility functions ──────────────────────────────────────────────────────────

cacheFile returns path to the cache entry for addr.

colorFromANSI converts go-te color (from Attr.Fg / Attr.Bg) to real color.Color

colorToANSI converts internal Color to ANSI escape sequence.

computeResponse performs location resolution, weather fetch, rendering and formatting. Returns ready-to-cache domain.CacheEntry or error. Does NOT wri

convertTimeToMinutes converts "03:04 PM" → minutes since midnight

flush writes the current buffer to disk and resets it. It is safe to call concurrently.

formatCond builds the 5-line current/forecast condition block. prefix is " " for current condition, "│" for forecast blocks inside the box.

formatRain formats precipitation amount and chance of rain.

formatTemp formats temperature (with feels-like in parentheses when different).

formatVisibility formats visibility.

formatWind formats wind direction + speed (+ gust if stronger).

Helper to get the "best guess" client IP — handles proxies/load balancers

Helper functions

── LRU helpers ────────────────────────────────────────────────────────────────

isPlainTextClient determines if the User-Agent indicates a plain text client like curl or wget.