WeatherRaw is a type alias for raw weather data returned by a weather backend. It is typically JSON or another serialized format. The actual structur

Address information.

Astronomy contains sunrise, sunset, moon phase and related information for a day.

Bundle holds all translation data and implements Localizer.

Cache combines in-memory LRU, SQLite read pool, and write support.

Cache provides access to the IP Geodata cache.

CacheEntry represents a cached response entry. It is designed to be immutable once created and stored in any cache implementation. The entry includes

CacheLayer defines the settings for a single cache layer. Different layers can use completely different backends and TTLs.

CachedWeatherClient wraps the original WeatherClient with disk/memory caching and request coalescing.

Cacher defines the contract for all cache implementations used by the request processor. Implementations may use LRU, Redis, in-memory maps, etc.

ClientData holds information about the client making the request.

ConditionByNameFunc returns a translated condition by its English name.

ConditionFunc returns a translated weather condition by numeric code.

Config holds configuration for all cache layers used by the service. We have two (and potentially more) semantically different caches: 1. Responses

Config holds configuration for all renderers that need external config.

Config holds the server configuration loaded from YAML.

Config is the root configuration structure for the entire service.

CurrentCondition represents the current observed weather conditions.

DiskCacher is a filesystem-backed implementation of Cacher. Completed entries are persisted to disk as JSON files. In-progress state is kept in-memory

=================================================================== Emoji Profiles & Width Management (new centralized system) =======================

FormatOutput represents the final output ready to be sent to the client. It includes both the content and the appropriate HTTP Content-Type header.

FormatSpecifier represents a single format specifier in the one-line output mode.

Formatter interface for converting rendered output into the final format.

GeneratedField holds template data for one field

HTMLFormatter converts ANSI weather output into a full HTML page using buildkite/terminal-to-html.

Hourly represents hourly weather forecast data.

IPData holds geolocation information derived from the client's IP address.

IPLocator interface to fetch IP-related data.

IPLocatorGeoIP2 is an implementation of IPLocator using MaxMind GeoIP2 / GeoLite2 City database.

J2Renderer is a renderer that produces a minified JSON output of weather data with hourly entries removed for a more compact representation.

L10n is a convenient wrapper that provides pre-bound localization functions for a specific language from Options. Use `l10n` as the variable name to

LRUCacher is a Cacher implementation backed by an LRU cache with support for in-progress markers to prevent thundering herd problems.

LocalizeFunc is a language-bound text localization function.

Localizer provides localized strings for a specific language.

Location represents a cached geocoding result.

Location represents a geographic location for which weather data is requested. It can be populated either from user input (city name, coordinates) or

Locator interface to fetch location-related data.

LogSuppressor provides io.Writer interface for logging with lines suppression. For usage with log.Logger.

NearestArea represents information about the nearest location/area.

NoOpCacher is a no-operation implementation of Cacher. Used when a cache layer is disabled in configuration.

OnelineRenderer is responsible for rendering weather data in the compact one-line text format (?format=... or preconfigured IDs). It implements the w

OptionConfig mirrors the YAML structure (adjusted for generation needs)

Options represents parsed and validated wttr.in query options.

OptionsConfig is the root of the YAML

PNGFormatter converts ANSI-rendered weather output into a PNG image.

PNGOptions contains all options relevant to ANSI → PNG rendering.

PageRenderer serves static embedded text pages (help, about, ...). It now fully supports multilanguage via the Localizer.

ParsedCurrentCondition is a normalized, ready-to-use view of current weather extracted from the WorldWeatherOnline-style JSON response

PreconfiguredFormat represents one named preset for ?format=...

Query represents the complete context of a single weather request. It aggregates all information needed to process and respond to a request: client d

QueryOption defines a single query option for wttr.in, such as `lang` or `format`.

QueryParser parses wttr.in / curl wttr.in style HTTP query strings and returns the result as a strongly-typed *options.Options struct.

Range defines a numeric range for integer-type query options.

RenderContext holds everything a single placeholder might need

────────────────────────────────────────────────────────────────────────────── Unified render function signature ─────────────────────────────────────

RenderOutput is the intermediate result produced by a Renderer. It typically contains ANSI-colored or plain text output intended for terminal or furt

Renderer interface for rendering weather data into a visual representation.

Renderer implements weather.Renderer by executing an external subprocess.

Request represents the parameters used for the weather query.

RequestLogger logs incoming HTTP requests with aggregation and periodic flushing.

SubprocessRoute defines a single routing rule for the subprocess renderer.

TLSCertConfig defines one certificate + its matching domain(s).

Formatter Implementations

TimeTracker holds timing information for each step in the pipeline.

UplinkProcessor handles incoming requests.

V1Renderer renders weather in the classic wttr.in v1 style.

V2Renderer implements the rich panel view (temperature diagram, rain sparkline, weather emojis, colored wind, astronomical data, frame, etc.)

ValueItem is a common wrapper used for most description/icon fields (single object with "value" key).

WWOConfig holds configuration for the weather API (e.g. World Weather Online)

WeatherData represents the top-level structure of the weather API response.

WeatherClient fetches weather data with controlled concurrency and connection reuse.

WeatherDay represents daily weather forecast data (one entry per date).

WeatherService struct holds the components necessary for processing a query.

Weatherer interface to fetch weather data based on location and language.

WttrInOptions represents the configuration for wttr.in query options and format specifiers.

cacheLocator implements Locator using wttr.in's Cache + Resolve logic

certMap maps domain name -> certificate

languageData holds preloaded translation data for one language.