suramon/itertools

Iterators implemented in PHP, copy-pasted from Python

Thursday, April 12, 2018
by SuRaMoN
Repository
4 Watchers
13 Stars
7,884 Installations

PHP
0 Dependents
0 Suggesters
4 Forks
0 Open issues
55 Versions
5 % Grown

The README.md

itertools

A set of iterators for PHP based on pythons itertools., _(*1)

, _(*2)

Some iterator examples

// iterate the lines of a csv file
$lines = new FileLineIterator('file.csv');

// filter all non unique lines
$uniqueLines = new UniqueIterator($lines);

// convert unique csv string lines to array
$rows = new StringCsvIterator($uniqueLines);

// extract column 1 from the csv file
$column1 = new MapIterator($rows, function($row) { return $row['column1']; });

// output all rows in parallel
foreach(new ForkingIterator($column1) as $row) {
    echo $row;
}

Install Guide

composer require suramon/itertools

Manual Install

Download itertools directly from GitHub, or clone it with Git: git clone https://github.com/SuRaMoN/relike.git
Include the autoload header located in src/autload.php (eg: require 'relike/src/autoload.php';) or you can use psr-0
Learn and use itertools by looking at the examples, tests and source code

Some iterators explained

ChainIterator

Iterator equivalent of flattening a 2-dimensional array., _(*3)

$iterators = new ArrayIterator(array(new RangeIterator(1, 5), new RangeIterator(6, 10)));
$fattenedIterators = new ChainIterator($iterators); // will contain all numbers from 1 to 10

ChunkingIterator

Splits a iterator into smaller chunks. this can be used for batch processing., _(*4)

$iterator = new RangeIterator();
$batchsize = 100;
foreach(new ChunkingIterator($iterator, $batchsize) as $chunk) {
    $pdo->starttransaction();
    foreach($chunk as $element) {
        // process the iterator elements. using the transaction inside the chunkiterator makes sure the transaction stays small
    }
    $pdo->commit();
}

ForkingIterator

This linux-only iterator is designed to be iterated by a foreach loop and forks a new process for each iteration., _(*5)

$elements = new RangeIterator(0, 10);
foreach(new ForkingIterator($elements) as $i) {
    var_dump($i, getmypid()); // wil spawn a new process to iterate each element
}

HistoryIterator

An iterator that keeps track of the elements it iterates. It differs from the CachingIterator in the standard PHP library because this implementations allows the history size to be specified., _(*6)

$range = new HistoryIterator(new ArrayIterator(range(1, 10)));
foreach($range as $i) {
    if($range->hasPrev()) {
        echo $i, $range->prev(), "\n";
    }
}

MapIterator

Iterator equivalent or array_map., _(*7)

$positiveNumbers = new RangeIterator(0, INF); // all numbers from 0 to infinity
$positiveSquareNumbers = new MapIterator($positiveNumbers, function($n) {return $n*$n;}); // all positive square numbers

SliceIterator

Iterator equivalent of array_slice., _(*8)

$lines = new SliceIterator(new FileLineIterator('file.txt'), 0, 1000); // will iterate the first 1000 lines of the file

UniqueIterator

Iterator equivalent of array_unique but only works for sorted input., _(*9)

$uniqueEntries = new UniqueIterator(new ArrayIterator(array(1, 2, 2, 2, 3, 4, 2))); // will contain 1, 2, 3, 4, 2

RangeIterator

Iterator equivalent of range., _(*10)

$lines = new SliceIterator(new FileLineIterator('file.txt'), 0, 1000); // will iterate the first 1000 lines of the file

ZipIterator

Inspired by pythons zip function. It can be constructed with an array of iterators and it iterates all of its arguments at the same index, returning during each iteration an array of the elements of each iterator on the same iteration positon, _(*11)

$csv1 = new FileCsvIterator('file1.csv');
$csv2 = new FileCsvIterator('file2.csv');
foreach(new ZipIterator(array($csv1, $csv2)) as $combinedRows) {
    $row1 = $combinedRows[0]; // a row in file1.csv
    $row2 = $combinedRows[1]; // row in file2.csv on same position
}

The Versions

12/04 2018

dev-master

9999999-dev https://github.com/SuRaMoN/itertools

Iterators implemented in PHP, copy-pasted from Python

library itertools

Iterators implemented in PHP, copy-pasted from Python

suramon/itertools

The README.md

itertools

Some iterator examples

Install Guide

Manual Install

Some iterators explained

ChainIterator

ChunkingIterator

ForkingIterator

HistoryIterator

MapIterator

SliceIterator

UniqueIterator

RangeIterator

ZipIterator

The Versions

dev-master

The Requires

The Development Requires

by SuRaMoN

1.6.4

The Requires

The Development Requires

by SuRaMoN

1.6.3

The Requires

The Development Requires

by SuRaMoN

1.6.2

The Requires

The Development Requires

by SuRaMoN

1.6.1

The Requires

by SuRaMoN

1.5.39

The Requires

by SuRaMoN

1.5.38

The Requires

by SuRaMoN

dev-fixing-a-very-confusing-error-message

The Requires

by SuRaMoN

1.5.37

The Requires

by SuRaMoN

1.5.36

The Requires

by SuRaMoN

1.5.35

The Requires

by SuRaMoN

1.5.34

The Requires

by SuRaMoN

1.5.33

The Requires

by SuRaMoN

1.5.32

The Requires

by SuRaMoN

1.5.31

The Requires

by SuRaMoN

1.5.30

The Requires

by SuRaMoN

1.5.29

The Requires

by SuRaMoN

1.5.28

The Requires

by SuRaMoN

1.5.27

The Requires

by SuRaMoN