generator = new LaravelGenerator(); } public function tearDown() { // delete the generated docs - compatible cross-platform $dir = __DIR__.'/../public/docs'; if (is_dir($dir)) { $files = new RecursiveIteratorIterator( new RecursiveDirectoryIterator($dir, RecursiveDirectoryIterator::SKIP_DOTS), RecursiveIteratorIterator::CHILD_FIRST ); foreach ($files as $fileinfo) { $todo = ($fileinfo->isDir() ? 'rmdir' : 'unlink'); $todo($fileinfo->getRealPath()); } rmdir($dir); } } /** * @param \Illuminate\Foundation\Application $app * * @return array */ protected function getPackageProviders($app) { return [ LaravelServiceProvider::class, ApiDocGeneratorServiceProvider::class, ]; } public function testConsoleCommandNeedsPrefixesOrDomainsOrRoutes() { $output = $this->artisan('api:generate'); $this->assertEquals('You must provide either a route prefix, a route domain, a route or a middleware to generate the documentation.'.PHP_EOL, $output); } public function testConsoleCommandDoesNotWorkWithClosure() { RouteFacade::get('/api/closure', function () { return 'foo'; }); RouteFacade::get('/api/test', TestController::class.'@parseMethodDescription'); $output = $this->artisan('api:generate', [ '--routePrefix' => 'api/*', ]); $this->assertContains('Skipping route: [GET] api/closure', $output); $this->assertContains('Processed route: [GET] api/test', $output); } public function testConsoleCommandDoesNotWorkWithClosureUsingDingo() { if (version_compare($this->app->version(), '5.4', '>=')) { $this->markTestSkipped('Dingo does not support Laravel 5.4'); } $api = app('Dingo\Api\Routing\Router'); $api->version('v1', function ($api) { $api->get('/closure', function () { return 'foo'; }); $api->get('/test', DingoTestController::class.'@parseMethodDescription'); $output = $this->artisan('api:generate', [ '--router' => 'dingo', '--routePrefix' => 'v1', ]); $this->assertContains('Skipping route: [GET] closure', $output); $this->assertContains('Processed route: [GET] test', $output); }); } public function testCanSkipSingleRoutesCommandDoesNotWorkWithClosure() { RouteFacade::get('/api/skip', TestController::class.'@skip'); RouteFacade::get('/api/test', TestController::class.'@parseMethodDescription'); $output = $this->artisan('api:generate', [ '--routePrefix' => 'api/*', ]); $this->assertContains('Skipping route: [GET] api/skip', $output); $this->assertContains('Processed route: [GET] api/test', $output); } public function testCanParseResourceRoutes() { RouteFacade::resource('/api/user', TestResourceController::class); $output = $this->artisan('api:generate', [ '--routePrefix' => 'api/*', ]); $fixtureMarkdown = __DIR__.'/Fixtures/resource_index.md'; $generatedMarkdown = __DIR__.'/../public/docs/source/index.md'; $this->assertFilesHaveSameContent($fixtureMarkdown, $generatedMarkdown); } public function testCanParsePartialResourceRoutes() { RouteFacade::resource('/api/user', TestResourceController::class, [ 'only' => [ 'index', 'create', ], ]); $output = $this->artisan('api:generate', [ '--routePrefix' => 'api/*', ]); $fixtureMarkdown = __DIR__.'/Fixtures/partial_resource_index.md'; $generatedMarkdown = __DIR__.'/../public/docs/source/index.md'; $this->assertFilesHaveSameContent($fixtureMarkdown, $generatedMarkdown); RouteFacade::apiResource('/api/user', TestResourceController::class, [ 'only' => [ 'index', 'create', ], ]); $output = $this->artisan('api:generate', [ '--routePrefix' => 'api/*', ]); $fixtureMarkdown = __DIR__.'/Fixtures/partial_resource_index.md'; $generatedMarkdown = __DIR__.'/../public/docs/source/index.md'; $this->assertFilesHaveSameContent($fixtureMarkdown, $generatedMarkdown); } public function testGeneratedMarkdownFileIsCorrect() { RouteFacade::get('/api/test', TestController::class.'@parseMethodDescription'); RouteFacade::get('/api/fetch', TestController::class.'@fetchRouteResponse'); $output = $this->artisan('api:generate', [ '--routePrefix' => 'api/*', ]); $generatedMarkdown = __DIR__.'/../public/docs/source/index.md'; $compareMarkdown = __DIR__.'/../public/docs/source/.compare.md'; $fixtureMarkdown = __DIR__.'/Fixtures/index.md'; $this->assertFilesHaveSameContent($fixtureMarkdown, $generatedMarkdown); $this->assertFilesHaveSameContent($fixtureMarkdown, $compareMarkdown); } public function testCanPrependAndAppendDataToGeneratedMarkdown() { RouteFacade::get('/api/test', TestController::class.'@parseMethodDescription'); RouteFacade::get('/api/fetch', TestController::class.'@fetchRouteResponse'); $this->artisan('api:generate', [ '--routePrefix' => 'api/*', ]); $prependMarkdown = __DIR__.'/Fixtures/prepend.md'; $appendMarkdown = __DIR__.'/Fixtures/append.md'; copy($prependMarkdown, __DIR__.'/../public/docs/source/prepend.md'); copy($appendMarkdown, __DIR__.'/../public/docs/source/append.md'); $this->artisan('api:generate', [ '--routePrefix' => 'api/*', ]); $generatedMarkdown = __DIR__.'/../public/docs/source/index.md'; $this->assertContainsRaw($this->getFileContents($prependMarkdown), $this->getFileContents($generatedMarkdown)); $this->assertContainsRaw($this->getFileContents($appendMarkdown), $this->getFileContents($generatedMarkdown)); } public function testAddsBindingsToGetRouteRules() { RouteFacade::get('/api/test/{foo}', TestController::class.'@addRouteBindingsToRequestClass'); $this->artisan('api:generate', [ '--routePrefix' => 'api/*', '--bindings' => 'foo,bar', ]); $generatedMarkdown = file_get_contents(__DIR__.'/../public/docs/source/index.md'); $this->assertContains('Not in: `bar`', $generatedMarkdown); } public function testGeneratedPostmanCollectionFileIsCorrect() { RouteFacade::get('/api/test', TestController::class.'@parseMethodDescription'); RouteFacade::post('/api/fetch', TestController::class.'@fetchRouteResponse'); $output = $this->artisan('api:generate', [ '--routePrefix' => 'api/*', ]); $generatedCollection = json_decode(file_get_contents(__DIR__.'/../public/docs/collection.json')); $generatedCollection->info->_postman_id = ''; $fixtureCollection = json_decode(file_get_contents(__DIR__.'/Fixtures/collection.json')); $this->assertEquals($generatedCollection, $fixtureCollection); } public function testCanAppendCustomHttpHeaders() { RouteFacade::get('/api/headers', TestController::class.'@checkCustomHeaders'); $output = $this->artisan('api:generate', [ '--routePrefix' => 'api/*', '--header' => [ 'Authorization: customAuthToken', 'X-Custom-Header: foobar', ], ]); $generatedMarkdown = $this->getFileContents(__DIR__.'/../public/docs/source/index.md'); $this->assertContainsRaw('"authorization": [ "customAuthToken" ], "x-custom-header": [ "foobar" ]', $generatedMarkdown); } public function testGeneratesUTF8Responses() { RouteFacade::get('/api/utf8', TestController::class.'@utf8'); $output = $this->artisan('api:generate', [ '--routePrefix' => 'api/*', ]); $generatedMarkdown = file_get_contents(__DIR__.'/../public/docs/source/index.md'); $this->assertContains('Лорем ипсум долор сит амет', $generatedMarkdown); } /** * @param string $command * @param array $parameters * * @return mixed */ public function artisan($command, $parameters = []) { $this->app[Kernel::class]->call($command, $parameters); return $this->app[Kernel::class]->output(); } private function assertFilesHaveSameContent($pathToExpected, $pathToActual) { $actual = $this->getFileContents($pathToActual); $expected = $this->getFileContents($pathToExpected); $this->assertSame($expected, $actual); } /** * Get the contents of a file in a cross-platform-compatible way. * * @param $path * * @return string */ private function getFileContents($path) { return str_replace("\r\n", "\n", file_get_contents($path)); } /** * Assert that a string contains another string, ignoring all whitespace. * * @param $needle * @param $haystack */ private function assertContainsRaw($needle, $haystack) { $haystack = preg_replace('/\s/', '', $haystack); $needle = preg_replace('/\s/', '', $needle); $this->assertContains($needle, $haystack); } }