Meltano

Снимок экрана 2022-11-22 в 20.43.30.png

Снимок экрана 2022-11-22 в 20.45.10.png

please tell me why on almost all the taps that I look at I see schemes in json format. But when I looked at Slack, there were diagrams in .py format like in the second screenshot?
What should I use?

I think it's personal preference ... I prefer external JSON files, because they are easy to generate from sample data with tools like `genson` <https://github.com/wolverdude/GenSON>

I'll add that the Python you are seeing there are using our SDK helper classes. If you are writing them by hand, these classes make the code more concise and readable vs the native JSON Schema. But the final `.to_dict()` in your example screenshot _does_ return the actual JSON Schema as a python dict.

Our ref docs in case helpful: <https://sdk.meltano.com/en/latest/typing.html#module-singer_sdk.typing|JSON Schema builder — Meltano Singer SDK 0.14.0 documentation>

But yes, to <@U06D0HF662U>’s point, it is to a large degree up to personal preference: you can maintain JSON Schema files, or as python - there's no  'wrong answer'. :slightly_smiling_face:

If migrating from an existing tap, you may _already_ have .json text files, in which case you can use those. Or if you have json schema from the upstream source, you can import that from them.

It is not entirely clear to me at what point then this scheme (in the case of sjon) is converted to the desired format?

Where can I see the syntax for building schemas in json format? For example, how to describe an array of objects or something like that

<https://json-schema.org/understanding-json-schema/reference/index.html>