EmptyEscapeParser::parse() - Code Metrics - Inspection of "boo" - thephpleague/csv - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( 082053...210c5f )

by ignace nyamagana

created 2018-09-30 18:53 UTC

EmptyEscapeParser::parse() A

↳ Parent: EmptyEscapeParser

Complexity

Conditions	3
Paths	3

Size

Total Lines

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	11
CRAP Score	3

Importance

Changes

Metric	Value
cc	3
nc	3
nop	1
dl	0
loc	14
ccs	11
cts	11
cp	1
crap	3
rs	9.7998
c	0
b	0
f	0

<?php

/**
 * League.Csv (https://csv.thephpleague.com).
 *
 * @author  Ignace Nyamagana Butera <[email protected]>
 * @license https://github.com/thephpleague/csv/blob/master/LICENSE (MIT License)
 * @version 9.2.0
 * @link    https://github.com/thephpleague/csv
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

declare(strict_types=1);

namespace League\Csv\Polyfill;

use Generator;
use League\Csv\Stream;
use SplFileObject;
use TypeError;
use function explode;
use function get_class;
use function gettype;
use function in_array;
use function is_object;
use function ltrim;
use function rtrim;
use function sprintf;
use function str_replace;
use function substr;

/**
 * A Polyfill to PHP's SplFileObject to enable parsing the CSV document
 * without taking into account the escape character.
 *
 * @see https://php.net/manual/en/function.fgetcsv.php
 * @see https://php.net/manual/en/function.fgets.php
 * @see https://tools.ietf.org/html/rfc4180
 * @see http://edoceo.com/utilitas/csv-file-format
 *
 * @internal used internally to parse a CSV document without using the escape character
 */
final class EmptyEscapeParser
{
    /**
     * @internal
     */
    const FIELD_BREAKS = [false, '', "\r\n", "\n", "\r"];

    /**
     * @var SplFileObject|Stream
     */
    private static $document;

    /**
     * @var string
     */
    private static $delimiter;

    /**
     * @var string
     */
    private static $enclosure;

    /**
     * @var string
     */
    private static $trim_mask;

    /**
     * @var string|bool
     */
    private static $line;

    /**
     * Converts the document into a CSV record iterator.
     *
     * In PH7.4+ you'll be able to do
     *
     * <code>
     * $file = new SplFileObject('/path/to/file.csv', 'r');
     * $file->setFlags(SplFileObject::READ_CSV | SplFileObject::READ_AHEAD | SplFileObject::SKIP_EMPTY);
     * $file->setCsvControl($delimiter, $enclosure, '');
     * foreach ($file as $record) {
     *    //$record escape mechanism is blocked by the empty string
     * }
     * </code>
     *
     * In PHP7.3- you can do
     *
     * <code>
     * $file = new SplFileObject('/path/to/file.csv', 'r');
     * $it = EmptyEscapeParser::parse($file); //parsing will be done while ignoring the escape character value.
     * foreach ($it as $record) {
     *    //fgetcsv is not directly use hence the escape char is not taken into account
     * }
     * </code>
     *
     * Each record array contains strings elements.
     *
     * @param SplFileObject|Stream $document
     *
     * @return Generator|array[]
     */
    public static function parse($document): Generator
    {
        self::$document = self::filterDocument($document);
        list(self::$delimiter, self::$enclosure, ) = self::$document->getCsvControl();
        self::$trim_mask = str_replace([self::$delimiter, self::$enclosure], '', " \t\0\x0B");
        self::$document->setFlags(0);
        self::$document->rewind();
        while (self::$document->valid()) {
            $record = self::extractRecord();
            if (!in_array(null, $record, true)) {
                yield $record;
            }
        }
    }

    /**
     * Filters the submitted document.
     *
     * @param SplFileObject|Stream $document
     *
     * @return SplFileObject|Stream
     */
    private static function filterDocument($document)
    {
        if ($document instanceof Stream || $document instanceof SplFileObject) {
            return $document;
        }

        throw new TypeError(sprintf(
            '%s::parse expects parameter 1 to be a %s or a SplFileObject object, %s given',
            static::class,
            Stream::class,
            is_object($document) ? get_class($document) : gettype($document)
        ));
    }

    /**
     * Extracts a record form the CSV document.
     */
    private static function extractRecord(): array
    {
        $record = [];
        self::$line = self::$document->fgets();
        do {
            $method = 'extractFieldContent';
            $buffer = ltrim(self::$line, self::$trim_mask);
            if (($buffer[0] ?? '') === self::$enclosure) {
                $method = 'extractEnclosedFieldContent';
                self::$line = $buffer;
            }

            $record[] = self::$method();
        } while (false !== self::$line);

        return $record;
    }

    /**
     * Extracts the content from a field without enclosure.
     *
     * - Field content can not spread on multiple document lines.
     * - Content must be preserved.
     * - Trailing line-breaks must be removed.
     *
     * @return string|null
     */
    private static function extractFieldContent()
    {
        if (in_array(self::$line, self::FIELD_BREAKS, true)) {
            self::$line = false;

            return null;
        }

        list($content, self::$line) = explode(self::$delimiter, self::$line, 2) + [1 => false];
        if (false === self::$line) {
            return rtrim($content, "\r\n");
        }

        return $content;
    }

    /**
     * Extracts the content from a field with enclosure.
     *
     * - Field content can spread on multiple document lines.
     * - Content between consecutive enclosure characters must be preserved.
     * - Double enclosure sequence must be replaced by single enclosure character.
     * - Trailing line break must be removed if they are not part of the field content.
     * - Invalid field content is treated as per fgetcsv behavior.
     *
     * @return string|null
     */
    private static function extractEnclosedFieldContent()
    {
        if ((self::$line[0] ?? '') === self::$enclosure) {
            self::$line = substr(self::$line, 1);
        }

        $content = '';
        while (false !== self::$line) {
            list($buffer, $remainder) = explode(self::$enclosure, self::$line, 2) + [1 => false];
            $content .= $buffer;

            if (false !== $remainder) {
                self::$line = $remainder;
                break;
            }

            if (!self::$document->valid() && $content === $buffer) {
                if ($content !== rtrim($content, "\r\n")) {
                    self::$line = false;

                    return rtrim($content, "\r\n");
                }

                return null;
            }

            self::$line = self::$document->fgets();
        }

        if (in_array(self::$line, self::FIELD_BREAKS, true)) {
            self::$line = false;

            return rtrim($content, "\r\n");
        }

        $char = self::$line[0] ?? '';
        if (self::$delimiter === $char) {
            self::$line = substr(self::$line, 1);

            return $content;
        }

        if (self::$enclosure === $char) {
            return $content.self::$enclosure.self::extractEnclosedFieldContent();
        }

        return $content.self::extractFieldContent();
    }
}


1		<?php
2
3		/**
4		* League.Csv (https://csv.thephpleague.com).
5		*
6		* @author Ignace Nyamagana Butera <[email protected]>
7		* @license https://github.com/thephpleague/csv/blob/master/LICENSE (MIT License)
8		* @version 9.2.0
9		* @link https://github.com/thephpleague/csv
10		*
11		* For the full copyright and license information, please view the LICENSE
12		* file that was distributed with this source code.
13		*/
14
15		declare(strict_types=1);
16
17		namespace League\Csv\Polyfill;
18
19		use Generator;
20		use League\Csv\Stream;
21		use SplFileObject;
22		use TypeError;
23		use function explode;
24		use function get_class;
25		use function gettype;
26		use function in_array;
27		use function is_object;
28		use function ltrim;
29		use function rtrim;
30		use function sprintf;
31		use function str_replace;
32		use function substr;
33
34		/**
35		* A Polyfill to PHP's SplFileObject to enable parsing the CSV document
36		* without taking into account the escape character.
37		*
38		* @see https://php.net/manual/en/function.fgetcsv.php
39		* @see https://php.net/manual/en/function.fgets.php
40		* @see https://tools.ietf.org/html/rfc4180
41		* @see http://edoceo.com/utilitas/csv-file-format
42		*
43		* @internal used internally to parse a CSV document without using the escape character
44		*/
45		final class EmptyEscapeParser
46		{
47		/**
48		* @internal
49		*/
50		const FIELD_BREAKS = [false, '', "\r\n", "\n", "\r"];
51
52		/**
53		* @var SplFileObject\|Stream
54		*/
55		private static $document;
56
57		/**
58		* @var string
59		*/
60		private static $delimiter;
61
62		/**
63		* @var string
64		*/
65		private static $enclosure;
66
67		/**
68		* @var string
69		*/
70		private static $trim_mask;
71
72		/**
73		* @var string\|bool
74		*/
75		private static $line;
76
77		/**
78		* Converts the document into a CSV record iterator.
79		*
80		* In PH7.4+ you'll be able to do
81		*
82		* <code>
83		* $file = new SplFileObject('/path/to/file.csv', 'r');
84		* $file->setFlags(SplFileObject::READ_CSV \| SplFileObject::READ_AHEAD \| SplFileObject::SKIP_EMPTY);
85		* $file->setCsvControl($delimiter, $enclosure, '');
86		* foreach ($file as $record) {
87		* //$record escape mechanism is blocked by the empty string
88		* }
89		* </code>
90		*
91		* In PHP7.3- you can do
92		*
93		* <code>
94		* $file = new SplFileObject('/path/to/file.csv', 'r');
95		* $it = EmptyEscapeParser::parse($file); //parsing will be done while ignoring the escape character value.
96		* foreach ($it as $record) {
97		* //fgetcsv is not directly use hence the escape char is not taken into account
98		* }
99		* </code>
100		*
101		* Each record array contains strings elements.
102		*
103		* @param SplFileObject\|Stream $document
104		*
105		* @return Generator\|array[]
106		*/
107	42	public static function parse($document): Generator
108		{
109	42	self::$document = self::filterDocument($document);
110	39	list(self::$delimiter, self::$enclosure, ) = self::$document->getCsvControl();
111	39	self::$trim_mask = str_replace([self::$delimiter, self::$enclosure], '', " \t\0\x0B");
112	39	self::$document->setFlags(0);
113	39	self::$document->rewind();
114	39	while (self::$document->valid()) {
115	39	$record = self::extractRecord();
116	39	if (!in_array(null, $record, true)) {
117	36	yield $record;
118		}
119		}
120	39	}
121
122		/**
123		* Filters the submitted document.
124		*
125		* @param SplFileObject\|Stream $document
126		*
127		* @return SplFileObject\|Stream
128		*/
129	6	private static function filterDocument($document)
130		{
131	6	if ($document instanceof Stream \|\| $document instanceof SplFileObject) {
132	3	return $document;
133		}
134
135	3	throw new TypeError(sprintf(
136	3	'%s::parse expects parameter 1 to be a %s or a SplFileObject object, %s given',
137	3	static::class,
138	3	Stream::class,
139	3	is_object($document) ? get_class($document) : gettype($document)
140		));
141		}
142
143		/**
144		* Extracts a record form the CSV document.
145		*/
146	39	private static function extractRecord(): array
147		{
148	39	$record = [];
149	39	self::$line = self::$document->fgets();
150		do {
151	39	$method = 'extractFieldContent';
152	39	$buffer = ltrim(self::$line, self::$trim_mask);
153	39	if (($buffer[0] ?? '') === self::$enclosure) {
154	30	$method = 'extractEnclosedFieldContent';
155	30	self::$line = $buffer;
156		}
157
158	39	$record[] = self::$method();
159	39	} while (false !== self::$line);
160
161	39	return $record;
162		}
163
164		/**
165		* Extracts the content from a field without enclosure.
166		*
167		* - Field content can not spread on multiple document lines.
168		* - Content must be preserved.
169		* - Trailing line-breaks must be removed.
170		*
171		* @return string\|null
172		*/
173	39	private static function extractFieldContent()
174		{
175	39	if (in_array(self::$line, self::FIELD_BREAKS, true)) {
176	3	self::$line = false;
177
178	3	return null;
179		}
180
181	36	list($content, self::$line) = explode(self::$delimiter, self::$line, 2) + [1 => false];
182	36	if (false === self::$line) {
183	27	return rtrim($content, "\r\n");
184		}
185
186	36	return $content;
187		}
188
189		/**
190		* Extracts the content from a field with enclosure.
191		*
192		* - Field content can spread on multiple document lines.
193		* - Content between consecutive enclosure characters must be preserved.
194		* - Double enclosure sequence must be replaced by single enclosure character.
195		* - Trailing line break must be removed if they are not part of the field content.
196		* - Invalid field content is treated as per fgetcsv behavior.
197		*
198		* @return string\|null
199		*/
200	30	private static function extractEnclosedFieldContent()
201		{
202	30	if ((self::$line[0] ?? '') === self::$enclosure) {
203	30	self::$line = substr(self::$line, 1);
204		}
205
206	30	$content = '';
207	30	while (false !== self::$line) {
208	30	list($buffer, $remainder) = explode(self::$enclosure, self::$line, 2) + [1 => false];
209	30	$content .= $buffer;
210
211	30	if (false !== $remainder) {
212	21	self::$line = $remainder;
213	21	break;
214		}
215
216	15	if (!self::$document->valid() && $content === $buffer) {
217	4	if ($content !== rtrim($content, "\r\n")) {
218	1	self::$line = false;
219
220	1	return rtrim($content, "\r\n");
221		}
222
223	3	return null;
224		}
225
226	11	self::$line = self::$document->fgets();
227		}
228
229	26	if (in_array(self::$line, self::FIELD_BREAKS, true)) {
230	14	self::$line = false;
231
232	14	return rtrim($content, "\r\n");
233		}
234
235	21	$char = self::$line[0] ?? '';
236	21	if (self::$delimiter === $char) {
237	15	self::$line = substr(self::$line, 1);
238
239	15	return $content;
240		}
241
242	18	if (self::$enclosure === $char) {
243	9	return $content.self::$enclosure.self::extractEnclosedFieldContent();
244		}
245
246	9	return $content.self::extractFieldContent();
247		}
248		}
249

thephpleague / csv

Push — master ( 082053...210c5f )

EmptyEscapeParser::parse() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like