Skip to content

resume ¤

Command to resume downloads.

Functions:

  • resume –

    Resume subcommand.

resume ¤

resume(
    api: API,
    gids: list[str] | None = None,
    do_all: bool = False,
) -> int

Resume subcommand.

Parameters:

  • api (API) –

    The API instance to use.

  • gids (list[str] | None, default: None ) –

    The GIDs of the downloads to resume.

  • do_all (bool, default: False ) –

    Pause all downloads if True.

Returns:

  • int ( int ) –

    0 if all success, 1 if one failure.

Source code in src/aria2p/cli/commands/resume.py 
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
def resume(api: API, gids: list[str] | None = None, do_all: bool = False) -> int:  # noqa: FBT001,FBT002
    """Resume subcommand.

    Parameters:
        api: The API instance to use.
        gids: The GIDs of the downloads to resume.
        do_all: Pause all downloads if True.

    Returns:
        int: 0 if all success, 1 if one failure.
    """
    if do_all:
        if api.resume_all():
            return 0
        return 1

    try:
        downloads = api.get_downloads(gids)
    except ClientException as error:
        print(str(error), file=sys.stderr)
        return 1

    result = api.resume(downloads)

    if all(result):
        return 0

    for item in result:
        if isinstance(item, ClientException):
            print(item, file=sys.stderr)

    return 1