capcat.core.downloader

File: Application/capcat/core/downloader.py

Description

Media downloader for Capcat. Handles downloading of images, documents, audio, and video files.

Constants

_KNOWN_EXTENSIONS

Value: {'.pdf', '.doc', '.docx', '.xls', '.xlsx', '.ppt', '.pptx', '.odt', '.ods', '.odp', '.rtf', '.txt', '.jpg', '.jpeg', '.png', '.gif', '.bmp', '.tiff', '.webp', '.mp3', '.wav', '.ogg', '.flac', '.mp4', '.avi', '.mov', '.webm'}

Functions

is_document_url

def is_document_url(url: str) -> bool

Check if a URL points to a document file using file extension only (fast).

Parameters:

• url (str)

Returns: bool

is_audio_url

def is_audio_url(url: str) -> bool

Check if a URL points to an audio file using file extension only (fast).

Parameters:

• url (str)

Returns: bool

is_video_url

def is_video_url(url: str) -> bool

Check if a URL points to a video file using file extension only (fast).

Parameters:

• url (str)

Returns: bool

is_image_url

def is_image_url(url: str) -> bool

Check if a URL points to an image file using file extension only (fast).

Parameters:

• url (str)

Returns: bool

download_file

def download_file(file_url: str, folder_path: str, file_type: str, media_enabled: bool = False) -> Optional[str]

Download a file (image, document, audio, or video) and save it to the appropriate folder.

Args: file_url: URL of the file to download folder_path: Path to the article folder file_type: Type of file (‘image’, ‘audio’, ‘video’, ‘document’) media_enabled: Whether –media flag is enabled (affects size limits)

Parameters:

• file_url (str)
• folder_path (str)
• file_type (str)
• media_enabled (bool) optional

Returns: Optional[str]

⚠️ High complexity: 75