cadrumo.core.config_integration_fields module

Google, workbook-parity, and financial-ingest settings.

Split from config to keep the central settings facade within the line budget. Settings inherits these fields with their declared validation and defaults. Product-owned fields derive CADRUMO_* environment names; authority-owned integration fields retain explicit AEAT_* names.

See also

Settings

Central environment facade that inherits this mixin and normalizes its path fields.

load_settings()

Runtime entry point used by integration consumers to read these fields.

factory

Outbound storage factory that consumes the Google Drive vault defaults.

csv

CSV financial-ingest provider that reads the default CSV encoding.

class CadrumoIntegrationSettings(_case_sensitive=None, _nested_model_default_partial_update=None, _env_prefix=None, _env_prefix_target=None, _env_file=PosixPath('.'), _env_file_encoding=None, _env_ignore_empty=None, _env_nested_delimiter=None, _env_nested_max_split=None, _env_parse_none_str=None, _env_parse_enums=None, _cli_prog_name=None, _cli_parse_args=None, _cli_settings_source=None, _cli_parse_none_str=None, _cli_hide_none_type=None, _cli_avoid_json=None, _cli_enforce_required=None, _cli_use_class_docs_for_groups=None, _cli_show_env_vars=None, _cli_exit_on_error=None, _cli_prefix=None, _cli_flag_prefix_char=None, _cli_implicit_flags=None, _cli_ignore_unknown_args=None, _cli_kebab_case=None, _cli_shortcuts=None, _secrets_dir=None, _build_sources=None, **values)[source]

Bases: CadrumoRuntimeSettings

Settings for external integration defaults and local financial stores.

Parameters:
  • _case_sensitive (bool | None)

  • _nested_model_default_partial_update (bool | None)

  • _env_prefix (str | None)

  • _env_prefix_target (EnvPrefixTarget | None)

  • _env_file (DotenvType | None)

  • _env_file_encoding (str | None)

  • _env_ignore_empty (bool | None)

  • _env_nested_delimiter (str | None)

  • _env_nested_max_split (int | None)

  • _env_parse_none_str (str | None)

  • _env_parse_enums (bool | None)

  • _cli_prog_name (str | None)

  • _cli_parse_args (bool | list[str] | tuple[str, ...] | None)

  • _cli_settings_source (CliSettingsSource[Any] | None)

  • _cli_parse_none_str (str | None)

  • _cli_hide_none_type (bool | None)

  • _cli_avoid_json (bool | None)

  • _cli_enforce_required (bool | None)

  • _cli_use_class_docs_for_groups (bool | None)

  • _cli_show_env_vars (bool | None)

  • _cli_exit_on_error (bool | None)

  • _cli_prefix (str | None)

  • _cli_flag_prefix_char (str | None)

  • _cli_implicit_flags (bool | Literal['dual', 'toggle'] | None)

  • _cli_ignore_unknown_args (bool | None)

  • _cli_kebab_case (bool | Literal['all', 'no_enums'] | None)

  • _cli_shortcuts (Mapping[str, str | list[str]] | None)

  • _secrets_dir (PathType | None)

  • _build_sources (tuple[tuple[PydanticBaseSettingsSource, ...], dict[str, Any]] | None)

  • cadrumo_browser_navigation_timeout_ms (int)

  • cadrumo_browser_form_interaction_timeout_ms (int)

  • cadrumo_browser_ver_click_timeout_ms (int)

  • cadrumo_browser_buscar_settle_ms (int)

  • cadrumo_browser_selector_probe_timeout_ms (int)

  • cadrumo_browser_close_timeout_ms (int)

  • cadrumo_live_iva_surface_timeout_ms (int)

  • cadrumo_live_iva_declaration_capture_timeout_ms (int)

  • cadrumo_live_filed_register_walk_timeout_ms (int)

  • cadrumo_live_iva_cancellation_drain_ms (int)

  • cadrumo_live_iva_cli_watchdog_timeout_ms (int)

  • cadrumo_fx_rate_lookup_timeout_s (int)

  • cadrumo_llm_openai_chat_completions_url (str)

  • cadrumo_llm_gemini_generate_content_template (str)

  • cadrumo_llm_ollama_chat_url (str)

  • cadrumo_llm_ollama_num_ctx (int)

  • cadrumo_llm_vision_read_timeout_s (int)

  • cadrumo_llm_ollama_vision_model (str)

  • cadrumo_llm_ollama_text_model (str)

  • cadrumo_llm_ollama_mapping_model (str)

  • cadrumo_llm_cloud_vision_model (str)

  • cadrumo_llm_cloud_text_model (str)

  • cadrumo_llm_cloud_mapping_model (str)

  • cadrumo_llm_model_runtime_memory_floor_bytes (int)

  • cadrumo_llm_contention_safety_margin_bytes (int)

  • cadrumo_llm_contention_check_override (bool)

  • cadrumo_llm_local_inference_concurrency (int)

  • cadrumo_llm_default_max_tokens (int)

  • cadrumo_llm_default_temperature (float)

  • cadrumo_browser_locale (str)

  • cadrumo_browser_timezone (str)

  • cadrumo_browser_viewport_width (int)

  • cadrumo_browser_viewport_height (int)

  • cadrumo_file_lock_timeout_s (float)

  • cadrumo_file_lock_retry_backoff_s (float)

  • cadrumo_bucket_lock_poll_interval_s (float)

  • cadrumo_bucket_default_idle_lock_minutes (int)

  • cadrumo_bucket_default_session_absolute_minutes (int)

  • cadrumo_auth_clave_movil_lock_buffer_s (int)

  • cadrumo_auth_certificate_lock_ttl_s (int)

  • cadrumo_log_stderr_level (str)

  • cadrumo_log_file_level (str)

  • cadrumo_log_file_max_bytes (int)

  • cadrumo_log_file_backup_count (int)

  • cadrumo_log_root_level (str)

  • cadrumo_manuals_http_timeout_s (float)

  • cadrumo_google_drive_vault_folder_name (str)

  • cadrumo_google_oauth_access_refresh_buffer_s (int)

  • cadrumo_calc_sheets_recalc_delay_s (float)

  • financial_base_currency (str)

  • financial_default_csv_encoding (str)

  • cadrumo_financial_txs_dir (Path)

  • cadrumo_invoices_dir (Path)

  • cadrumo_attachments_dir (Path)

  • cadrumo_usage_ratios_path (Path)

cadrumo_google_drive_vault_folder_name: str
cadrumo_google_oauth_access_refresh_buffer_s: int
cadrumo_calc_sheets_recalc_delay_s: float
financial_base_currency: str
financial_default_csv_encoding: str
cadrumo_financial_txs_dir: Path
cadrumo_invoices_dir: Path
cadrumo_attachments_dir: Path
cadrumo_usage_ratios_path: Path