CSVelte\CSVelte

Complexity

Total Complexity

8

Size/Duplication

Total Lines	111
Duplicated Lines	0 %

Coupling/Cohesion

Components	0
Dependencies	4

Test Coverage

Coverage

100%

Importance

Changes	1
Bugs	0	Features	1

6 Methods

Rating	Name	Duplication	Size	Complexity
A	reader()	0	6	1
A	assertFileExists()	0	6	2
A	stringReader()	0	4	1
A	writer()	0	5	1
A	export()	0	6	1
A	assertFileIsReadable()	0	7	2

<?php
/**
 * CSVelte: Slender, elegant CSV for PHP
 *
 * Inspired by Python's CSV module and Frictionless Data and the W3C's CSV
 * standardization efforts, CSVelte was written in an effort to take all the
 * suck out of working with CSV.
 *
 * @version   v0.2
 * @copyright Copyright (c) 2016 Luke Visinoni <luke.visinoni@gmail.com>
 * @author    Luke Visinoni <luke.visinoni@gmail.com>
 * @license   https://github.com/deni-zen/csvelte/blob/master/LICENSE The MIT License (MIT)
 */
namespace CSVelte;

use CSVelte\Reader;
use CSVelte\Flavor;
use CSVelte\IO\Stream;

use CSVelte\Exception\IOException;

/**
 * CSVelte Facade
 *
 * This class consists of static factory methods for easily generating commonly
 * used objects such as readers and writers, as well as convenience methods for
 * commonly used functionality such as exporting CSV data to a file.
 *
 * @package CSVelte
 * @subpackage Factory/Adapter
 * @since v0.1
 */
class CSVelte
{
    /**
     * CSVelte\Reader Factory
     *
     * Factory method for creating a new CSVelte\Reader object
     * Used to create a local file CSV reader object.
     *
     * @param string The filename to read
     * @param CSVelte\Flavor|array|null An explicit flavor object that will be
     *     passed to the reader or an array of flavor attributes to override the
     *     default flavor attributes
     * @return CSVelte\Reader An iterator for specified CSV file
     * @throws CSVelte\Exception\PermissionDeniedException
     * @throws CSVelte\Exception\FileNotFoundException
     */
    public static function reader($filename, $flavor = null)
    {
        self::assertFileIsReadable($filename);
        $file = new Stream($filename);
        return new Reader($file, $flavor);
    }

    /**
     * String Reader Factory
     *
     * Factory method for creating a new CSVelte\Reader object for reading
     * from a PHP string
     *
     * @param string The CSV data to read
     * @param CSVelte\Flavor|array|null An explicit flavor object that will be
     *     passed to the reader or an array of flavor attributes to override the
     *     default flavor attributes
     * @return CSVelte\Reader An iterator for provided CSV data
     */
    public static function stringReader($str, $flavor = null)
    {
        return new Reader($str, $flavor);
    }

    /**
     * CSVelte\Writer Factory
     *
     * Factory method for creating a new CSVelte\Writer object for writing
     * CSV data to a file. If file doesn't exist, it will be created. If it
     * already contains data, it will be overwritten.
     *
     * @param string The filename to write to.
     * @param CSVelte\Flavor|array|null An explicit flavor object that will be
     *     passed to the reader or an array of flavor attributes to override the
     *     default flavor attributes
     * @return CSVelte\Writer A writer object for writing to given filename
     */
    public static function writer($filename, $flavor = null)
    {
        $file = new Stream($filename, 'w+');
        return new Writer($file, $flavor);
    }

    /**
     * Export CSV data to local file
     *
     * Facade method for exporting data to given filename. IF file doesn't exist
     * it will be created. If it does exist it will be overwritten.
     *
     * @param string The filename to export data to
     * @param Iterator|array Data to write to CSV file
     * @param CSVelte\Flavor|array|null An explicit flavor object that will be
     *     passed to the reader or an array of flavor attributes to override the
     *     default flavor attributes
     * @return int Number of rows written
     */
    public static function export($filename, $data, $flavor = null)
    {
        $file = new Stream($filename, 'w+');
        $writer = new Writer($file, $flavor);
        return $writer->writeRows($data);
    }

    /**
     * Assert that file is readable
     *
     * Assert that a particular file exists and is readable (user has permission
     * to read/access it)
     *
     * @param string The name of the file you wish to check
     * @throws CSVelte\Exception\IOException
     * @internal
     */
    protected static function assertFileIsReadable($filename)
    {
        self::assertFileExists($filename);
        if (!is_readable($filename)) {
            throw new IOException('Permission denied for: ' . $filename, IOException::ERR_FILE_PERMISSION_DENIED);
        }
    }

    /**
     * Assert that a particular file exists
     *
     * @param string The name of the file you wish to check
     * @throws CSVelte\Exception\IOException
     * @internal
     */
    protected static function assertFileExists($filename)
    {
        if (!file_exists($filename)) {
            throw new IOException('File does not exist: ' . $filename, IOException::ERR_FILE_NOT_FOUND);
        }
    }
}