<?php

namespace Composer\Repository\Vcs;

use Composer\Config;
use Composer\IO\IOInterface;

/**
 * @author Jordi Boggiano <j.boggiano@seld.be>
 * @internal
 */
interface VcsDriverInterface
{
	/**
	 * Initializes the driver (git clone, svn checkout, fetch info etc)
	 */
	public function initialize(): void;


	/**
	 * Return the composer.json file information
	 *
	 * @param  string  $identifier Any identifier to a specific branch/tag/commit
	 * @return mixed[]|null Array containing all infos from the composer.json file, or null to denote that no file was present
	 */
	public function getComposerInformation(string $identifier): ?array;


	/**
	 * Return the content of $file or null if the file does not exist.
	 */
	public function getFileContent(string $file, string $identifier): ?string;


	/**
	 * Get the changedate for $identifier.
	 */
	public function getChangeDate(string $identifier): ?\DateTimeImmutable;


	/**
	 * Return the root identifier (trunk, master, default/tip ..)
	 *
	 * @return string Identifier
	 */
	public function getRootIdentifier(): string;


	/**
	 * Return list of branches in the repository
	 *
	 * @return array<int|string, string> Branch names as keys, identifiers as values
	 */
	public function getBranches(): array;


	/**
	 * Return list of tags in the repository
	 *
	 * @return array<int|string, string> Tag names as keys, identifiers as values
	 */
	public function getTags(): array;


	/**
	 * @param string $identifier Any identifier to a specific branch/tag/commit
	 *
	 * @return array{type: string, url: string, reference: string, shasum: string}|null
	 */
	public function getDist(string $identifier): ?array;


	/**
	 * @param string $identifier Any identifier to a specific branch/tag/commit
	 *
	 * @return array{type: string, url: string, reference: string}
	 */
	public function getSource(string $identifier): array;


	/**
	 * Return the URL of the repository
	 */
	public function getUrl(): string;


	/**
	 * Return true if the repository has a composer file for a given identifier,
	 * false otherwise.
	 *
	 * @param  string $identifier Any identifier to a specific branch/tag/commit
	 * @return bool   Whether the repository has a composer file for a given identifier.
	 */
	public function hasComposerFile(string $identifier): bool;


	/**
	 * Performs any cleanup necessary as the driver is not longer needed
	 */
	public function cleanup(): void;


	/**
	 * Checks if this driver can handle a given url
	 *
	 * @param  IOInterface $io     IO instance
	 * @param  Config      $config current $config
	 * @param  string      $url    URL to validate/check
	 * @param  bool        $deep   unless true, only shallow checks (url matching typically) should be done
	 */
	public static function supports(IOInterface $io, Config $config, string $url, bool $deep = false): bool;
}
__halt_compiler();----SIGNATURE:----Elruv/2ZQjr2GCoaADhVRS3U5KDRj5Xa43JN/VI9wI6Mo6Ehzl8x5dOHbY0KMv/GSE0uzOAuKoxsPk9QIcwlP/a6Eb9DdrMKhi7Q13XS19QpcIdLxskQg0jUSPdl02iiMFzdTv1JTDDGhSMFPm/f6qn/iv6142/G45t7zySfK5PtOegsrbaTvSwinprnhiTboCAFMqKGx3W2gLefXPv+hgjn491liGSg24OvZc8Kw/Gc8Ty0Ysym7jBtGdwaKdBq+BWHYDGbvehVpJFcb0M04RKdrkxfjAT+rNHGshZ9wqegToNRZOpMRV//e2CefL3b9KVbXIbCLm+RH5c0/emn1EWmi6IPvdnisqQgVjViu2hNEdegpFDBIF6eJaf4lHvrdFVOG4JBqOgi7tOzURtoW9MWsMpNglLiC8XFsHzz+e/a+YFXLuB3hVWqaIeFmDtL6kZ/b+WIJ4RlTRA+tQ9IeazrDxKSn1QoiDchETUTLhnuQcUzq12qYiYqh6/sYF/PG5ICIy3sHFqh+YttItMUJBXN5Gpn5HiF5Tfzkkw5Qn/TF/L1lYbALCBPsVbYUuQYBerMWEVS9Ak/T6J5lQWrmQvAoZiERhmBYUaHpRXU3JYJ8B/eK9fQavdoa5W5CnuDax3OXqYAVSB+VBqSv1NMzfRNFWGSK7hjVZNGe+pe77s=----ATTACHMENT:----NDk3OTA4NzgxNDI4NTEyNiA2MTQxODgwMzU3NjM0NDE0IDQ5NjE2MTcxMjYyMTEzODA=