Defines a function that fetches raw byte data from a given URL and returns it as an optional bytes object.

Declares the interface for a data‑fetching function, signaling intent to retrieve binary data from a network resource.

When needing to download raw binary data from a URL, e.g., fetching a file, API response body, or binary blob.

Used in network clients, downloaders, API clients, file downloaders, or any code that retrieves binary data from a remote source.

def <function_name>(<param>: <type>) -> <return_type>:

def fetch_data(url: str) -> Optional[bytes]:

function_name: any valid identifier; url: any variable holding a URL string; return type: Optional[<type>] or other return type.

• requests
• urllib
• urlopen
• bytes
• None
• Optional
• typing
• fetch
• download
• url

• url → endpoint
• path
• uri
• return type → Optional[str]
• Optional[List[bytes]]
• custom Result type

forgetting to import Optional from typing; not handling the None return; ignoring exceptions; failing to close response resources; assuming bytes are always returned

def fetch_data(url: str) -> str: (returns text); def fetch_json(url: str) -> dict: (returns parsed JSON); def download_file(url: str, path: str) -> None: (writes to file)

Confusing with similarly named functions like fetch_text, fetch_json, or fetch_data_async; mixing up return types (bytes vs. str).

• data fetching utilities
• network API patterns

Returning Optional[bytes] signals that the function may return None on failure, requiring callers to handle the absence of data explicitly.

Signals intent to retrieve raw binary data, indicating low‑level data handling rather than processed formats.

Think of fetching raw bytes from a URL, like downloading a file.

fetch_data_with_retry(url: str, retries: int = 3) -> Optional[bytes]