Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## Project identity and scope

This is VitaliyBoyko's PCOV fork: a native PHP line-coverage extension with synchronous coverage export, immutable executable-line manifests, and optional native Magento GET coverage caching. It is not the upstream `krakjoe/pcov` release. Start with [README.md](README.md) for usage and [docs/manifest-and-records.md](docs/manifest-and-records.md) for the record contract.
This is MageLens's PCOV fork: a native PHP line-coverage extension with synchronous coverage export, immutable executable-line manifests, and optional native Magento GET coverage caching. It is not the upstream `krakjoe/pcov` release. Start with [README.md](README.md) for usage and [docs/manifest-and-records.md](docs/manifest-and-records.md) for the record contract.

The supported release target is Linux, non-thread-safe PHP 8.3, 8.4 and 8.5, as declared by `composer.json`, `config.m4` and CI. Legacy `cfg/701/` through `cfg/704/` and `config.w32` are retained source, not evidence of current PHP 7, Windows or ZTS support.

Expand Down
15 changes: 10 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# PCOV fork: PHP code coverage for large test suites

Copyright (c) MageLens for original contributions to this fork. The upstream
copyright notices and [PHP License 3.01](LICENSE) apply.
This is an alternative distribution of [PCOV](https://github.com/krakjoe/pcov)
for aggregate coverage of large PHP test suites. It keeps PCOV's fast opcode
recording and all upstream APIs, and adds a synchronous native export path that
Expand Down Expand Up @@ -28,15 +30,18 @@ across an entire suite, not for a standalone request report.

## Requirements and installation

Release 2.1.2 supports Linux, NTS PHP 8.3, 8.4, and 8.5. It uses the extension
Release 2.1.3 supports Linux, NTS PHP 8.3, 8.4, and 8.5. It uses the extension
name `pcov`, so it replaces and cannot be loaded beside official PCOV.

Install with [PIE](https://github.com/php/pie), the PHP extension installer:

```sh
pie install vitaliyboyko/pcov
pie install magelens/pcov
```

Version 2.1.3 moves the package to `magelens/pcov`. Existing releases remain
available as `vitaliyboyko/pcov`.

Or build from source:

```sh
Expand Down Expand Up @@ -276,7 +281,7 @@ See [cache details](docs/manifest-and-records.md#native-magento-export-cache-212

### Is this the upstream PCOV package?

No. This is `vitaliyboyko/pcov`, an alternative distribution of [krakjoe/pcov](https://github.com/krakjoe/pcov). It uses the same extension name and preserves the upstream collection API. Install one distribution at a time; use a dedicated coverage SAPI without Xdebug or phpdbg coverage hooks.
No. This is `magelens/pcov`, an alternative distribution of [krakjoe/pcov](https://github.com/krakjoe/pcov). It uses the same extension name and preserves the upstream collection API. Install one distribution at a time; use a dedicated coverage SAPI without Xdebug or phpdbg coverage hooks.

### Does the manifest workflow run automatically in PHPUnit?

Expand All @@ -288,9 +293,9 @@ No. Export is synchronous and process-local. Manifest validation can reduce repe

### Where can I see a Magento integration?

[MageLens](https://github.com/VitaliyBoyko/MageLens) uses this fork for PHP coverage from Cypress or Playwright HTTP requests and combines it with JavaScript and [template coverage](https://github.com/VitaliyBoyko/magento-template-coverage). The [benchmark data](benchmark/measurements/) records specific test environments; it is not a performance guarantee for other workloads.
[MageLens](https://github.com/MageLens/MageLens) uses this fork for PHP coverage from Cypress or Playwright HTTP requests and combines it with JavaScript and [template coverage](https://github.com/MageLens/magento-template-coverage). The [benchmark data](benchmark/measurements/) records specific test environments; it is not a performance guarantee for other workloads.

Report fork-specific problems in [this repository's issues](https://github.com/VitaliyBoyko/pcov/issues), including PHP version, SAPI, extension settings and export mode. Published versions are listed under [releases](https://github.com/VitaliyBoyko/pcov/releases).
Report fork-specific problems in [this repository's issues](https://github.com/MageLens/pcov/issues), including PHP version, SAPI, extension settings and export mode. Published versions are listed under [releases](https://github.com/MageLens/pcov/releases).

## License

Expand Down
8 changes: 4 additions & 4 deletions composer.json
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
{
"name": "vitaliyboyko/pcov",
"name": "magelens/pcov",
"type": "php-ext",
"license": "PHP-3.01",
"description": "PCOV fork for PHP line coverage with synchronous native export and executable-line manifest reuse for large test suites",
"keywords": ["php", "pcov", "code-coverage", "phpunit", "testing", "php-extension", "magento2"],
"homepage": "https://github.com/VitaliyBoyko/pcov",
"homepage": "https://github.com/MageLens/pcov",
"support": {
"issues": "https://github.com/VitaliyBoyko/pcov/issues",
"source": "https://github.com/VitaliyBoyko/pcov"
"issues": "https://github.com/MageLens/pcov/issues",
"source": "https://github.com/MageLens/pcov"
},
"require": {
"php": ">=8.3 <8.6"
Expand Down
2 changes: 1 addition & 1 deletion php_pcov.h
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@
extern zend_module_entry pcov_module_entry;
#define phpext_pcov_ptr &pcov_module_entry

#define PHP_PCOV_VERSION "2.1.2"
#define PHP_PCOV_VERSION "2.1.3"

#ifdef PHP_WIN32
# define PHP_PCOV_API __declspec(dllexport)
Expand Down
Loading