1	<?php
2
3	namespace MediaWiki\IPInfo\InfoRetriever;
4
5	interface InfoRetriever {
6
7	/**
8	* Gets the name of the retriever.
9	*
10	* The name of a retriever must be readable by humans and machines and must be unique.
11	*
12	* @return string
13	*/
14	public function getName(): string;
15
16	/**
17	* Retrieve info about an IP address.
18	*
19	* @param string $ip
20	* @return mixed
21	*/
22	public function retrieveFromIP( string $ip );
23	}