From cad8a41e6d41083b405a0ab8bd3cd54350542fe6 Mon Sep 17 00:00:00 2001
From: Owen Voke <development@voke.dev>
Date: Wed, 16 Sep 2020 08:20:00 +0100
Subject: [PATCH] feat(expectations): add toStartWith

---
 src/Expectation.php          | 10 ++++++++++
 tests/Expect/toStartWith.php | 15 +++++++++++++++
 2 files changed, 25 insertions(+)
 create mode 100644 tests/Expect/toStartWith.php

diff --git a/src/Expectation.php b/src/Expectation.php
index 879f7131..17479ba6 100644
--- a/src/Expectation.php
+++ b/src/Expectation.php
@@ -158,6 +158,16 @@ final class Expectation
         return $this;
     }
 
+    /**
+     * Asserts that the value starts with $expected.
+     */
+    public function toStartWith(string $expected): Expectation
+    {
+        Assert::assertStringStartsWith($expected, $this->value);
+
+        return $this;
+    }
+
     /**
      * Asserts that $count matches the number of elements of the value.
      */
diff --git a/tests/Expect/toStartWith.php b/tests/Expect/toStartWith.php
new file mode 100644
index 00000000..64465869
--- /dev/null
+++ b/tests/Expect/toStartWith.php
@@ -0,0 +1,15 @@
+<?php
+
+use PHPUnit\Framework\ExpectationFailedException;
+
+test('pass', function () {
+    expect('username')->toStartWith('user');
+});
+
+test('failures', function () {
+    expect('username')->toStartWith('password');
+})->throws(ExpectationFailedException::class);
+
+test('not failures', function () {
+    expect('username')->not->toStartWith('user');
+})->throws(ExpectationFailedException::class);