BasicDriver::addFileFromString() - Code Metrics - Inspection of "Added checkAbility() for BasicDriver" - wapmorgan/UnifiedArchive - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Push — master ( 125b29...554a92 )

by f
created 2022-07-04 09:03 UTC
BasicDriver::addFileFromString() A

↳ Parent: BasicDriver
Complexity

Conditions	1
Paths	1
Size

Total Lines	3
Code Lines	1
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	0
CRAP Score	2
Importance

Changes
Metric	Value
cc	1
eloc	1
c	0
b	0
f	0
nc	1
nop	2
dl	0
loc	3
rs	10
ccs	0
cts	1
cp	0
crap	2
<?php
namespace wapmorgan\UnifiedArchive\Drivers;

use wapmorgan\UnifiedArchive\ArchiveEntry;
use wapmorgan\UnifiedArchive\ArchiveInformation;
use wapmorgan\UnifiedArchive\Exceptions\ArchiveExtractionException;
use wapmorgan\UnifiedArchive\Exceptions\ArchiveModificationException;
use wapmorgan\UnifiedArchive\Exceptions\NonExistentArchiveFileException;
use wapmorgan\UnifiedArchive\Exceptions\UnsupportedOperationException;

abstract class BasicDriver
{
    const TYPE_EXTENSION = 1;
    const TYPE_UTILITIES = 2;
    const TYPE_PURE_PHP = 3;

    static $typeLabels = [
        BasicDriver::TYPE_EXTENSION => 'php extension',
        BasicDriver::TYPE_UTILITIES => 'utilities + php bridge',
        BasicDriver::TYPE_PURE_PHP => 'pure php',
    ];

    const COMPRESSION_NONE = 0;
    const COMPRESSION_WEAK = 1;
    const COMPRESSION_AVERAGE = 2;
    const COMPRESSION_STRONG = 3;
    const COMPRESSION_MAXIMUM = 4;

    const OPEN = 1;
    const OPEN_ENCRYPTED = 2;
    const OPEN_VOLUMED = 4;

    const GET_COMMENT = 64;
    const EXTRACT_CONTENT = 128;
    const STREAM_CONTENT = 256;

    const APPEND = 4096;
    const DELETE = 8192;
    const SET_COMMENT = 16384;

    const CREATE = 1048576;
    const CREATE_ENCRYPTED = 2097152;

    const TYPE = null;

    /**
     * @var string
     */
    protected $fileName;

    /**
     * @var string
     */
    protected $format;

    /**
     * @return string
     */
    abstract public static function getDescription();

    /**
     * @return bool
     */
    abstract public static function isInstalled();

    /**
     * @return string
     */
    abstract public static function getInstallationInstruction();

    /**
     * @return string[]
     */
    abstract public static function getSupportedFormats();

    /**
     * @param string $format
     * @return int[]
     */
    abstract public static function checkFormatSupport($format);

    /**
     * @param $ability
     * @return bool
     */
    public function checkAbility($ability)
    {
        return in_array($ability, static::checkFormatSupport($this->format), true);
    }

    /**
     * @param array $files
     * @param string $archiveFileName
     * @param string $archiveFormat
     * @param int $compressionLevel
     * @param null $password

     * @param $fileProgressCallable
     * @return int Number of archived files
     * @throws UnsupportedOperationException
     */
    public static function createArchive(
        array $files,
        /** @scrutinizer ignore-unused */ array $files,
        $archiveFileName,
        $archiveFormat,
        /** @scrutinizer ignore-unused */ $archiveFormat,
        $compressionLevel = self::COMPRESSION_AVERAGE,
        /** @scrutinizer ignore-unused */ $compressionLevel = self::COMPRESSION_AVERAGE,
        $password = null,
        /** @scrutinizer ignore-unused */ $password = null,
        $fileProgressCallable = null
        /** @scrutinizer ignore-unused */ $fileProgressCallable = null
    ) {
        throw new UnsupportedOperationException();
    }

    /**
     * BasicDriver constructor.
     * @param string $format
     * @param string $archiveFileName
     * @param string|null $password Archive password for opening
     */
    public function __construct($archiveFileName, $format, $password = null)
    public function __construct($archiveFileName, $format, /** @scrutinizer ignore-unused */ $password = null)
    {
        $this->fileName = $archiveFileName;
        $this->format = $format;
    }

    /**
     * Returns summary about an archive.
     * Called after
     * - constructing
     * - addFiles()
     * - deleteFiles()
     * @return ArchiveInformation
     */
    abstract public function getArchiveInformation();

    /**
     * @return array
     */
    abstract public function getFileNames();

    /**
     * @param string $fileName
     * @return bool
     */
    abstract public function isFileExists($fileName);

    /**
     * @param string $fileName
     * @return ArchiveEntry|false
     */
    abstract public function getFileData($fileName);

    /**
     * @param string $fileName
     * @return string|false
     * @throws NonExistentArchiveFileException
     */
    abstract public function getFileContent($fileName);

    /**
     * @param string $fileName
     * @return resource
     */
    abstract public function getFileStream($fileName);

    /**
     * @param $string
     * @return resource
     */
    public static function wrapStringInStream($string)
    {
        $resource = fopen('php://temp', 'r+');
        fwrite($resource, $string);
        rewind($resource);
        return $resource;
    }

    /**
     * @param string $outputFolder
     * @param array  $files
     * @return int Number of extracted files
     * @throws ArchiveExtractionException
     */
    abstract public function extractFiles($outputFolder, array $files);

    /**
     * @param string $outputFolder
     * @return int Number of extracted files
     * @throws ArchiveExtractionException
     */
    abstract public function extractArchive($outputFolder);

    /**
     * @param array $files
     * @return false|int Number of deleted files
     * @throws UnsupportedOperationException
     * @throws ArchiveModificationException
     */
    public function deleteFiles(array $files)
    public function deleteFiles(/** @scrutinizer ignore-unused */ array $files)
    {
        throw new UnsupportedOperationException();
    }

    /**
     * @param array $files
     * @return int Number of added files
     * @throws UnsupportedOperationException
     * @throws ArchiveModificationException
     */
    public function addFiles(array $files)
    public function addFiles(/** @scrutinizer ignore-unused */ array $files)
    {
        throw new UnsupportedOperationException();
    }

    /**
     * @param string $inArchiveName
     * @param string $content
     * @return bool
     * @throws UnsupportedOperationException
     * @throws ArchiveModificationException
     */
    public function addFileFromString($inArchiveName, $content)
    public function addFileFromString($inArchiveName, /** @scrutinizer ignore-unused */ $content)
    {
        throw new UnsupportedOperationException();
    }

    /**
     * @return string|null
     * @throws UnsupportedOperationException
     */
    public function getComment()
    {
        throw new UnsupportedOperationException();
    }

    /**
     * @param string|null $comment
     * @return null
     * @throws UnsupportedOperationException
     */
    public function setComment($comment)
    public function setComment(/** @scrutinizer ignore-unused */ $comment)
    {
        throw new UnsupportedOperationException();
    }
}
wapmorgan / UnifiedArchive

Push — master ( 125b29...554a92 )

BasicDriver::addFileFromString() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like
