Gecko [ v3.cesa.co.za ]

Name	Size	Permission	Date
ArchiveDownloader.php	8.45 KB	-rw-r--r--	2023-03-21 10:50
ChangeReportInterface.php	807 B	-rw-r--r--	2023-03-21 10:50
DownloadManager.php	15.25 KB	-rw-r--r--	2023-03-21 10:50
DownloaderInterface.php	3.86 KB	-rw-r--r--	2023-03-21 10:50
DvcsDownloaderInterface.php	823 B	-rw-r--r--	2023-03-21 10:50
FileDownloader.php	19.28 KB	-rw-r--r--	2023-03-21 10:50
FilesystemException.php	709 B	-rw-r--r--	2023-03-21 10:50
FossilDownloader.php	4.45 KB	-rw-r--r--	2023-03-21 10:50
GitDownloader.php	24.83 KB	-rw-r--r--	2026-05-14 09:28
GzipDownloader.php	2.16 KB	-rw-r--r--	2023-03-21 10:50
HgDownloader.php	3.69 KB	-rw-r--r--	2023-03-21 10:50
MaxFileSizeExceededException.php	392 B	-rw-r--r--	2023-03-21 10:50
PathDownloader.php	12.7 KB	-rw-r--r--	2023-03-21 10:50
PerforceDownloader.php	3.36 KB	-rw-r--r--	2023-03-21 10:50
PharDownloader.php	1.11 KB	-rw-r--r--	2023-03-21 10:50
RarDownloader.php	2.51 KB	-rw-r--r--	2023-03-21 10:50
SvnDownloader.php	8.85 KB	-rw-r--r--	2023-03-21 10:50
TarDownloader.php	901 B	-rw-r--r--	2023-03-21 10:50
TransportException.php	1.72 KB	-rw-r--r--	2023-03-21 10:50
VcsCapableDownloaderInterface.php	836 B	-rw-r--r--	2023-03-21 10:50
VcsDownloader.php	12.65 KB	-rw-r--r--	2023-03-21 10:50
XzDownloader.php	1.1 KB	-rw-r--r--	2023-03-21 10:50
ZipDownloader.php	12.85 KB	-rw-r--r--	2023-03-21 10:50

Rename

<?php declare(strict_types=1);

/*
 * This file is part of Composer.
 *
 * (c) Nils Adermann <naderman@naderman.de>
 *     Jordi Boggiano <j.boggiano@seld.be>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Composer\Downloader;

use Composer\Package\PackageInterface;
use React\Promise\PromiseInterface;

/**
 * Downloader interface.
 *
 * @author Konstantin Kudryashov <ever.zet@gmail.com>
 * @author Jordi Boggiano <j.boggiano@seld.be>
 */
interface DownloaderInterface
{
    /**
     * Returns installation source (either source or dist).
     *
     * @return string "source" or "dist"
     */
    public function getInstallationSource(): string;

/**
     * This should do any network-related tasks to prepare for an upcoming install/update
     *
     * @param  string $path download path
     */
    public function download(PackageInterface $package, string $path, ?PackageInterface $prevPackage = null): PromiseInterface;

/**
     * Do anything that needs to be done between all downloads have been completed and the actual operation is executed
     *
     * All packages get first downloaded, then all together prepared, then all together installed/updated/uninstalled. Therefore
     * for error recovery it is important to avoid failing during install/update/uninstall as much as possible, and risky things or
     * user prompts should happen in the prepare step rather. In case of failure, cleanup() will be called so that changes can
     * be undone as much as possible.
     *
     * @param  string                $type        one of install/update/uninstall
     * @param  PackageInterface      $package     package instance
     * @param  string                $path        download path
     * @param  PackageInterface      $prevPackage previous package instance in case of an update
     */
    public function prepare(string $type, PackageInterface $package, string $path, ?PackageInterface $prevPackage = null): PromiseInterface;

/**
     * Installs specific package into specific folder.
     *
     * @param  PackageInterface      $package package instance
     * @param  string                $path    download path
     */
    public function install(PackageInterface $package, string $path): PromiseInterface;

/**
     * Updates specific package in specific folder from initial to target version.
     *
     * @param  PackageInterface      $initial initial package
     * @param  PackageInterface      $target  updated package
     * @param  string                $path    download path
     */
    public function update(PackageInterface $initial, PackageInterface $target, string $path): PromiseInterface;

/**
     * Removes specific package from specific folder.
     *
     * @param  PackageInterface      $package package instance
     * @param  string                $path    download path
     */
    public function remove(PackageInterface $package, string $path): PromiseInterface;

/**
     * Do anything to cleanup changes applied in the prepare or install/update/uninstall steps
     *
     * Note that cleanup will be called for all packages, either after install/update/uninstall is complete,
     * or if any package failed any operation. This is to give all installers a change to cleanup things
     * they did previously, so you need to keep track of changes applied in the installer/downloader themselves.
     *
     * @param  string                $type        one of install/update/uninstall
     * @param  PackageInterface      $package     package instance
     * @param  string                $path        download path
     * @param  PackageInterface      $prevPackage previous package instance in case of an update
     */
    public function cleanup(string $type, PackageInterface $package, string $path, ?PackageInterface $prevPackage = null): PromiseInterface;
}