def convert(format: str, files: List[PathLike], output_dir: Path) -> None:
"""
Converts the given files to the specified format.
Parameters
----------
format: str
The target format to export to.
files: List[PathLike]
List of files to be converted.
output_dir: Path
Folder where the exported annotations will be placed.
"""
try:
parser: ExportParser = get_exporter(format)
except ExporterNotFoundError:
_error(
f"Unsupported export format, currently supported: {export_formats}"
)
except AttributeError:
_error(
f"Unsupported export format, currently supported: {export_formats}"
)
export_annotations(parser, files, output_dir)
def dataset_convert(dataset_identifier: str,
format: str,
output_dir: Optional[PathLike] = None) -> None:
"""
Converts the annotations from the given dataset to the given format.
Exits the application if no dataset with the given slug exists or no releases for the dataset
were previously pulled.
Parameters
----------
dataset_identifier: str
The dataset identifier, normally in the "<team-slug>/<dataset-slug>:<version>" form.
format: str
The format we want to convert to.
output_dir: Optional[PathLike]
The folder where the exported annotation files will be. If None it will be the inside the
annotations folder of the dataset under 'other_formats/{format}'. The Defaults to None.
"""
identifier: DatasetIdentifier = DatasetIdentifier.parse(dataset_identifier)
client: Client = _load_client(team_slug=identifier.team_slug)
try:
parser: ExportParser = get_exporter(format)
dataset: RemoteDataset = client.get_remote_dataset(
dataset_identifier=identifier)
if not dataset.local_path.exists():
_error(
f"No annotations downloaded for dataset f{dataset}, first pull a release using "
f"'darwin dataset pull {identifier}'")
release_path: Path = get_release_path(dataset.local_path,
identifier.version)
annotations_path: Path = release_path / "annotations"
if output_dir is None:
output_dir = release_path / "other_formats" / format
else:
output_dir = Path(output_dir)
output_dir.mkdir(parents=True, exist_ok=True)
export_annotations(parser, [annotations_path], output_dir)
except ExporterNotFoundError:
_error(
f"Unsupported export format: {format}, currently supported: {export_formats}"
)
except AttributeError:
_error(
f"Unsupported export format: {format}, currently supported: {export_formats}"
)
except NotFound as e:
_error(f"No dataset with name '{e.name}'")
def dataset_convert(dataset_slug: str, format: str, output_dir: Optional[Union[str, Path]]):
client = _load_client()
parser = find_supported_format(format, darwin.exporter.formats.supported_formats)
try:
dataset = client.get_remote_dataset(dataset_identifier=dataset_slug)
if not dataset.local_path.exists():
_error(
f"No annotations downloaded for dataset f{dataset}, first pull a release using "
f"'darwin dataset pull {dataset_slug}'"
)
release_path = get_release_path(dataset.local_path)
annotations_path = release_path / "annotations"
if output_dir is None:
output_dir = release_path / "other_formats" / f"{format}"
else:
output_dir = Path(output_dir)
output_dir.mkdir(parents=True, exist_ok=True)
exporter.export_annotations(parser, [annotations_path], output_dir)
except NotFound as e:
_error(f"No dataset with name '{e.name}'")
def convert(format, files, output_dir):
parser = find_supported_format(format,
darwin.exporter.formats.supported_formats)
exporter.export_annotations(parser, files, output_dir)