"""Helper methods for request response parameters."""

from email.message import Message

import requests


def get_filename_from_content_disposition(response: requests.Response) -> str | None:
    """From a Response's Content-Disposition header, return the parsed filename."""
    message = Message()
    content_disposition = response.headers.get('Content-Disposition')
    if not content_disposition:
        return None

    message['content-type'] = content_disposition
    filename_param = message.get_param('filename')
    return filename_param if isinstance(filename_param, str) else None