textualInformation returns the rich bottom metadata block (data-first)

toFieldName turns kebab/snake-case → PascalCase

toGoType maps YAML type → Go type

validateBooleanOption validates and sets boolean option values.

validateIntegerOption validates and sets integer option values.

validateStringOption validates and sets string option values, including background-specific rules.

waitForInProgress waits for another goroutine to complete the request.

writeToDisk atomically writes the entry using a temp file.

Helper: create 256-color

Optional: cleanup on shutdown (good practice)

Close performs cleanup.

Close cleans up resources (call on shutdown).

Close closes log file.

Close releases the underlying database reader resources.

Close closes both the underlying client and the cache.

Close closes idle HTTP connections. Call this when shutting down the application.

Condition returns translated weather condition by numeric code.

ConditionByName returns translated condition by its English name.

nolint:cyclop

DrawTemperatureDiagram draws a clean, compact Braille temperature plot.

File returns the content of a localized file (e.g. help.txt, conditions.txt).

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

Format implements the Formatter interface defined in weather.go

GetIPData implements the IPLocator interface.

GetLocation implements Locator interface

GetWeather returns weather data, using cache when possible.

HasMultipleCerts returns true if the new multi-certificate config is used.

IsInProgress returns true if the key is currently being processed by another goroutine.

Log records a request. Requests from 127.0.0.1 are ignored.

MoonAgeDays returns the approximate age of the moon in days (0 ≈ new moon, ~14.765 ≈ full moon, ~29.53 ≈ next new moon)

MustGetFile panics if file is missing (useful for init/config)

MustParse implements QueryParser.MustParse

MustParse is a convenience variant that panics on error. Mainly useful in tests, initialization code, or when invalid input is a programmer error.

ProcessLogFile reads a wttr.in log file, parses queries, and writes invalid entries to an error file. Each log line is expected in the format: "timest

Remove deletes the entry for the given key (including any in-progress marker).

Remove deletes the on-disk entry and clears any in-progress state.

Render implements the Renderer interface.

Render processes the input Query and transforms the raw weather data into a minified JSON format with indentation. It removes all hourly entries from

Render implements the Renderer interface

────────────────────────────────────────────────────────────────────────────── Main rendering loop using the map ─────────────────────────────────────

Render converts the query's weather JSON into the v2 terminal weather report.

Render implements the Renderer interface.

renderConditionPlain implements the %x placeholder Returns a very simple plain-text (ASCII-like) representation of the weather condition

RenderMoonDay returns approximate lunar day (days since last new moon, 0–29) Rounded to nearest integer — suitable for weather/terminal display

Response provides routing interface to the geo cache.

Response provides routing interface to the geo cache. Temporary workaround to switch IP addresses handling to the Go server. Handles two queries: -

Set stores a completed cache entry and clears the in-progress state.

Set stores the completed entry and notifies waiters.

SetInProgressIfNotExists tries to claim responsibility for computing the key. It returns true if this goroutine should compute the value (we became t

SetInProgressIfNotExists returns true if it successfully marked the key as in-progress.

SetLineColor is useful for your Braille plot: colors an entire line (or part of it).

String returns string representation of location.

nolint:funlen

Text returns translated string by key (messages, captions, v1/v2, etc.) Do NOT use it for condition codes.

ToQueryString returns the options as URL query string (e.g. "format=...&lang=de").

Validate performs basic validation of the configuration.

WaitForCompletion blocks until the in-progress flag is cleared or timeout occurs.

WaitForCompletion blocks until the key is no longer in-progress or timeout occurs.

WithLang returns a new L10n instance with a different language. Useful for forcing a specific language in some contexts.

YamlUnmarshalStrict unmarshals YAML data with an error when unknown fields are present.

──────────────────────────────────────────────── Optional: Helper to get "today" at midnight local time Useful for twilight calculations ─────────────