Added 'noResponseCalls' option

Author: mpociot

README.md

@@ -44,6 +44,8 @@ Option | Description
 `routePrefix` | The route prefix to use for generation - `*` can be used as a wildcard
 `routes` | The route names to use for generation - Required if no routePrefix is provided
 `actAsUserId` | The user ID to use for authenticated API response calls
+`noResponseCalls` | Disable API response calls
+`actAsUserId` | The user ID to use for authenticated API response calls
 `router` | The router to use, when processing the route files (can be Laravel or Dingo - defaults to Laravel)
 `bindings` | List of route bindings that should be replaced when trying to retrieve route results. Syntax format: `binding_one,id|binding_two,id` 
 
@@ -96,6 +98,12 @@ If your API needs an authenticated user, you can use the `actAsUserId` option to
 $ php artisan api:generate --routePrefix=api/* --actAsUserId=1
 ```
 
+If you don't want to automatically perform API response calls, use the `noResponseCalls` option.
+
+```sh
+$ php artisan api:generate --routePrefix=api/* --noResponseCalls
+```
+
 > Note: The example API responses work best with seeded data.
 
 

src/Mpociot/ApiDoc/Commands/GenerateDocumentation.php

@@ -21,6 +21,7 @@ class GenerateDocumentation extends Command
                             {--output=public/docs : The output path for the generated documentation}
                             {--routePrefix= : The route prefix to use for generation}
                             {--routes=* : The route names to use for generation}
+                            {--noResponseCalls : The user ID to use for API response calls}
                             {--actAsUserId= : The user ID to use for API response calls}
                             {--router=laravel : The router to be used (Laravel or Dingo)}
                             {--bindings= : Route Model Bindings}
@@ -163,13 +164,14 @@ private function getRoutes()
      */
     private function processLaravelRoutes(AbstractGenerator $generator, $allowedRoutes, $routePrefix)
     {
+        $withResponse = $this->option('noResponseCalls') === false;
         $routes = $this->getRoutes();
         $bindings = $this->getBindings();
         $parsedRoutes = [];
         foreach ($routes as $route) {
             if (in_array($route->getName(), $allowedRoutes) || str_is($routePrefix, $route->getUri())) {
                 if ($this->isValidRoute($route)) {
-                    $parsedRoutes[] = $generator->processRoute($route, $bindings);
+                    $parsedRoutes[] = $generator->processRoute($route, $bindings, $withResponse);
                     $this->info('Processed route: '.$route->getUri());
                 } else {
                     $this->warn('Skipping route: '.$route->getUri().' - contains closure.');
@@ -189,12 +191,13 @@ private function processLaravelRoutes(AbstractGenerator $generator, $allowedRout
      */
     private function processDingoRoutes(AbstractGenerator $generator, $allowedRoutes, $routePrefix)
     {
+        $withResponse = $this->option('noResponseCalls') === false;
         $routes = $this->getRoutes();
         $bindings = $this->getBindings();
         $parsedRoutes = [];
         foreach ($routes as $route) {
             if (empty($allowedRoutes) || in_array($route->getName(), $allowedRoutes) || str_is($routePrefix, $route->uri())) {
-                $parsedRoutes[] = $generator->processRoute($route, $bindings);
+                $parsedRoutes[] = $generator->processRoute($route, $bindings, $withResponse);
                 $this->info('Processed route: '.$route->uri());
             }
         }

src/Mpociot/ApiDoc/Generators/AbstractGenerator.php

@@ -21,10 +21,11 @@ abstract protected function getUri($route);
     /**
      * @param  \Illuminate\Routing\Route $route
      * @param array $bindings
-     *
+     * @param bool $withResponse
+     * 
      * @return array
      */
-    abstract public function processRoute($route, $bindings = []);
+    abstract public function processRoute($route, $bindings = [], $withResponse = true);
 
     /**
      * @param array $routeData

src/Mpociot/ApiDoc/Generators/DingoGenerator.php

@@ -7,18 +7,22 @@
 class DingoGenerator extends AbstractGenerator
 {
     /**
-     * @param $route
+     * @param \Illuminate\Routing\Route $route
      * @param array $bindings
-     *
+     * @param bool $withResponse
+     * 
      * @return array
      */
-    public function processRoute($route, $bindings = [])
+    public function processRoute($route, $bindings = [], $withResponse = true)
     {
-        try {
-            $response = $this->getRouteResponse($route, $bindings);
-        } catch (Exception $e) {
-            $response = '';
+        $response = '';
+        
+        if ($withResponse) {
+            try {
+                $response = $this->getRouteResponse($route, $bindings);
+            } catch (Exception $e) {}
         }
+        
         $routeAction = $route->getAction();
         $routeGroup = $this->getRouteGroup($routeAction['uses']);
         $routeDescription = $this->getRouteDescription($routeAction['uses']);

src/Mpociot/ApiDoc/Generators/LaravelGenerator.php

@@ -21,12 +21,17 @@ protected function getUri($route)
     /**
      * @param  \Illuminate\Routing\Route $route
      * @param array $bindings
+     * @param bool $withResponse
      *
      * @return array
      */
-    public function processRoute($route, $bindings = [])
+    public function processRoute($route, $bindings = [], $withResponse = true)
     {
-        $response = $this->getRouteResponse($route, $bindings);
+        $response = '';
+
+        if ($withResponse) {
+            $response = $this->getRouteResponse($route, $bindings);
+        }
 
         $routeAction = $route->getAction();
         $routeGroup = $this->getRouteGroup($routeAction['uses']);