Feat: add exists in migrator (#289)

* Add exists in Migrator

* Fix README

README.md

@@ -410,6 +410,19 @@ public function up(): void
 }
 ```
 
+#### Checking a property if it exists
+
+There might be times when you want to check if a property exists in the database. This can be done as such:
+
+```php
+public function up(): void
+{
+    if ($this->migrator->exists('general.timezone')) {
+        // do something
+    }
+}
+```
+
 #### Operations in group
 
 When you're working on a big settings class with many properties, it can be a bit cumbersome always to have to prepend the settings group. That's why you can also perform operations within a settings group:

src/Migrations/SettingsMigrator.php

@@ -114,6 +114,11 @@ public function decrypt(string $property): void
         $this->update($property, fn ($payload) => Crypto::decrypt($payload));
     }
 
+    public function exists(string $property): bool
+    {
+        return $this->checkIfPropertyExists($property);
+    }
+
     public function inGroup(string $group, Closure $closure): void
     {
         $closure(new SettingsBlueprint($group, $this));

tests/SettingsMigratorTest.php

@@ -100,6 +100,16 @@
     $this->settingsMigrator->update('user.name', fn (string $name) => 'Ruben Van Assche');
 })->throws(SettingDoesNotExist::class);
 
+it('can check if a setting exists', function () {
+    $this->settingsMigrator->add('settings.exists', true);
+
+    expect($this->settingsMigrator->exists('settings.exists'))->toBeTrue();
+});
+
+it('can check if a setting does not exists', function () {
+    expect($this->settingsMigrator->exists('settings.does_not_exists'))->toBeFalse();
+});
+
 it('can perform migrations within a group', function () {
     $this->settingsMigrator->inGroup('test', function (SettingsBlueprint $blueprint): void {
         $blueprint->add('a', 'Alpha');