Exceptions¶

obsidian_export.exceptions ¶

Custom exceptions for obsidian-export.

Bases: Exception

Base exception for obsidian-export.

Source code in obsidian_export/exceptions.py

class ObsidianExportError(Exception):
    """Base exception for obsidian-export."""

A ![[embed]] reference could not be resolved.

Source code in obsidian_export/exceptions.py

class EmbedNotFoundError(ObsidianExportError):
    """A ![[embed]] reference could not be resolved."""

Circular embed chain detected.

Source code in obsidian_export/exceptions.py

class CircularEmbedError(ObsidianExportError):
    """Circular embed chain detected."""

SVG file not found or conversion failed.

Source code in obsidian_export/exceptions.py

class SVGConversionError(ObsidianExportError):
    """SVG file not found or conversion failed."""

Non-SVG image conversion failed (e.g. WebP/AVIF/BMP/TIFF to PNG).

Source code in obsidian_export/exceptions.py

class ImageConversionError(ObsidianExportError):
    """Non-SVG image conversion failed (e.g. WebP/AVIF/BMP/TIFF to PNG)."""

Profile name is invalid or contains path traversal sequences.

Source code in obsidian_export/exceptions.py

class ProfileNameError(ObsidianExportError):
    """Profile name is invalid or contains path traversal sequences."""

Embed path resolves outside the vault root (path traversal attempt).

Source code in obsidian_export/exceptions.py

class PathTraversalError(ObsidianExportError):
    """Embed path resolves outside the vault root (path traversal attempt)."""

Output format is not supported (must be 'pdf' or 'docx').

Source code in obsidian_export/exceptions.py

class UnsupportedFormatError(ObsidianExportError):
    """Output format is not supported (must be 'pdf' or 'docx')."""

Mermaid diagram rendering via mmdc failed.

Source code in obsidian_export/exceptions.py

class MermaidRenderError(ObsidianExportError):
    """Mermaid diagram rendering via mmdc failed."""

A config value failed validation (e.g. unsafe pandoc format or illegal characters).

Source code in obsidian_export/exceptions.py

class ConfigValueError(ObsidianExportError):
    """A config value failed validation (e.g. unsafe pandoc format or illegal characters)."""

LaTeX value from config contains a dangerous macro.

Source code in obsidian_export/exceptions.py

class UnsafeLatexError(ObsidianExportError):
    """LaTeX value from config contains a dangerous macro."""