summaryrefslogtreecommitdiff
path: root/vendor/sebastian/diff/README.md
diff options
context:
space:
mode:
authorsupahgreg <supahgreg@users.noreply.github.com>2025-10-09 02:49:56 +0000
committersupahgreg <supahgreg@users.noreply.github.com>2025-10-09 03:08:30 +0000
commite41d6361221a30ca9d996cde7591111e626b7e1c (patch)
tree4572f61f37bbc76192ad60e0940c281483bc03af /vendor/sebastian/diff/README.md
parentab0aabf8548c206f3f624de5451a9b6abbde90be (diff)
Remove dev dependencies and update the rest.
Diffstat (limited to 'vendor/sebastian/diff/README.md')
-rw-r--r--vendor/sebastian/diff/README.md202
1 files changed, 0 insertions, 202 deletions
diff --git a/vendor/sebastian/diff/README.md b/vendor/sebastian/diff/README.md
deleted file mode 100644
index 734b852de..000000000
--- a/vendor/sebastian/diff/README.md
+++ /dev/null
@@ -1,202 +0,0 @@
-# sebastian/diff
-
-[![CI Status](https://github.com/sebastianbergmann/diff/workflows/CI/badge.svg)](https://github.com/sebastianbergmann/diff/actions)
-[![Type Coverage](https://shepherd.dev/github/sebastianbergmann/diff/coverage.svg)](https://shepherd.dev/github/sebastianbergmann/diff)
-
-Diff implementation for PHP, 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 sebastian/diff
-```
-
-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 sebastian/diff
-```
-
-### Usage
-
-#### Generating diff
-
-The `Differ` class can be used to generate a textual representation of the difference between two strings:
-
-```php
-<?php
-use SebastianBergmann\Diff\Differ;
-
-$differ = new Differ;
-print $differ->diff('foo', 'bar');
-```
-
-The code above yields the output below:
-```diff
---- Original
-+++ New
-@@ @@
--foo
-+bar
-```
-
-There are three output builders available in this package:
-
-#### UnifiedDiffOutputBuilder
-
-This is default builder, which generates the output close to udiff and is used by PHPUnit.
-
-```php
-<?php
-
-use SebastianBergmann\Diff\Differ;
-use SebastianBergmann\Diff\Output\UnifiedDiffOutputBuilder;
-
-$builder = new UnifiedDiffOutputBuilder(
- "--- Original\n+++ New\n", // custom header
- false // do not add line numbers to the diff
-);
-
-$differ = new Differ($builder);
-print $differ->diff('foo', 'bar');
-```
-
-#### StrictUnifiedDiffOutputBuilder
-
-Generates (strict) Unified diff's (unidiffs) with hunks,
-similar to `diff -u` and compatible with `patch` and `git apply`.
-
-```php
-<?php
-
-use SebastianBergmann\Diff\Differ;
-use SebastianBergmann\Diff\Output\StrictUnifiedDiffOutputBuilder;
-
-$builder = new StrictUnifiedDiffOutputBuilder([
- 'collapseRanges' => true, // ranges of length one are rendered with the trailing `,1`
- 'commonLineThreshold' => 6, // number of same lines before ending a new hunk and creating a new one (if needed)
- 'contextLines' => 3, // like `diff: -u, -U NUM, --unified[=NUM]`, for patch/git apply compatibility best to keep at least @ 3
- 'fromFile' => null,
- 'fromFileDate' => null,
- 'toFile' => null,
- 'toFileDate' => null,
-]);
-
-$differ = new Differ($builder);
-print $differ->diff('foo', 'bar');
-```
-
-#### DiffOnlyOutputBuilder
-
-Output only the lines that differ.
-
-```php
-<?php
-
-use SebastianBergmann\Diff\Differ;
-use SebastianBergmann\Diff\Output\DiffOnlyOutputBuilder;
-
-$builder = new DiffOnlyOutputBuilder(
- "--- Original\n+++ New\n"
-);
-
-$differ = new Differ($builder);
-print $differ->diff('foo', 'bar');
-```
-
-#### DiffOutputBuilderInterface
-
-You can pass any output builder to the `Differ` class as longs as it implements the `DiffOutputBuilderInterface`.
-
-#### Parsing diff
-
-The `Parser` class can be used to parse a unified diff into an object graph:
-
-```php
-use SebastianBergmann\Diff\Parser;
-use SebastianBergmann\Git;
-
-$git = new Git('/usr/local/src/money');
-
-$diff = $git->getDiff(
- '948a1a07768d8edd10dcefa8315c1cbeffb31833',
- 'c07a373d2399f3e686234c4f7f088d635eb9641b'
-);
-
-$parser = new Parser;
-
-print_r($parser->parse($diff));
-```
-
-The code above yields the output below:
-
- Array
- (
- [0] => SebastianBergmann\Diff\Diff Object
- (
- [from:SebastianBergmann\Diff\Diff:private] => a/tests/MoneyTest.php
- [to:SebastianBergmann\Diff\Diff:private] => b/tests/MoneyTest.php
- [chunks:SebastianBergmann\Diff\Diff:private] => Array
- (
- [0] => SebastianBergmann\Diff\Chunk Object
- (
- [start:SebastianBergmann\Diff\Chunk:private] => 87
- [startRange:SebastianBergmann\Diff\Chunk:private] => 7
- [end:SebastianBergmann\Diff\Chunk:private] => 87
- [endRange:SebastianBergmann\Diff\Chunk:private] => 7
- [lines:SebastianBergmann\Diff\Chunk:private] => Array
- (
- [0] => SebastianBergmann\Diff\Line Object
- (
- [type:SebastianBergmann\Diff\Line:private] => 3
- [content:SebastianBergmann\Diff\Line:private] => * @covers SebastianBergmann\Money\Money::add
- )
-
- [1] => SebastianBergmann\Diff\Line Object
- (
- [type:SebastianBergmann\Diff\Line:private] => 3
- [content:SebastianBergmann\Diff\Line:private] => * @covers SebastianBergmann\Money\Money::newMoney
- )
-
- [2] => SebastianBergmann\Diff\Line Object
- (
- [type:SebastianBergmann\Diff\Line:private] => 3
- [content:SebastianBergmann\Diff\Line:private] => */
- )
-
- [3] => SebastianBergmann\Diff\Line Object
- (
- [type:SebastianBergmann\Diff\Line:private] => 2
- [content:SebastianBergmann\Diff\Line:private] => public function testAnotherMoneyWithSameCurrencyObjectCanBeAdded()
- )
-
- [4] => SebastianBergmann\Diff\Line Object
- (
- [type:SebastianBergmann\Diff\Line:private] => 1
- [content:SebastianBergmann\Diff\Line:private] => public function testAnotherMoneyObjectWithSameCurrencyCanBeAdded()
- )
-
- [5] => SebastianBergmann\Diff\Line Object
- (
- [type:SebastianBergmann\Diff\Line:private] => 3
- [content:SebastianBergmann\Diff\Line:private] => {
- )
-
- [6] => SebastianBergmann\Diff\Line Object
- (
- [type:SebastianBergmann\Diff\Line:private] => 3
- [content:SebastianBergmann\Diff\Line:private] => $a = new Money(1, new Currency('EUR'));
- )
-
- [7] => SebastianBergmann\Diff\Line Object
- (
- [type:SebastianBergmann\Diff\Line:private] => 3
- [content:SebastianBergmann\Diff\Line:private] => $b = new Money(2, new Currency('EUR'));
- )
- )
- )
- )
- )
- )