jeroen/file-fetcher-stopwatch

Provides a Symfony Stopwatch decorator for file fetchers

1.0.3 2023-04-18 20:56 UTC

Requires

• php: >=8.1
• jeroen/file-fetcher: ~6.0|~5.0
• symfony/stopwatch: ~6.0|~5.0

Requires (Dev)

• mediawiki/mediawiki-codesniffer: ~41.0
• phpstan/phpstan: ~1.10
• phpunit/phpunit: ^10.1.1
• slevomat/coding-standard: ~8.10
• squizlabs/php_codesniffer: ~3.7

GPL-2.0-or-later

• symfony
• profiling
• profile
• file fetcher
• stopwatch
• file_get_contents
• filefetcher

README

Provides a FileFetcher decorator that profiles file fetching using Symfony Stopwatch.

Usage

The FileFetcher decorators is constructed via FileFetcher\Stopwatch\Factory.

$fileFetcher = (new Factory())->newStopwatchFetcher($innerFetcher, $stopwatch);

Once you constructed a FileFetcher, fetching a file is easy:

$fileContent = $fileFetcher->fetchFile($fileLocation);

To test your code you can use all the test doubles provided by FileFetcher itself.

Installation

To use the FileFetcher Stopwatch library in your project, simply add a dependency on jeroen/file-fetcher-stopwatch to your project's composer.json file. Here is a minimal example of a composer.json file that just defines a dependency on FileFetcher Stopwatch 1.x:

{
    "require": {
        "jeroen/file-fetcher-stopwatch": "~1.0"
    }
}

Development

Start by installing the project dependencies by executing

composer update

You can run the tests by executing

make test

You can run the style checks by executing

make cs

To run all CI checks, execute

make ci

You can also invoke PHPUnit directly to pass it arguments, as follows

vendor/bin/phpunit --filter SomeClassNameOrFilter

Release notes

1.0.3 (2023-04-18)

• Installation together with Symfony Stopwatch 6.x is now allowed
• Updated minimum PHP version to 8.1

1.0.2 (2019-12-23)

• Installation together with Symfony Stopwatch 5.x is now allowed

1.0.1 (2019-01-17)

• Fixed compatibility issue with FileFetcher 6.x

1.0.0 (2019-01-17)

• Initial release with Factory->newStopwatchFetcher()