apiato:apidoc command throw ProcessFailedException Error about apiato

[pedram-shariat]

apiato version : 12.0.0
Documentation container : 3.0.0
apidoc: 1.0.0

[pedram-shariat]

Windows 10
Configs folder exists in this path
But it still doesn't work

[yalsicor]

ENOENT: no such file or directory, stat 'C:\laragon\www\reemod-api\app\Containers/Vendor/Documentation/ApiDocJs/Config
s/apidoc.public.json'

This does look like a directory separator problem. When running PHP in a Unix-like OS (bare, container or the WSL), slashes will be expected as directory separators. But when running PHP directly on Windows with Laragon or XAMPP, backslashes are expected as directory separators. In this case it looks like both are mixed and Windows probably does not find the files this way. I think a refactor using PHPs DIRECTORY_SEPARATOR constant will fix this problem.

[Mohammad-Alavi]

@pedram-shariat Could you please tell your Apiato, Documentation container & ApiDocJs versions?

[Mohammad-Alavi]

@pedram-shariat What is your OS?

Try to create the Config folder at app/Containers/Vendor/Documentation/ApiDocJs/ and rerun the command.

Please tell me if this fixes your problem so I can develop a fix later. 🙏

[Anas-Nabulsi]

I'm facing same issue here

[Mohammad-Alavi]

I just released a possible fix based on @yalsicor findings but I cannot test it because I am using WSL.
@Anas-Nabulsi could you please do a composer update and see if it is fixed?
Thanks.

[Anas-Nabulsi]

@Mohammad-Alavi
Now I'm receiving the following error:
`
file_put_contents(/C:\Users\APP_PATH\app\Containers\Vendor\Documentation\ApiDocJs\Configs\apidoc.public.json): Failed to open stream: No such file or directory

at app\Containers\Vendor\Documentation\Tasks\RenderApidocJsonTask.php:85
81▕ if (!is_dir($dir) && !mkdir($dir)) {
82▕ throw new \RuntimeException(sprintf('Directory "%s" was not created', $dir));
83▕ }
84▕ }
➜ 85▕ file_put_contents("{$dir}/{$file}", $contents);
86▕ }
87▕ }
88▕

1 app\Containers\Vendor\Documentation\Tasks\RenderApidocJsonTask.php:85

2 app\Containers\Vendor\Documentation\Tasks\RenderApidocJsonTask.php:62
App\Containers\Vendor\Documentation\Tasks\RenderApidocJsonTask::fileForceContents("", "{"name":"apiato","description":"apiato (Public API) Documentation","title":"Welcome to apiato","version":"1.0.0","url":"http://api.apiato.test","sampleUrl":"http://api.apiato.test","template":{"withCompare":true,"withGenerator":true},"header":{"title":"API Overview","filename":"Containers/Vendor/Documentation/UI/WEB/Views/documentation/header.md"},"order":[]}")
`
note APP_PATH is just a placeholder for the actual app path.

There seem to be a missing file called apidoc.public.json and a missing folder called Configs.
I tried to create the folder Configs under ApiDocJs and an empty apidoc.public.json.
But when I run php artisan apiato:apidoc again the file gets deleted and I receive the same error.

[Mohammad-Alavi]

Thanks to @Anas-Nabulsi
This is fixed in v3.0.5.
Please do a composer update to get the fix.