External_Service_Integration.md

graph LR
    Cache_Orchestrator["Cache Orchestrator"]
    Fastly_Purge_Manager["Fastly Purge Manager"]
    Fastly_Purge_Operations["Fastly Purge Operations"]
    Category_Change_Invalidation_Logic["Category Change Invalidation Logic"]
    Metadata_Provider["Metadata Provider"]
    Cache_Orchestrator -- "initiates" --> Fastly_Purge_Manager
    Cache_Orchestrator -- "initiates" --> Category_Change_Invalidation_Logic
    Fastly_Purge_Manager -- "delegates to" --> Fastly_Purge_Operations
    Category_Change_Invalidation_Logic -- "depends on" --> Metadata_Provider
    Category_Change_Invalidation_Logic -- "initiates" --> Fastly_Purge_Manager

Loading

Details

This subsystem is responsible for abstracting and managing interactions with external Content Delivery Networks (CDNs), specifically Fastly, for cache invalidation tasks within the arXiv-NG ecosystem. It provides a structured interface for other arXiv services to request cache purges without needing to understand the underlying Fastly API complexities.

Cache Orchestrator

Serves as the high-level public API for initiating cache invalidation requests. It orchestrates the overall purge process, determining the necessary purge operations based on the application's context (e.g., a specific paper). It abstracts the complexities of Fastly interactions from the calling application.

Related Classes/Methods:

• purge_cache_for_paper:24-34

Fastly Purge Manager

Manages the direct communication and interaction with the Fastly API. It is responsible for executing both single and multiple key purges, potentially optimizing for batch operations. This component acts as the direct interface to the external Fastly service.

Related Classes/Methods:

• purge_fastly_keys:111-132

Fastly Purge Operations

This conceptual component groups the low-level, atomic operations for purging Fastly cache keys. It includes functionalities for purging individual keys and efficiently handling multiple keys, potentially with batching or chunking.

Related Classes/Methods:

• _purge_single_key:134-142
• _purge_multiple_keys:144-160

Category Change Invalidation Logic

Encapsulates specific business logic for cache invalidation scenarios related to changes in paper categories. This component determines the specific set of keys or rules required for purging when a category update occurs, ensuring targeted and efficient invalidation.

Related Classes/Methods:

• _purge_category_change:62-109

Metadata Provider

A utility component responsible for extracting and providing necessary metadata (such as category and date information) required by specific cache invalidation scenarios, particularly for the Category Change Invalidation Logic. It ensures that the correct data is available for complex purge operations.

Related Classes/Methods:

• _get_category_and_date:36-60

FAQ