mdl_config.h

Go to the documentation of this file.

#pragma once
 
#include <stddef.h>
#include <stdint.h>
 
#include "mdl_politeness.h"
#include "mdl_storage.h"
#include "ra8_err.h"

typedef enum : uint8_t {
  k_mdl_order_doc     = 0, 
  k_mdl_order_reverse = 1, 
  k_mdl_order_asc     = 2, 
} mdl_chapter_order_t;

typedef enum : uint16_t {
  k_mdl_name_max       = 64,  
  k_mdl_host_max       = 128, 
  k_mdl_kind_max       = 16,  
  k_mdl_match_max      = 128, 
  k_mdl_attr_max       = 16,  
  k_mdl_contact_max    = 128, 
  k_mdl_search_url_max = 256, 
} mdl_config_limits_t;

typedef struct {
  char name[k_mdl_name_max];       
  char host[k_mdl_host_max];       
  char kind[k_mdl_kind_max];       
  char contact[k_mdl_contact_max]; 
 
  /* Chapter list, found on a series page. */
  char                chapter_url_contains[k_mdl_match_max];    
  char                chapter_url_prefix[k_mdl_search_url_max]; 
  mdl_chapter_order_t chapter_order;                            
 
  /* Page images, found on a chapter page. */
  char page_img_attr[k_mdl_attr_max];          
  char page_img_url_contains[k_mdl_match_max]; 
 
  /* Search / discovery (#304). Empty when the site descriptor supplies none. */
  char search_url[k_mdl_search_url_max];        
  char search_result_contains[k_mdl_match_max]; 
  char browse_url[k_mdl_search_url_max];        
 
  /* Metadata extraction (#306). Selectors use the bounded grammar documented
   * by mdl_extract_selector(): meta:, class:, label:, or literal:. */
  char series_title_selector[k_mdl_match_max];   
  char series_summary_selector[k_mdl_match_max]; 
  char series_author_selector[k_mdl_match_max];  
  char series_artist_selector[k_mdl_match_max];  
  char series_cover_selector[k_mdl_match_max];   
  char chapter_title_selector[k_mdl_match_max];  
  char chapter_number_selector[k_mdl_match_max]; 
  char language[k_mdl_kind_max];                 
  char reading_direction[k_mdl_kind_max];        
 
  /* Politeness jitter (milliseconds); baseline spacing, jittered in [min,max].
   */
  uint32_t img_delay_min;     
  uint32_t img_delay_max;     
  uint32_t chapter_delay_min; 
  uint32_t chapter_delay_max; 
 
  /* Governor: closed-loop per-host rate/backoff/concurrency (see
   * mdl_politeness). */
  uint32_t rate_per_min;    
  uint32_t burst;           
  uint32_t backoff_base_ms; 
  uint32_t backoff_max_ms;  
  uint32_t max_inflight;    
} mdl_site_t;

[[nodiscard]] ra8_err_t mdl_config_load(mdl_storage_t* storage, const char* path, mdl_site_t* out);

mdl_gov_cfg_t mdl_config_gov_cfg(const mdl_site_t* site);

void mdl_config_apply_polite(mdl_site_t* site);