========
Settings
========

Custom plugins are expected to live on the filesystem and be registered from
Python code.

``DJANGO_RESUME_TOKEN_TTL``
===========================

Default: ``datetime.timedelta(days=30)``

Controls how long CV access tokens remain valid after their stored ``created``
timestamp.

Set this to a ``datetime.timedelta`` to enforce token expiration, or ``None`` to
disable age-based expiry checks. Older stored token entries without a
``created`` timestamp continue to work for backward compatibility.

``DJANGO_RESUME_JSON_RESUME_THEME_DIR``
=======================================

Default: ``BASE_DIR / ".django-resume-jsonresume-themes"``

Directory used by the JSON Resume theme catalog to install ``resumed`` and
pinned catalog npm theme packages. The directory is created with owner-only
permissions when possible.

``DJANGO_RESUME_JSON_RESUME_THEME_CATALOG``
===========================================

Default: a small checked-in curated catalog.

Catalog entries may be a list of dictionaries or a mapping from catalog key to
entry metadata. Each entry must provide a stable key, a valid JSON Resume npm
theme package name, an exact version, display metadata, preview image metadata,
and a boolean ``enabled`` value. Disabled entries can be shown as unavailable
but cannot be previewed or selected.

``DJANGO_RESUME_JSON_RESUME_ALLOW_DYNAMIC_THEME_INSTALL``
=========================================================

Default: ``False``

When ``False``, the owner theme selector shows only the curated pinned catalog
and the arbitrary npm search/install endpoint rejects requests. Set this to
``True`` only for development or discovery deployments that accept
owner-triggered installation and execution of third-party npm theme code.

``DJANGO_RESUME_JSON_RESUME_RENDER_MAX_BYTES``
==============================================

Default: ``5000000``

Maximum size, in bytes, of the HTML file produced by a JSON Resume theme render.
Rendering fails if the output exceeds this limit.

``DJANGO_RESUME_JSON_RESUME_PROCESS_OUTPUT_MAX_BYTES``
======================================================

Default: ``200000``

Maximum size, in bytes, captured from each stdout or stderr stream while running
``npm install`` or the JSON Resume renderer. The child process is terminated if
either stream exceeds this limit.