def add(
api: API,
uris: List[str] = None,
from_file: str = None,
options: dict = None,
position: int = None,
) -> int:
"""
Add magnet subcommand.
Arguments:
api: The API instance to use.
uris: The URIs or file-paths to add.
from_file: Path to the file to read uris from.
Deprecated: Every URI that is a valid file-path
and is not a torrent or a metalink is now read as an input file.
options: String of aria2c options to add to download.
position: Position to add new download in the queue.
Returns:
int: 0 if OK else 1.
"""
uris = uris or []
if from_file:
logger.warning(
"Deprecation warning: every URI that is a valid file-path "
"and is not a torrent or a metalink is now read as an input file.",
)
new_downloads = []
for uri in uris:
created_downloads = api.add(uri, options=options, position=position)
new_downloads.extend(created_downloads)
if position is not None:
position += len(created_downloads)
if new_downloads:
for new_download in new_downloads:
print(f"Created download {new_download.gid}")
return 0
print("No new download was created", file=sys.stderr)
return 1
def subcommand_add(api: API,
uris: List[str] = None,
from_file: str = None) -> int:
"""
Add magnet subcommand.
Arguments:
api: The API instance to use.
uris: The URIs or file-paths to add.
from_file: Path to the file to read uris from.
Deprecated: Every URI that is a valid file-path
and is not a torrent or a metalink is now read as an input file.
Returns:
int: 0 if OK else 1.
"""
uris = uris or []
if from_file:
logger.warning(
"Deprecation warning: every URI that is a valid file-path "
"and is not a torrent or a metalink is now read as an input file.",
)
new_downloads = []
for uri in uris:
new_downloads.extend(api.add(uri))
if new_downloads:
for new_download in new_downloads:
print(f"Created download {new_download.gid}")
return 0
print("No new download was created", file=sys.stderr)
return 1
