Fix minor issue with CLI.md automatic doc generation

[0xalexbel]

• Sometimes (randomly) the CLI.md Command paragraph is not correct. After a bit of inquiry, I finally realised that the console.log(JSON.stringify(...)) call in finalizeCli was incomplete, the output string was truncated thus resulting in a later JSON parse error. This was mainly due to console.log not having enough time to flush before process.exit(0)

• Little improvement, fix init and info entries.

Hope it helps!

[PierreJeanjacquot]

Hi, thank you for catching this, can you confirm this issue occurs on Windows as stated in node doc https://nodejs.org/api/process.html#a-note-on-process-io ?

[0xalexbel]

Hi Pierre, unfortunately I am not able to run the sdk on Windows (I'm a Mac user). Before submitting the PR, I carefully checked the same nodejs doc link, and curiously:

• ✅ GENERATE_DOC=1 node src/cli/cmd/iexec-app.js | jq . : works fine (POSIX + pipe)
• ❌ npm run generate-cli-doc : fails (the app cmd paragraph is empty, the JSON was truncated)

I was not a great fan of the sleep solution I submitted to you, it looks more like a quick and dirty patch to me. One possible alternative could be:

In function

iexec-sdk/src/cli/utils/cli-helper.js

Line 22 in e3fca85

export const finalizeCli = (cli) => {

If : process.exit(0) is replaced by a return statement:

• ✅ npm run generate-cli-doc : succeeds (the app cmd paragraph is OK)

This may let node finish its internal stuff before exiting (including a proper buffer flush). Obviously, this solution also depends on what's going on after the finalizeCli function has exited (didn't checked).

Hope it helps!