parseHHMM parses "15:04" style string into hours and minutes

parseTimeToMinutes converts "0", "300", "600", ..., "2100" into minutes since midnight

renderCurrent renders one block (current or forecast day)

simpleTextualFallback

speedToColor returns colored wind speed text based on speed value.

sunriseTime returns local sunrise time in "HH:MM" format (24h) Uses github.com/nathan-osman/go-sunrise for accurate calculation

validateAndSetFlag validates and sets a single flag option.

windDir returns ANSI-colored arrow for wind direction.

windInRightUnits converts wind speed to the requested unit (km/h, mph, or m/s).

AppendToFile appends a string to the specified file with a timestamp

ConvertWeather converts domain.Weather to v1.resp

DrawColoredTemperatureDiagram returns the Braille temperature plot with color gradient + high/low temperature labels.

Flush forces a flush of the current buffer. Useful for graceful shutdown.

FromDomainOptions converts from the main wttr.in options.Options to PNGOptions

FromRequest creates an options.Options struct based on the provided HTTP request. It processes the URL path, domain name, and headers according to the

GenerateOptionsAndParser is the main entry point

Get returns a valid, non-expired cache entry or nil if not found/expired.

Get returns a valid (non-expired) cache entry.

GetEmojiProfile returns the active emoji profile name based on options.

GetStringValue — convenience wrapper for the most common case (strings & numbers)

GetValue executes a jq query and returns the first result as interface{} Use this when you expect exactly one value (most common for weather fields)

HasLegacyCert returns true if the old single certificate fields are populated.

ConvertCache converts files-based cache into the DB-based cache. If reset is true, the DB cache is created from scratch. nolint:funlen,cyclop

IsInProgress checks whether the key is currently being processed.

LoadFromYAML loads configuration from a YAML file and returns a pointer to Config

MakeWeatherCacheKey generates a normalized, stable cache key for weather requests. Lat/lon are rounded to ~100m precision to avoid cache fragmentation

NewCache creates a new cache instance according to the configuration.

NewCache returns new cache reader for the specified config.

NewCacheLocator creates a Locator backed by wttr.in-style location cache

NewCachedWeatherClient creates a new caching wrapper around a WeatherClient.

NewDiskCacher creates a new disk-backed cache. dir will be created if it doesn't exist.

NewHTMLFormatter loads the embedded template and CSS.

NewIPLocatorGeoIP2 creates a new IPLocator using the given GeoIP2-City.mmdb (or GeoLite2-City.mmdb) file. Call Close() when you're done with it (or us

NewLogSuppressor creates a new LogSuppressor for specified filename and lines to be suppressed. If filename is empty, log entries will be printed to

NewPNGFormatter creates a new PNG formatter.

NewPNGOptions returns sensible defaults matching original wttr.in behavior

NewPrometheusRenderer creates a new Prometheus renderer

NewRenderer creates a new subprocess renderer with the given routing rules. The slice order determines matching priority (first match wins).

NewSearcher returns a new Searcher for the specified config.

NewWeatherClient creates a new WeatherClient with proper connection pooling.

NewWeatherService initializes a new pipeline based on the provided options.

Parse implements QueryParser.Parse

ParseOptionsInFilename converts a wttr.in-style PNG filename into *options.Options using the same parsing/validation pipeline as normal ?query=string

Put stores the location in the configured backend (now uses batching for DB)

Read fetches location from cache (LRU already checked in Resolve).

RemoveFileIfExists removes filename if exists, or does nothing if the file is not there. Returns an error, if it occurred during deletion.

Render implements the weather.Renderer interface.

RenderANSI renders ANSI text to PNG using strongly-typed PNGOptions.

────────────────────────────────────────────────────────────────────────────── All render functions — same signature ─────────────────────────────────

RenderMoonPhaseEmoji — improved to better match visual expectation + Python spirit

Search makes queries through all known providers, and returns response, as soon as it is not nil. If all responses were nil, the last response is retu

SplitCamelCase splits a CamelCase string into words and joins them with spaces.

ToANSI converts a go-te Screen back into a colored ANSI string that can be printed directly to a terminal.

TolerantUnescape decodes a string by replacing percent-encoded sequences (%XX) with their corresponding byte values, where XX is a two-digit hexadecim

TranslateWeather translates weather descriptions and adds both lang_xx and lang_{lang} keys.

TruecolorTo256 converts all 24-bit truecolor ANSI sequences (;G;Bm and ;G;Bm) into the closest 256-color equivalents (NNm and

WeatherHandler handles weather requests with proper cache coalescing.

=================================================================== Remaining drawing functions (not in helpers.go) ==================================

ansi256ToColor maps common 256-color values used by wttr.in

applyValidationRule applies a single validation rule (e.g., "length 6", "regexp [0-9a-fA-F]{6}").

── Batch Writer ─────────────────────────────────────────────────────────────

box — exact port of Python _box

buildCacheKey generates a cache signature very similar to original wttr.in logic