Struct WebClient 

pub struct WebClient {
    pub config: Config,
    pub puzzle_cache: Box<dyn PuzzleCache>,
    pub session_cache: Box<dyn SessionCache>,
    /* private fields */
}

HTTP-based implementation of the Client trait that talks with the Advent of Code website.

Initialization Patterns

1. new() - Creates a client with default configuration. Requires a valid user config, a config in the local directory, or the AOC_SESSION_ID and AOC_PASSPHRASE environment variables to be set.

2. with_options(ClientOptions) - Creates a client with custom configuration options (directories, passphrase, etc.). This is the standard path for most use cases.

3. with_custom_impl(ClientConfig, Box<dyn AdventOfCodeProtocol>) - For testing usage. Allows callers to inject a mock HTTP implementation. Caches are still created automatically from the config.

Dependencies

• Session ID: Required for authentication. Must be a valid Advent of Code session cookie.
• Network Access: Required for fetching new puzzles and submitting answers.
• Passphrase: Used to encrypt cached puzzle inputs on disk (as requested by AoC maintainer).
• Cache Directories: Created automatically if missing.

Fields

config: Config

The client configuration (session ID, cache directories, passphrase, etc)

puzzle_cache: Box<dyn PuzzleCache>

Stores encrypted puzzle inputs and answer data.

session_cache: Box<dyn SessionCache>

Stores submission timeout state.

Implementations

impl WebClient

pub fn new() -> Result<Self, ClientError>

Creates a client with default configuration from environment variables.

pub fn with_config(config: Config) -> Self

Creates a client with custom configuration options.

pub fn with_custom_impl( config: Config, advent_protocol: Box<dyn ServiceConnector>, ) -> Self

Creates a client with a custom HTTP protocol implementation.

Useful for testing or using an alternative HTTP backend. Caches are automatically created from the provided config.

Trait Implementations

impl Client for WebClient

fn years(&self) -> Vec<Year>

Returns the list of available puzzle years starting at 2015. The current year is included when the current month is December.

fn days(&self, year: Year) -> Option<Vec<Day>>

Returns the list of available puzzle days for a given year. None is returned when year is the current year, and the current month is not December.

fn get_input(&self, day: Day, year: Year) -> Result<String, ClientError>

Fetches the puzzle input for a given day and year. Cached inputs are returned without fetching from the service.

fn submit_answer( &mut self, answer: Answer, part: Part, day: Day, year: Year, ) -> Result<CheckResult, ClientError>

Submits an answer for a puzzle part. Cached answers are returned immediately without submitting to the service.

fn get_puzzle(&self, day: Day, year: Year) -> Result<Puzzle, ClientError>

Fetches the complete puzzle data (input and cached answers) for a given day and year.