не удается найти документацию по json.tool

Я могу найти разбросанные статьи в Интернете, которые используют json.tool для создания довольно python, но не имеют четкой документации по использованию. Я проверил docs.python. но нет официальной документации json.tool.

У меня есть несколько рабочих процессов (написанных другими людьми), которые используют json.tool для проверки json, но я также видел сообщения, которые предупреждают, что json.tool не всегда создает допустимый json. Поэтому я хочу больше узнать о том, как работает json.tool.

Может ли кто-нибудь порекомендовать где-нибудь четкую и полную документацию по json.tool?

Если вы просмотрите официальную документацию библиотеки JSON python, вы увидите, что вызов json.tool должен быть python -mjson.tool . Это указывает на то, что программа находится в файле tool.py в каталоге json вашей установки python или что она находится в файле __init__.py в каталоге tool под json в вашей установке на python.

Файл на самом деле является первым из двух, а функция main() – <20 строк кода, которые можно легко проанализировать:

  • если нет аргументов, он функционирует как труба: JSON in и JSON out
  • если есть один аргумент, который принимается как входной файл JSON, вывод в stdout
  • есть два аргумента: первый входной файл JSON, второй – выходной файл JSON

Если вы предоставите больше параметров, это фактически покажет использование:

 $ python -m json.tool abc /opt/python/2.7.11/lib/python2.7/json/tool.py [infile [outfile]] 

Это для версии 2.7. Версия 3.5.1 имеет дополнительный параметр, и там отображаются параметры, если вы используете -h :

 $ python -m json.tool -h usage: python -m json.tool [-h] [--sort-keys] [infile] [outfile] A simple command line interface for json module to validate and pretty-print JSON objects. positional arguments: infile a JSON file to be validated or pretty-printed outfile write the output of infile to outfile optional arguments: -h, --help show this help message and exit --sort-keys sort the output of dictionaries alphabetically by key