pax_global_header 0000666 0000000 0000000 00000000064 13767723214 0014526 g ustar 00root root 0000000 0000000 52 comment=dd5c94ed44075dbd6c8bcaa7d1463731c9656f0e
php-timer-5.0.3/ 0000775 0000000 0000000 00000000000 13767723214 0013440 5 ustar 00root root 0000000 0000000 php-timer-5.0.3/.github/ 0000775 0000000 0000000 00000000000 13767723214 0015000 5 ustar 00root root 0000000 0000000 php-timer-5.0.3/.github/FUNDING.yml 0000664 0000000 0000000 00000000032 13767723214 0016610 0 ustar 00root root 0000000 0000000 github: sebastianbergmann
php-timer-5.0.3/.github/workflows/ 0000775 0000000 0000000 00000000000 13767723214 0017035 5 ustar 00root root 0000000 0000000 php-timer-5.0.3/.github/workflows/ci.yml 0000664 0000000 0000000 00000005244 13767723214 0020160 0 ustar 00root root 0000000 0000000 # https://help.github.com/en/categories/automating-your-workflow-with-github-actions
on:
- "pull_request"
- "push"
name: "CI"
jobs:
coding-guidelines:
name: "Coding Guidelines"
runs-on: "ubuntu-latest"
steps:
- name: "Checkout"
uses: "actions/checkout@v2"
- name: "Run friendsofphp/php-cs-fixer"
run: "php7.4 ./tools/php-cs-fixer fix --diff-format=udiff --dry-run --show-progress=dots --using-cache=no --verbose"
type-checker:
name: "Type Checker"
runs-on: "ubuntu-latest"
steps:
- name: "Checkout"
uses: "actions/checkout@v2"
- name: "Update dependencies with composer"
run: "php7.4 ./tools/composer update --no-ansi --no-interaction --no-progress"
- name: "Run vimeo/psalm"
run: "php7.4 ./tools/psalm --config=.psalm/config.xml --no-progress --shepherd --show-info=false --stats"
backward-compatibility:
name: Backward Compatibility
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v2
with:
fetch-depth: 0
- name: Fetch tags
run: git fetch --depth=1 origin +refs/tags/*:refs/tags/*
- name: Install PHP with extensions
uses: shivammathur/setup-php@v2
with:
php-version: 7.4
coverage: none
extensions: intl
- name: Run roave/backward-compatibility-check
run: ./tools/roave-backward-compatibility-check --from=5.0.3
tests:
name: "Tests"
runs-on: "ubuntu-latest"
strategy:
fail-fast: false
matrix:
php-version:
- "7.3"
- "7.4"
- "8.0"
- "8.1"
steps:
- name: "Checkout"
uses: "actions/checkout@v2"
- name: "Install PHP with extensions"
uses: "shivammathur/setup-php@v2"
with:
php-version: "${{ matrix.php-version }}"
coverage: "pcov"
- name: "Cache dependencies installed with composer"
uses: "actions/cache@v1"
with:
path: "~/.composer/cache"
key: "php${{ matrix.php-version }}-composer-${{ matrix.dependencies }}-${{ hashFiles('**/composer.json') }}"
restore-keys: "php${{ matrix.php-version }}-composer-${{ matrix.dependencies }}-"
- name: "Install dependencies with composer"
run: "./tools/composer update --no-ansi --no-interaction --no-progress"
- name: "Run tests with phpunit/phpunit"
run: "vendor/bin/phpunit --coverage-clover=coverage.xml"
- name: "Send code coverage report to Codecov.io"
env:
CODECOV_TOKEN: "${{ secrets.CODECOV_TOKEN }}"
run: "bash <(curl -s https://codecov.io/bash) || true"
php-timer-5.0.3/.gitignore 0000664 0000000 0000000 00000000115 13767723214 0015425 0 ustar 00root root 0000000 0000000 /.idea
/.php_cs
/.php_cs.cache
/.phpunit.result.cache
/composer.lock
/vendor
php-timer-5.0.3/.phive/ 0000775 0000000 0000000 00000000000 13767723214 0014631 5 ustar 00root root 0000000 0000000 php-timer-5.0.3/.phive/phars.xml 0000664 0000000 0000000 00000000667 13767723214 0016501 0 ustar 00root root 0000000 0000000
php-timer-5.0.3/.php_cs.dist 0000664 0000000 0000000 00000017371 13767723214 0015670 0 ustar 00root root 0000000 0000000
For the full copyright and license information, please view the LICENSE
file that was distributed with this source code.
EOF;
$finder = PhpCsFixer\Finder::create()
->files()
->in(__DIR__ . '/src')
->in(__DIR__ . '/tests');
return PhpCsFixer\Config::create()
->setFinder($finder)
->setRiskyAllowed(true)
->setRules([
'align_multiline_comment' => true,
'array_indentation' => true,
'array_syntax' => ['syntax' => 'short'],
'binary_operator_spaces' => [
'operators' => [
'=' => 'align',
'=>' => 'align',
],
],
'blank_line_after_namespace' => true,
'blank_line_before_statement' => [
'statements' => [
'break',
'continue',
'declare',
'do',
'for',
'foreach',
'if',
'include',
'include_once',
'require',
'require_once',
'return',
'switch',
'throw',
'try',
'while',
'yield',
],
],
'braces' => true,
'cast_spaces' => true,
'class_attributes_separation' => ['elements' => ['const', 'method', 'property']],
'combine_consecutive_issets' => true,
'combine_consecutive_unsets' => true,
'compact_nullable_typehint' => true,
'concat_space' => ['spacing' => 'one'],
'declare_equal_normalize' => ['space' => 'none'],
'declare_strict_types' => true,
'dir_constant' => true,
'elseif' => true,
'encoding' => true,
'full_opening_tag' => true,
'function_declaration' => true,
'global_namespace_import' => [
'import_classes' => true,
'import_constants' => true,
'import_functions' => true,
],
'header_comment' => ['header' => $header, 'separate' => 'none'],
'indentation_type' => true,
'is_null' => true,
'line_ending' => true,
'list_syntax' => ['syntax' => 'short'],
'logical_operators' => true,
'lowercase_cast' => true,
'lowercase_constants' => true,
'lowercase_keywords' => true,
'lowercase_static_reference' => true,
'magic_constant_casing' => true,
'method_argument_space' => ['ensure_fully_multiline' => true],
'modernize_types_casting' => true,
'multiline_comment_opening_closing' => true,
'multiline_whitespace_before_semicolons' => true,
'native_constant_invocation' => false,
'native_function_casing' => false,
'native_function_invocation' => false,
'new_with_braces' => false,
'no_alias_functions' => true,
'no_alternative_syntax' => true,
'no_blank_lines_after_class_opening' => true,
'no_blank_lines_after_phpdoc' => true,
'no_blank_lines_before_namespace' => true,
'no_closing_tag' => true,
'no_empty_comment' => true,
'no_empty_phpdoc' => true,
'no_empty_statement' => true,
'no_extra_blank_lines' => true,
'no_homoglyph_names' => true,
'no_leading_import_slash' => true,
'no_leading_namespace_whitespace' => true,
'no_mixed_echo_print' => ['use' => 'print'],
'no_multiline_whitespace_around_double_arrow' => true,
'no_null_property_initialization' => true,
'no_php4_constructor' => true,
'no_short_bool_cast' => true,
'no_short_echo_tag' => true,
'no_singleline_whitespace_before_semicolons' => true,
'no_spaces_after_function_name' => true,
'no_spaces_inside_parenthesis' => true,
'no_superfluous_elseif' => true,
'no_superfluous_phpdoc_tags' => [
'allow_mixed' => true,
],
'no_trailing_comma_in_list_call' => true,
'no_trailing_comma_in_singleline_array' => true,
'no_trailing_whitespace' => true,
'no_trailing_whitespace_in_comment' => true,
'no_unneeded_control_parentheses' => true,
'no_unneeded_curly_braces' => true,
'no_unneeded_final_method' => true,
'no_unreachable_default_argument_value' => true,
'no_unset_on_property' => true,
'no_unused_imports' => true,
'no_useless_else' => true,
'no_useless_return' => true,
'no_whitespace_before_comma_in_array' => true,
'no_whitespace_in_blank_line' => true,
'non_printable_character' => true,
'normalize_index_brace' => true,
'object_operator_without_whitespace' => true,
'ordered_class_elements' => [
'order' => [
'use_trait',
'constant_public',
'constant_protected',
'constant_private',
'property_public_static',
'property_protected_static',
'property_private_static',
'property_public',
'property_protected',
'property_private',
'method_public_static',
'construct',
'destruct',
'magic',
'phpunit',
'method_public',
'method_protected',
'method_private',
'method_protected_static',
'method_private_static',
],
],
'ordered_imports' => [
'imports_order' => [
PhpCsFixer\Fixer\Import\OrderedImportsFixer::IMPORT_TYPE_CONST,
PhpCsFixer\Fixer\Import\OrderedImportsFixer::IMPORT_TYPE_FUNCTION,
PhpCsFixer\Fixer\Import\OrderedImportsFixer::IMPORT_TYPE_CLASS,
]
],
'ordered_interfaces' => [
'direction' => 'ascend',
'order' => 'alpha',
],
'phpdoc_add_missing_param_annotation' => false,
'phpdoc_align' => true,
'phpdoc_annotation_without_dot' => true,
'phpdoc_indent' => true,
'phpdoc_no_access' => true,
'phpdoc_no_empty_return' => true,
'phpdoc_no_package' => true,
'phpdoc_order' => true,
'phpdoc_return_self_reference' => true,
'phpdoc_scalar' => true,
'phpdoc_separation' => true,
'phpdoc_single_line_var_spacing' => true,
'phpdoc_summary' => true,
'phpdoc_to_comment' => true,
'phpdoc_trim' => true,
'phpdoc_trim_consecutive_blank_line_separation' => true,
'phpdoc_types' => ['groups' => ['simple', 'meta']],
'phpdoc_types_order' => true,
'phpdoc_var_without_name' => true,
'pow_to_exponentiation' => true,
'protected_to_private' => true,
'return_assignment' => true,
'return_type_declaration' => ['space_before' => 'none'],
'self_accessor' => true,
'semicolon_after_instruction' => true,
'set_type_to_cast' => true,
'short_scalar_cast' => true,
'simplified_null_return' => false,
'single_blank_line_at_eof' => true,
'single_import_per_statement' => true,
'single_line_after_imports' => true,
'single_quote' => true,
'standardize_not_equals' => true,
'ternary_to_null_coalescing' => true,
'trailing_comma_in_multiline_array' => true,
'trim_array_spaces' => true,
'unary_operator_spaces' => true,
'visibility_required' => [
'elements' => [
'const',
'method',
'property',
],
],
'void_return' => true,
'whitespace_after_comma_in_array' => true,
]);
php-timer-5.0.3/.psalm/ 0000775 0000000 0000000 00000000000 13767723214 0014632 5 ustar 00root root 0000000 0000000 php-timer-5.0.3/.psalm/baseline.xml 0000664 0000000 0000000 00000000157 13767723214 0017141 0 ustar 00root root 0000000 0000000
php-timer-5.0.3/.psalm/config.xml 0000664 0000000 0000000 00000000752 13767723214 0016625 0 ustar 00root root 0000000 0000000
php-timer-5.0.3/ChangeLog.md 0000664 0000000 0000000 00000011256 13767723214 0015616 0 ustar 00root root 0000000 0000000 # ChangeLog
All notable changes are documented in this file using the [Keep a CHANGELOG](http://keepachangelog.com/) principles.
## [5.0.3] - 2020-10-26
### Fixed
* `SebastianBergmann\Timer\Exception` now correctly extends `\Throwable`
## [5.0.2] - 2020-09-28
### Changed
* Changed PHP version constraint in `composer.json` from `^7.3 || ^8.0` to `>=7.3`
## [5.0.1] - 2020-06-26
### Added
* This component is now supported on PHP 8
## [5.0.0] - 2020-06-07
### Changed
* Parameter type for `SebastianBergmann\Timer\Duration::fromMicroseconds()` was changed from `int` to `float`
* Parameter type for `SebastianBergmann\Timer\Duration::fromNanoseconds()` was changed from `int` to `float`
* Return type for `SebastianBergmann\Timer\Duration::asNanoseconds()` was changed from `int` to `float`
### Fixed
* [#31](https://github.com/sebastianbergmann/php-timer/issues/31): Type Error on 32-bit systems (where `hrtime()` returns `float` instead of `int`)
## [4.0.0] - 2020-06-01
### Added
* Introduced `Duration` value object for encapsulating a duration with nanosecond granularity
* Introduced `ResourceUsageFormatter` object for formatting resource usage with option to explicitly pass a duration (instead of looking at the unreliable `$_SERVER['REQUEST_TIME_FLOAT']` variable)
### Changed
* The methods of `Timer` are no longer static
* `Timer::stop()` now returns a `Duration` value object
### Removed
* Functionality that is now implemented in `Duration` and `ResourceUsageFormatter` has been removed from `Timer`
## [3.1.4] - 2020-04-20
### Changed
* `Timer::timeSinceStartOfRequest()` no longer tries `$_SERVER['REQUEST_TIME']` when `$_SERVER['REQUEST_TIME_FLOAT']` is not available (`$_SERVER['REQUEST_TIME_FLOAT']` was added in PHP 5.4 and this library requires PHP 7.3)
* Improved exception messages when `$_SERVER['REQUEST_TIME_FLOAT']` is not set or is not of type `float`
### Changed
## [3.1.3] - 2020-04-20
### Changed
* `Timer::timeSinceStartOfRequest()` now raises an exception if `$_SERVER['REQUEST_TIME_FLOAT']` does not contain a `float` (or `$_SERVER['REQUEST_TIME']` does not contain an `int`)
## [3.1.2] - 2020-04-17
### Changed
* Improved the fix for [#30](https://github.com/sebastianbergmann/php-timer/issues/30) and restored usage of `hrtime()`
## [3.1.1] - 2020-04-17
### Fixed
* [#30](https://github.com/sebastianbergmann/php-timer/issues/30): Resolution of time returned by `Timer::stop()` is different than before (this reverts using `hrtime()` instead of `microtime()`)
## [3.1.0] - 2020-04-17
### Added
* `Timer::secondsToShortTimeString()` as alternative to `Timer::secondsToTimeString()`
### Changed
* `Timer::start()` and `Timer::stop()` now use `hrtime()` (high resolution monotonic timer) instead of `microtime()`
* `Timer::timeSinceStartOfRequest()` now uses `Timer::secondsToShortTimeString()` for time formatting
* Improved formatting of `Timer::secondsToTimeString()` result
## [3.0.0] - 2020-02-07
### Removed
* This component is no longer supported on PHP 7.1 and PHP 7.2
## [2.1.2] - 2019-06-07
### Fixed
* [#21](https://github.com/sebastianbergmann/php-timer/pull/21): Formatting of memory consumption does not work on 32bit systems
## [2.1.1] - 2019-02-20
### Changed
* Improved formatting of memory consumption for `resourceUsage()`
## [2.1.0] - 2019-02-20
### Changed
* Improved formatting of memory consumption for `resourceUsage()`
## [2.0.0] - 2018-02-01
### Changed
* This component now uses namespaces
### Removed
* This component is no longer supported on PHP 5.3, PHP 5.4, PHP 5.5, PHP 5.6, and PHP 7.0
[5.0.3]: https://github.com/sebastianbergmann/php-timer/compare/5.0.2...5.0.3
[5.0.2]: https://github.com/sebastianbergmann/php-timer/compare/5.0.1...5.0.2
[5.0.1]: https://github.com/sebastianbergmann/php-timer/compare/5.0.0...5.0.1
[5.0.0]: https://github.com/sebastianbergmann/php-timer/compare/4.0.0...5.0.0
[4.0.0]: https://github.com/sebastianbergmann/php-timer/compare/3.1.4...4.0.0
[3.1.4]: https://github.com/sebastianbergmann/php-timer/compare/3.1.3...3.1.4
[3.1.3]: https://github.com/sebastianbergmann/php-timer/compare/3.1.2...3.1.3
[3.1.2]: https://github.com/sebastianbergmann/php-timer/compare/3.1.1...3.1.2
[3.1.1]: https://github.com/sebastianbergmann/php-timer/compare/3.1.0...3.1.1
[3.1.0]: https://github.com/sebastianbergmann/php-timer/compare/3.0.0...3.1.0
[3.0.0]: https://github.com/sebastianbergmann/php-timer/compare/2.1.2...3.0.0
[2.1.2]: https://github.com/sebastianbergmann/php-timer/compare/2.1.1...2.1.2
[2.1.1]: https://github.com/sebastianbergmann/php-timer/compare/2.1.0...2.1.1
[2.1.0]: https://github.com/sebastianbergmann/php-timer/compare/2.0.0...2.1.0
[2.0.0]: https://github.com/sebastianbergmann/php-timer/compare/1.0.9...2.0.0
php-timer-5.0.3/LICENSE 0000664 0000000 0000000 00000003020 13767723214 0014440 0 ustar 00root root 0000000 0000000 phpunit/php-timer
Copyright (c) 2010-2020, Sebastian Bergmann .
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
* Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in
the documentation and/or other materials provided with the
distribution.
* Neither the name of Sebastian Bergmann nor the names of his
contributors may be used to endorse or promote products derived
from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
php-timer-5.0.3/README.md 0000664 0000000 0000000 00000004307 13767723214 0014723 0 ustar 00root root 0000000 0000000 # phpunit/php-timer
[](https://github.com/sebastianbergmann/php-timer/actions)
[](https://shepherd.dev/github/sebastianbergmann/php-timer)
Utility class for timing things, factored out of PHPUnit into a stand-alone component.
## Installation
You can add this library as a local, per-project dependency to your project using [Composer](https://getcomposer.org/):
```
composer require phpunit/php-timer
```
If you only need this library during development, for instance to run your project's test suite, then you should add it as a development-time dependency:
```
composer require --dev phpunit/php-timer
```
## Usage
### Basic Timing
```php
require __DIR__ . '/vendor/autoload.php';
use SebastianBergmann\Timer\Timer;
$timer = new Timer;
$timer->start();
foreach (\range(0, 100000) as $i) {
// ...
}
$duration = $timer->stop();
var_dump(get_class($duration));
var_dump($duration->asString());
var_dump($duration->asSeconds());
var_dump($duration->asMilliseconds());
var_dump($duration->asMicroseconds());
var_dump($duration->asNanoseconds());
```
The code above yields the output below:
```
string(32) "SebastianBergmann\Timer\Duration"
string(9) "00:00.002"
float(0.002851062)
float(2.851062)
float(2851.062)
int(2851062)
```
### Resource Consumption
#### Explicit duration
```php
require __DIR__ . '/vendor/autoload.php';
use SebastianBergmann\Timer\ResourceUsageFormatter;
use SebastianBergmann\Timer\Timer;
$timer = new Timer;
$timer->start();
foreach (\range(0, 100000) as $i) {
// ...
}
print (new ResourceUsageFormatter)->resourceUsage($timer->stop());
```
The code above yields the output below:
```
Time: 00:00.002, Memory: 6.00 MB
```
#### Duration since PHP Startup (using unreliable `$_SERVER['REQUEST_TIME_FLOAT']`)
```php
require __DIR__ . '/vendor/autoload.php';
use SebastianBergmann\Timer\ResourceUsageFormatter;
foreach (\range(0, 100000) as $i) {
// ...
}
print (new ResourceUsageFormatter)->resourceUsageSinceStartOfRequest();
```
The code above yields the output below:
```
Time: 00:00.002, Memory: 6.00 MB
```
php-timer-5.0.3/build.xml 0000664 0000000 0000000 00000002053 13767723214 0015261 0 ustar 00root root 0000000 0000000
php-timer-5.0.3/composer.json 0000664 0000000 0000000 00000001676 13767723214 0016174 0 ustar 00root root 0000000 0000000 {
"name": "phpunit/php-timer",
"description": "Utility class for timing",
"type": "library",
"keywords": [
"timer"
],
"homepage": "https://github.com/sebastianbergmann/php-timer/",
"license": "BSD-3-Clause",
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"support": {
"issues": "https://github.com/sebastianbergmann/php-timer/issues"
},
"prefer-stable": true,
"require": {
"php": ">=7.3"
},
"require-dev": {
"phpunit/phpunit": "^9.3"
},
"config": {
"platform": {
"php": "7.3.0"
},
"optimize-autoloader": true,
"sort-packages": true
},
"autoload": {
"classmap": [
"src/"
]
},
"extra": {
"branch-alias": {
"dev-master": "5.0-dev"
}
}
}
php-timer-5.0.3/phpunit.xml 0000664 0000000 0000000 00000001512 13767723214 0015650 0 ustar 00root root 0000000 0000000
tests
src
php-timer-5.0.3/src/ 0000775 0000000 0000000 00000000000 13767723214 0014227 5 ustar 00root root 0000000 0000000 php-timer-5.0.3/src/Duration.php 0000664 0000000 0000000 00000005166 13767723214 0016535 0 ustar 00root root 0000000 0000000
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Timer;
use function floor;
use function sprintf;
/**
* @psalm-immutable
*/
final class Duration
{
/**
* @var float
*/
private $nanoseconds;
/**
* @var int
*/
private $hours;
/**
* @var int
*/
private $minutes;
/**
* @var int
*/
private $seconds;
/**
* @var int
*/
private $milliseconds;
public static function fromMicroseconds(float $microseconds): self
{
return new self($microseconds * 1000);
}
public static function fromNanoseconds(float $nanoseconds): self
{
return new self($nanoseconds);
}
private function __construct(float $nanoseconds)
{
$this->nanoseconds = $nanoseconds;
$timeInMilliseconds = $nanoseconds / 1000000;
$hours = floor($timeInMilliseconds / 60 / 60 / 1000);
$hoursInMilliseconds = $hours * 60 * 60 * 1000;
$minutes = floor($timeInMilliseconds / 60 / 1000) % 60;
$minutesInMilliseconds = $minutes * 60 * 1000;
$seconds = floor(($timeInMilliseconds - $hoursInMilliseconds - $minutesInMilliseconds) / 1000);
$secondsInMilliseconds = $seconds * 1000;
$milliseconds = $timeInMilliseconds - $hoursInMilliseconds - $minutesInMilliseconds - $secondsInMilliseconds;
$this->hours = (int) $hours;
$this->minutes = $minutes;
$this->seconds = (int) $seconds;
$this->milliseconds = (int) $milliseconds;
}
public function asNanoseconds(): float
{
return $this->nanoseconds;
}
public function asMicroseconds(): float
{
return $this->nanoseconds / 1000;
}
public function asMilliseconds(): float
{
return $this->nanoseconds / 1000000;
}
public function asSeconds(): float
{
return $this->nanoseconds / 1000000000;
}
public function asString(): string
{
$result = '';
if ($this->hours > 0) {
$result = sprintf('%02d', $this->hours) . ':';
}
$result .= sprintf('%02d', $this->minutes) . ':';
$result .= sprintf('%02d', $this->seconds);
if ($this->milliseconds > 0) {
$result .= '.' . sprintf('%03d', $this->milliseconds);
}
return $result;
}
}
php-timer-5.0.3/src/ResourceUsageFormatter.php 0000664 0000000 0000000 00000004137 13767723214 0021405 0 ustar 00root root 0000000 0000000
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Timer;
use function is_float;
use function memory_get_peak_usage;
use function microtime;
use function sprintf;
final class ResourceUsageFormatter
{
/**
* @psalm-var array
*/
private const SIZES = [
'GB' => 1073741824,
'MB' => 1048576,
'KB' => 1024,
];
public function resourceUsage(Duration $duration): string
{
return sprintf(
'Time: %s, Memory: %s',
$duration->asString(),
$this->bytesToString(memory_get_peak_usage(true))
);
}
/**
* @throws TimeSinceStartOfRequestNotAvailableException
*/
public function resourceUsageSinceStartOfRequest(): string
{
if (!isset($_SERVER['REQUEST_TIME_FLOAT'])) {
throw new TimeSinceStartOfRequestNotAvailableException(
'Cannot determine time at which the request started because $_SERVER[\'REQUEST_TIME_FLOAT\'] is not available'
);
}
if (!is_float($_SERVER['REQUEST_TIME_FLOAT'])) {
throw new TimeSinceStartOfRequestNotAvailableException(
'Cannot determine time at which the request started because $_SERVER[\'REQUEST_TIME_FLOAT\'] is not of type float'
);
}
return $this->resourceUsage(
Duration::fromMicroseconds(
(1000000 * (microtime(true) - $_SERVER['REQUEST_TIME_FLOAT']))
)
);
}
private function bytesToString(int $bytes): string
{
foreach (self::SIZES as $unit => $value) {
if ($bytes >= $value) {
return sprintf('%.2f %s', $bytes >= 1024 ? $bytes / $value : $bytes, $unit);
}
}
// @codeCoverageIgnoreStart
return $bytes . ' byte' . ($bytes !== 1 ? 's' : '');
// @codeCoverageIgnoreEnd
}
}
php-timer-5.0.3/src/Timer.php 0000664 0000000 0000000 00000001634 13767723214 0016024 0 ustar 00root root 0000000 0000000
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Timer;
use function array_pop;
use function hrtime;
final class Timer
{
/**
* @psalm-var list
*/
private $startTimes = [];
public function start(): void
{
$this->startTimes[] = (float) hrtime(true);
}
/**
* @throws NoActiveTimerException
*/
public function stop(): Duration
{
if (empty($this->startTimes)) {
throw new NoActiveTimerException(
'Timer::start() has to be called before Timer::stop()'
);
}
return Duration::fromNanoseconds((float) hrtime(true) - array_pop($this->startTimes));
}
}
php-timer-5.0.3/src/exceptions/ 0000775 0000000 0000000 00000000000 13767723214 0016410 5 ustar 00root root 0000000 0000000 php-timer-5.0.3/src/exceptions/Exception.php 0000664 0000000 0000000 00000000545 13767723214 0021063 0 ustar 00root root 0000000 0000000
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Timer;
use Throwable;
interface Exception extends Throwable
{
}
php-timer-5.0.3/src/exceptions/NoActiveTimerException.php 0000664 0000000 0000000 00000000623 13767723214 0023512 0 ustar 00root root 0000000 0000000
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Timer;
use LogicException;
final class NoActiveTimerException extends LogicException implements Exception
{
}
php-timer-5.0.3/src/exceptions/TimeSinceStartOfRequestNotAvailableException.php 0000664 0000000 0000000 00000000655 13767723214 0030024 0 ustar 00root root 0000000 0000000
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Timer;
use RuntimeException;
final class TimeSinceStartOfRequestNotAvailableException extends RuntimeException implements Exception
{
}
php-timer-5.0.3/tests/ 0000775 0000000 0000000 00000000000 13767723214 0014602 5 ustar 00root root 0000000 0000000 php-timer-5.0.3/tests/DurationTest.php 0000664 0000000 0000000 00000007310 13767723214 0017741 0 ustar 00root root 0000000 0000000
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Timer;
use function round;
use PHPUnit\Framework\TestCase;
/**
* @covers \SebastianBergmann\Timer\Duration
*
* @uses \SebastianBergmann\Timer\Timer
*/
final class DurationTest extends TestCase
{
public function testCanBeCreatedFromNanoseconds(): void
{
$duration = Duration::fromNanoseconds(1);
$this->assertSame(1.0, $duration->asNanoseconds());
$this->assertSame(1.0E-3, $duration->asMicroseconds());
$this->assertSame(1.0E-6, $duration->asMilliseconds());
$this->assertSame(1.0E-9, $duration->asSeconds());
}
public function testCanBeCreatedFromMicroseconds(): void
{
$duration = Duration::fromMicroseconds(1);
$this->assertSame(1000.0, $duration->asNanoseconds());
$this->assertSame(1.0, $duration->asMicroseconds());
$this->assertSame(1.0E-3, $duration->asMilliseconds());
$this->assertSame(1.0E-6, $duration->asSeconds());
}
/**
* @dataProvider durationProvider
* @testdox Formats $microseconds microseconds as "$string"
*/
public function testCanBeFormattedAsString(string $string, int $microseconds): void
{
$duration = Duration::fromMicroseconds($microseconds);
$this->assertSame($string, $duration->asString());
}
public function durationProvider(): array
{
return [
['00:00', (int) round((0 * 1000000))],
['00:00.001', (int) round((.001 * 1000000))],
['00:00.010', (int) round((.01 * 1000000))],
['00:00.100', (int) round((.1 * 1000000))],
['00:00.999', (int) round((.999 * 1000000))],
['00:00.999', (int) round((.9999 * 1000000))],
['00:01', (int) round((1 * 1000000))],
['00:02', (int) round((2 * 1000000))],
['00:59.900', (int) round((59.9 * 1000000))],
['00:59.990', (int) round((59.99 * 1000000))],
['00:59.999', (int) round((59.999 * 1000000))],
['00:59.999', (int) round((59.9999 * 1000000))],
['00:59.001', (int) round((59.001 * 1000000))],
['00:59.010', (int) round((59.01 * 1000000))],
['01:00', (int) round((60 * 1000000))],
['01:01', (int) round((61 * 1000000))],
['02:00', (int) round((120 * 1000000))],
['02:01', (int) round((121 * 1000000))],
['59:59.900', (int) round((3599.9 * 1000000))],
['59:59.990', (int) round((3599.99 * 1000000))],
['59:59.999', (int) round((3599.999 * 1000000))],
['59:59.999', (int) round((3599.9999 * 1000000))],
['59:59.001', (int) round((3599.001 * 1000000))],
['59:59.010', (int) round((3599.01 * 1000000))],
['01:00:00', (int) round((3600 * 1000000))],
['01:00:01', (int) round((3601 * 1000000))],
['01:00:01.900', (int) round((3601.9 * 1000000))],
['01:00:01.990', (int) round((3601.99 * 1000000))],
['01:00:01.999', (int) round((3601.999 * 1000000))],
['01:00:01.999', (int) round((3601.9999 * 1000000))],
['01:00:59.999', (int) round((3659.9999 * 1000000))],
['01:00:59.001', (int) round((3659.001 * 1000000))],
['01:00:59.010', (int) round((3659.01 * 1000000))],
['01:59:59.999', (int) round((7199.9999 * 1000000))],
];
}
}
php-timer-5.0.3/tests/ResourceUsageFormatterTest.php 0000664 0000000 0000000 00000004240 13767723214 0022613 0 ustar 00root root 0000000 0000000
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Timer;
use PHPUnit\Framework\TestCase;
/**
* @covers \SebastianBergmann\Timer\ResourceUsageFormatter
*
* @uses \SebastianBergmann\Timer\Duration
* @uses \SebastianBergmann\Timer\Timer
*/
final class ResourceUsageFormatterTest extends TestCase
{
/**
* @var ResourceUsageFormatter
*/
private $formatter;
protected function setUp(): void
{
$this->formatter = new ResourceUsageFormatter;
}
public function testCanFormatResourceUsage(): void
{
$this->assertStringMatchesFormat(
'Time: 01:01, Memory: %s',
$this->formatter->resourceUsage(
Duration::fromMicroseconds(61000000)
)
);
}
public function testCanFormatResourceUsageSinceStartOfRequest(): void
{
$this->assertStringMatchesFormat(
'Time: %s, Memory: %s',
$this->formatter->resourceUsageSinceStartOfRequest()
);
}
/**
* @backupGlobals enabled
* @testdox Cannot format resource usage since start of request when $_SERVER['REQUEST_TIME_FLOAT'] is not available
*/
public function testCannotFormatResourceUsageSinceStartOfRequestWhenRequestTimeFloatIsNotAvailable(): void
{
unset($_SERVER['REQUEST_TIME_FLOAT']);
$this->expectException(TimeSinceStartOfRequestNotAvailableException::class);
$this->formatter->resourceUsageSinceStartOfRequest();
}
/**
* @backupGlobals enabled
* @testdox Cannot format resource usage since start of request when $_SERVER['REQUEST_TIME_FLOAT'] is not valid
*/
public function testCannotFormatResourceUsageSinceStartOfRequestWhenRequestTimeFloatIsNotValid(): void
{
$_SERVER['REQUEST_TIME_FLOAT'] = 'string';
$this->expectException(TimeSinceStartOfRequestNotAvailableException::class);
$this->formatter->resourceUsageSinceStartOfRequest();
}
}
php-timer-5.0.3/tests/TimerTest.php 0000664 0000000 0000000 00000001766 13767723214 0017245 0 ustar 00root root 0000000 0000000
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Timer;
use PHPUnit\Framework\TestCase;
/**
* @covers \SebastianBergmann\Timer\Timer
*
* @uses \SebastianBergmann\Timer\Duration
*/
final class TimerTest extends TestCase
{
/**
* @var Timer
*/
private $timer;
protected function setUp(): void
{
$this->timer = new Timer;
}
public function testCanBeStartedAndStopped(): void
{
$this->timer->start();
/* @noinspection UnnecessaryAssertionInspection */
$this->assertInstanceOf(Duration::class, $this->timer->stop());
}
public function testCannotBeStoppedWhenItWasNotStarted(): void
{
$this->expectException(NoActiveTimerException::class);
$this->timer->stop();
}
}