Download the PHP package hiqdev/hoa-iterator without Composer

Reasons to fork

The Hoa project was archived, and no upgrades or patches are neither provided nor accepted by merge requests.

HOA Packages include some code that is Deprecated for PHP 8.0 and PHP 8.1, but we needed these packages to run on modern PHP versions.

What's changed in from?

The changes mainly affected the return data type hinting in methods declaration, access to uninitialized properties.

How to use

We've currently forked the following packages, primarily to make hoa/ruler work with PHP 8.1:

You can simply replace requirements in composer.json from hoa packages to the corresponding forked packages: there is no need to change something in the codebase.

If you use someone's package, that requires hoa – simply add forks to your project root composer.json: we have marked forks as a replacement, so composer will install them instead of the original packages.

Versions

We've forked from the latest hoa package versions and bump own versions starting from 1.0.

Testing

Before running the test suites, the development dependencies must be installed:

Then, to run all the test suites:

For more information, please read the contributor guide.

Quick usage

We propose a quick overview of all iterators.

The One

Hoa\Iterator\Iterator defines the basis of an iterator. It extends Iterator.

External iterator

Hoa\Iterator\Aggregate allows a class to use an external iterator through the getIterator method. It extends IteratorAggregate

Traversable to iterator

Hoa\Iterator\IteratorIterator transforms anything that is traversable into an iterator. It extends IteratorIterator.

Iterator of iterators

Hoa\Iterator\Outer represents an iterator that iterates over iterators. It extends OuterIterator.

Mock

Hoa\Iterator\Mock represents an empty iterator. It extends EmptyIterator.

Seekable

Hoa\Iterator\Seekable represents an iterator that can be seeked. It extends SeekableIterator.

Map

Hoa\Iterator\Map allows to iterate an array. It extends ArrayIterator.

Filters

Hoa\Iterator\Filter and Hoa\Iterator\CallbackFilter allows to filter the content of an iterator. It extends FilterIterator and CallbackFilterIterator.

Also, Hoa\Iterator\RegularExpression allows to filter based on a regular expression.

Limit

Hoa\Iterator\Limit allows to iterate n elements of an iterator starting from a specific offset. It extends LimitIterator.

Infinity

Hoa\Iterator\Infinite allows to iterate over and over again the same iterator. It extends InfiniteIterator.

Also, Hoa\Iterator\NoRewind is an iterator that does not rewind. It extends NoRewindIterator.

Repeater

Hoa\Iterator\Repeater allows to repeat an iterator n times.

Counter

Hoa\Iterator\Counter is equivalent to a for($i = $from, $i < $to, $i += $step) loop.

Union of iterators

Hoa\Iterator\Append allows to iterate over iterators one after another. It extends AppendIterator.

Multiple

Hoa\Iterator\Multiple allows to iterate over several iterator at the same times. It extends MultipleIterator.

Demultiplexer

Hoa\Iterator\Demultiplexer demuxes result from another iterator. This iterator is somehow the opposite of the Hoa\Iterator\Multiple iterator.

File system

Hoa\Iterator\Directory and Hoa\Iterator\FileSystem allow to iterate the file system where files are represented by instances of Hoa\Iterator\SplFileInfo. They respectively extend DirectoryIterator, FilesystemIterator and SplFileInfo.

Also, the Hoa\Iterator\Glob allows to iterator with the glob strategy. It extends GlobIterator. Thus:

Look ahead

Hoa\Iterator\Lookahead allows to look ahead for the next element:

The Hoa\Iterator\Lookbehind also exists and allows to look behind for the previous element.

Buffer

Hoa\Iterator\Buffer allows to move forward as usual but also backward up to a given buffer size over another iterator:

Callback generator

Hoa\Iterator\CallbackGenerator allows to transform any callable into an iterator. This is very useful when combined with other iterators, for instance with Hoa\Iterator\Limit:

Recursive iterators

A recursive iterator is an iterator where its values is other iterators. The most important interface is Hoa\Iterator\Recursive\Recursive (it extends RecursiveIterator). Then we find (in alphabetic order):

• Hoa\Iterator\Recursive\CallbackFilter (it extends RecursiveCallbackFilterIterator),
• Hoa\Iterator\Recursive\Directory (it extends RecursiveDirectoryIterator),
• Hoa\Iterator\Recursive\Filter (it extends RecursiveFilterIterator),
• Hoa\Iterator\Recursive\Iterator (it extends RecursiveIteratorIterator),
• Hoa\Iterator\Recursive\Map (it extends RecursiveArrayIterator),
• Hoa\Iterator\Recursive\Mock,
• Hoa\Iterator\Recursive\RegularExpression (it extends RecursiveRegularExpression).

Documentation

The hack book of Hoa\Iterator contains detailed information about how to use this library and how it works.

To generate the documentation locally, execute the following commands:

More documentation can be found on the project's website: hoa-project.net.

Getting help

There are mainly two ways to get help:

• On the #hoaproject IRC channel,
• On the forum at users.hoa-project.net.

Contribution

Do you want to contribute? Thanks! A detailed contributor guide explains everything you need to know.

License

Hoa is under the New BSD License (BSD-3-Clause). Please, see LICENSE for details.