Download the PHP package traviscarden/behat-table-comparison without Composer
On this page you can find all versions of the php package traviscarden/behat-table-comparison. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download traviscarden/behat-table-comparison
More information about traviscarden/behat-table-comparison
Files in traviscarden/behat-table-comparison
Package behat-table-comparison
Short Description Provides an equality assertion for comparing Behat TableNode tables.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package behat-table-comparison
Behat Table Comparison
The Behat Table Comparison library provides an equality assertion for comparing Behat TableNode tables.
Installation & Usage
Install the library via Composer:
Then use the FeatureContext class:
Output is like the following:
Understanding Headers and Terminology
When using expectHeader(...), it's important to understand the asymmetrical design:
- Specified header: The header you declare by calling
expectHeader(...). This is what the columns should be. - Expected table: The table you provide as the first argument to
TableEqualityAssertion(your test specification). Its first row must match the specified header and is stripped before comparison. - Actual table: The table you provide as the second argument to
TableEqualityAssertion(the application's real output). It is compared as-is with no header validation or stripping.
This design is intentional: test specifications typically include headers (e.g., from Gherkin), while application-generated output often does not.
Error Message Specification
When tables are unequal, the assertion throws UnequalTablesException with a detailed
diagnostic message. The integer error code, available via getCode(), identifies the
category of failure:
| Constant | When thrown |
|---|---|
UnequalTablesException::HEADER_MISMATCH |
The header row does not match the expected header. |
UnequalTablesException::CONTENT_MISMATCH |
Rows are missing, unexpected, or duplicated. |
UnequalTablesException::ROW_ORDER_MISMATCH |
The same rows are present but in a different order. |
UnequalTablesException::STRUCTURAL_ERROR |
A structural failure occurred processing a table; see getPrevious(). |
Consumers should use the named constants rather than bare integers. For example:
For a complete list of stable/public guarantees, see Contract Surface.
Difference sections
--- Missing rows: Rows present in expected but not in actual.+++ Unexpected rows: Rows present in actual but not in expected.*** Duplicate rows: Rows present on both sides with different multiplicity, shown as(appears N time/times, expected M).
Row-order diagnostics
When row order is respected and rows are out of order:
*** Row order mismatchis shown.- Per-row diagnostics are listed as
... should be at position X, found at Y. - Full order context is appended under:
Expected orderActual order
When row content differs while respecting row order, semantic missing/unexpected/duplicate sections are shown first, then full expected/actual order tables.
Header mismatch diagnostics
When expectHeader(...) is used and the expected table's first row does not match the specified header:
--- Expected header: The header specification passed toexpectHeader(...)+++ Given header: The expected table's first row (the test specification header that was provided)
Label customization
All user-facing section labels are configurable via defaults plus getter/setter pairs:
- Missing rows
- Unexpected rows
- Duplicate rows
- Row order mismatch
- Expected header
- Given header
- Expected order subheading
- Actual order subheading
Examples
See examples/features/examples.feature for more examples.
Contribution
All contributions are welcome according to normal open source practice.
