refactor: rename Interfaces syntax to Contracts

Author: DenTray

MIGRATION-GUIDES.md

@@ -10,4 +10,6 @@ The base namespace of the package had also been changed, so you need to use new
 - `tests/TestCase.php`, change namespace of `\RonasIT\Support\AutoDoc\Tests\AutoDocTestCaseTrait` to
   `\RonasIT\AutoDoc\Traits\AutoDocTestCaseTrait`;
 - `phpunit.xml`, change namespace of extension from `RonasIT\Support\AutoDoc\Tests\PhpUnitExtensions\SwaggerExtension` to
-  `RonasIT\AutoDoc\Support\PHPUnit\Extensions\SwaggerExtension`
+  `RonasIT\AutoDoc\Support\PHPUnit\Extensions\SwaggerExtension`;
+- your custom documentation drivers, change interface from `RonasIT\AutoDoc\Interfaces\SwaggerDriverInterface` to
+  `RonasIT\AutoDoc\Contracts\SwaggerDriverContract`.

config/auto-doc.php

@@ -110,7 +110,7 @@
     |
     | The name of driver, which will collect and save documentation
     | Feel free to use your own driver class which should be inherited from
-    | `RonasIT\AutoDoc\Interfaces\SwaggerDriverInterface` interface,
+    | `RonasIT\AutoDoc\Contracts\SwaggerDriverContract` interface,
     | or one of our drivers from the `drivers` config:
     */
     'driver' => env('SWAGGER_DRIVER', 'local'),

src/Interfaces/SwaggerDriverInterface.php renamed to src/Contracts/SwaggerDriverContract.php

@@ -1,8 +1,8 @@
 <?php
 
-namespace RonasIT\AutoDoc\Interfaces;
+namespace RonasIT\AutoDoc\Contracts;
 
-interface SwaggerDriverInterface
+interface SwaggerDriverContract
 {
     /**
      * Save temporary data

src/Drivers/BaseDriver.php

@@ -2,9 +2,9 @@
 
 namespace RonasIT\AutoDoc\Drivers;
 
-use RonasIT\AutoDoc\Interfaces\SwaggerDriverInterface;
+use RonasIT\AutoDoc\Contracts\SwaggerDriverContract;
 
-abstract class BaseDriver implements SwaggerDriverInterface
+abstract class BaseDriver implements SwaggerDriverContract
 {
     protected string $tempFilePath;
 

src/Services/SwaggerService.php

@@ -17,13 +17,13 @@
 use RonasIT\AutoDoc\Exceptions\SwaggerDriverClassNotFoundException;
 use RonasIT\AutoDoc\Exceptions\UnsupportedDocumentationViewerException;
 use RonasIT\AutoDoc\Exceptions\WrongSecurityConfigException;
-use RonasIT\AutoDoc\Interfaces\SwaggerDriverInterface;
+use RonasIT\AutoDoc\Contracts\SwaggerDriverContract;
 use RonasIT\AutoDoc\Traits\GetDependenciesTrait;
 use RonasIT\AutoDoc\Validators\SwaggerSpecValidator;
 use Symfony\Component\HttpFoundation\Response;
 
 /**
- * @property SwaggerDriverInterface $driver
+ * @property SwaggerDriverContract $driver
  */
 class SwaggerService
 {
@@ -124,7 +124,7 @@ protected function setDriver()
             $this->driver = app($className);
         }
 
-        if (!$this->driver instanceof SwaggerDriverInterface) {
+        if (!$this->driver instanceof SwaggerDriverContract) {
             throw new InvalidDriverClassException($driver);
         }
     }