Version 4 cyclic refs freezes without any error

[AndyOGo]

What did you do

I just upgraded to version 4 from verison 3 and tried to generate md files by running my NPM docs script:

npm run docs
# which executs: jsonschema2md -o docs/ -x docs/ -d schemas/ -e json

What did you expect to happen

All markdown files to be generated

What happened

The CLI programm freezes without any error.
Last log is:

loading schemas

What's your environment

• Operating System: macOS Catalina 10.15.2 (19C57)
• node.js version: v10.15.0

Do you have example files:

https://github.com/axa-ch/cyclic-schemas-test

[trieloff]

Hi Andy, the external refs shouldn't be the problem, as jsonschema2md will try to resolve them, but simply ignore them if they can't be resolved. It's hard to troubleshoot without the schema files, so some things that might establish the direction:

1. how many schema files do you have?
2. are there recursive references?

[AndyOGo]

Hi @trieloff , thank you for your quick answer.
Great, that they are ignored if they can't be resolved.

1. we have 57 schemas locally on disk
2. yes some are used recursively and we have intended cyclic references

We use our schemas to describe a generic component-tree, which may have arbitrarily nested components.

[trieloff]

Could you try to create a minimal example, just to validate the assumption that it has something to do with the recursion? e.g. three schemas that form a cycle.

[AndyOGo]

@trieloff here you go :)
https://github.com/axa-ch/cyclic-schemas-test

Please let me know if you need any more data

[trieloff]

@AndyOGo the next release should have a fix. At least a fix that works with the example you've shared.

[AndyOGo]

@trieloff sounds great, thank you very much for your quick handling.
I'm looking forward to try it with next release :)