1	<?php
2
3	namespace FileImporter\Interfaces;
4
5	use FileImporter\Data\ImportDetails;
6	use FileImporter\Data\SourceUrl;
7	use FileImporter\Exceptions\SourceUrlException;
8
9	/**
10	* This interface creates ImportDetails objects from a SourceUrl.
11	* This usually means making requests to the site hosting the SourceUrl to get data.
12	*
13	* @license GPL-2.0-or-later
14	* @author Addshore
15	*/
16	interface DetailRetriever {
17
18	/**
19	* @throws SourceUrlException if the given target can't be imported by this importer
20	*/
21	public function getImportDetails( SourceUrl $sourceUrl ): ImportDetails;
22
23	}