Модуль json
JSON (JavaScript Object Notation) — простой формат обмена данными, основанный на подмножестве синтаксиса JavaScript. Модуль json позволяет кодировать и декодировать данные в удобном формате.
Кодирование основных объектов Python:
Декодирование (парсинг) JSON:
]'] json.dump(obj, fp, skipkeys=False, ensure_ascii=True, check_circular=True, allow_nan=True, cls=None, indent=None, separators=None, default=None, sort_keys=False, **kw) - сериализует obj как форматированный JSON поток в fp.
Если skipkeys = True, то ключи словаря не базового типа (str, unicode, int, long, float, bool, None) будут проигнорированы, вместо того, чтобы вызывать исключение TypeError.
Если ensure_ascii = True, все не-ASCII символы в выводе будут экранированы последовательностями \uXXXX, и результатом будет строка, содержащая только ASCII символы. Если ensure_ascii = False, строки запишутся как есть.
Если check_circular = False, то проверка циклических ссылок будет пропущена, а такие ссылки будут вызывать OverflowError.
Если allow_nan = False, при попытке сериализовать значение с запятой, выходящее за допустимые пределы, будет вызываться ValueError (nan, inf, -inf) в строгом соответствии со спецификацией JSON, вместо того, чтобы использовать эквиваленты из JavaScript (NaN, Infinity, -Infinity).
Если indent является неотрицательным числом, то массивы и объекты в JSON будут выводиться с этим уровнем отступа. Если уровень отступа 0, отрицательный или "", то вместо этого будут просто использоваться новые строки. Значение по умолчанию None отражает наиболее компактное представление. Если indent - строка, то она и будет использоваться в качестве отступа.
Если sort_keys = True, то ключи выводимого словаря будут отсортированы.
json.dumps(obj, skipkeys=False, ensure_ascii=True, check_circular=True, allow_nan=True, cls=None, indent=None, separators=None, default=None, sort_keys=False, **kw) - сериализует obj в строку JSON-формата.
Аргументы имеют то же значение, что и для dump().
Ключи в парах ключ/значение в JSON всегда являются строками. Когда словарь конвертируется в JSON, все ключи словаря преобразовываются в строки. В результате этого, если словарь сначала преобразовать в JSON, а потом обратно в словарь, то можно не получить словарь, идентичный исходному. Другими словами, loads(dumps(x)) != x, если x имеет нестроковые ключи.
json.load(fp, cls=None, object_hook=None, parse_float=None, parse_int=None, parse_constant=None, object_pairs_hook=None, **kw) - десериализует JSON из fp.
object_hook - опциональная функция, которая применяется к результату декодирования объекта (dict). Использоваться будет значение, возвращаемое этой функцией, а не полученный словарь.
object_pairs_hook - опциональная функция, которая применяется к результату декодирования объекта с определённой последовательностью пар ключ/значение. Будет использован результат, возвращаемый функцией, вместо исходного словаря. Если задан так же object_hook, то приоритет отдаётся object_pairs_hook.
parse_float, если определён, будет вызван для каждого значения JSON с плавающей точкой. По умолчанию, это эквивалентно float(num_str).
parse_int, если определён, будет вызван для строки JSON с числовым значением. По умолчанию эквивалентно int(num_str).
parse_constant, если определён, будет вызван для следующих строк: "-Infinity", "Infinity", "NaN". Может быть использовано для возбуждения исключений при обнаружении ошибочных чисел JSON.
Если не удастся десериализовать JSON, будет возбуждено исключение ValueError.
json.loads(s, encoding=None, cls=None, object_hook=None, parse_float=None, parse_int=None, parse_constant=None, object_pairs_hook=None, **kw) - десериализует s (экземпляр str, содержащий документ JSON) в объект Python.
Остальные аргументы аналогичны аргументам в load().
Кодировщики и декодировщики
Класс json.JSONDecoder(object_hook=None, parse_float=None, parse_int=None, parse_constant=None, strict=True, object_pairs_hook=None) - простой декодер JSON.
Выполняет следующие преобразования при декодировании:
JSON
Python
object
dict
array
list
string
str
number (int)
int
number (real)
float
true
True
false
False
null
None
Он также понимает NaN, Infinity, и -Infinity как соответствующие значения float, которые находятся за пределами спецификации JSON.
Класс json.JSONEncoder(skipkeys=False, ensure_ascii=True, check_circular=True, allow_nan=True, sort_keys=False, indent=None, separators=None, default=None)
Расширяемый кодировщик JSON для структур данных Python. Поддерживает следующие объекты и типы данных по умолчанию:
Python
JSON
dict
object
list, tuple
array
str
string
int, float
number
True
true
False
false
None
null
Для вставки кода на Python в комментарий заключайте его в теги
- Модуль csv - чтение и запись CSV файлов
- Создаём сайт на Django, используя хорошие практики. Часть 1: создаём проект
- Онлайн-обучение Python: сравнение популярных программ
- Книги о Python
- GUI (графический интерфейс пользователя)
- Курсы Python
- Модули
- Новости мира Python
- NumPy
- Обработка данных
- Основы программирования
- Примеры программ
- Типы данных в Python
- Видео
- Python для Web
- Работа для Python-программистов
- Сделай свой вклад в развитие сайта!
- Самоучитель Python
- Карта сайта
- Отзывы на книги по Python
- Реклама на сайте
jsonlib 1.6.1
John Millikin Copyright : This document has been placed in the public domain.
Overview
JSON is a lightweight data-interchange format. It is often used for exchanging data between a web server and user agent.
This module aims to produce a library for serializing and deserializing JSON that conforms strictly to RFC 4627.
For the Python 3 version of jsonlib, see jsonlib-python3.
Other JSON implementations of interest include simplejson (available in the standard library as of Python 2.6) and demjson.
Usage
jsonlib has two functions of interest, read and write . It also defines some exception: ReadError , WriteError , and UnknownSerializerError .
For compatibility with the standard library, read is aliased to loads and write is aliased to dumps . They do not have the same set of advanced parameters, but may be used interchangeably for simple invocations.
Deserialization
To deserialize a JSON expression, call the jsonlib.read function with an instance of unicode or bytes .
>>> import jsonlib >>> jsonlib.read (b'["Hello world!"]') [u'Hello world!']
Floating-point values
By default, jsonlib will parse values such as “1.1” into an instance of decimal.Decimal . To use the built-in value type float instead, set the use_float parameter to True . float values are much faster to construct, so this flag may substantially increase parser performance.
Please note that using float will cause a loss of precision when parsing some values.
>>> jsonlib.read ('[3.14159265358979323846]', use_float = True) [3.1415926535897931]
Serialization
Serialization has more options, but they are set to reasonable defaults. The simplest use is to call jsonlib.write with a Python value.
>>> import jsonlib >>> jsonlib.write (['Hello world!']) '["Hello world!"]'
Pretty-Printing
To “pretty-print” the output, pass a value for the indent parameter.
>>> print (jsonlib.write (['Hello world!'], indent = ' ').decode ('utf8')) [ "Hello world!" ] >>>
Mapping Key Sorting
By default, mapping keys are serialized in whatever order they are stored by Python. To force a consistent ordering (for example, in doctests) use the sort_keys parameter.
>>> jsonlib.write () '' >>> jsonlib.write (, sort_keys = True) ''
Encoding and Unicode
By default, the output is encoded in UTF-8. If you require a different encoding, pass the name of a Python codec as the encoding parameter.
>>> jsonlib.write (['Hello world!'], encoding = 'utf-16-be') '\x00[\x00"\x00H\x00e\x00l\x00l\x00o\x00 \x00w\x00o\x00r\x00l\x00d\x00!\x00"\x00]'
To retrieve an unencoded unicode instance, pass None for the encoding.
>>> jsonlib.write (['Hello world!'], encoding = None) u'["Hello world!"]'
By default, non-ASCII codepoints are forbidden in the output. To include higher codepoints in the output, set ascii_only to False .
>>> jsonlib.write ([u'Hello \u266a'], encoding = None) u'["Hello \\u266a"]' >>> jsonlib.write ([u'Hello \u266a'], encoding = None, ascii_only = False) u'["Hello \u266a"]'
Mapping Key Coercion
Because JSON objects must have string keys, an exception will be raised when non-string keys are encountered in a mapping. It can be useful to coerce mapping keys to strings, so the coerce_keys parameter is available.
>>> jsonlib.write () Traceback (most recent call last): WriteError: Only strings may be used as object keys. >>> jsonlib.write (, coerce_keys = True) ''
Serializing Other Types
If the object implements the iterator or mapping protocol, it will be handled automatically. If the object is intended for use as a basic value, it should subclass one of the supported basic values.
String-like objects that do not inherit from unicode or UserString.UserString will likely be serialized as a list. This will not be changed. If iterating them returns an instance of the same type, the serializer might crash. This (hopefully) will be changed.
To serialize a type not known to jsonlib, use the on_unknown parameter to write :
>>> from datetime import date >>> def unknown_handler (value): . if isinstance (value, date): . return str (value) . raise jsonlib.UnknownSerializerError >>> jsonlib.write ([date (2000, 1, 1)], on_unknown = unknown_handler) '["2000-01-01"]'
Streaming Serializer
When serializing large objects, the use of an in-memory buffer may cause too much memory to be used. For these situations, use the dump function to write objects to a file-like object:
>>> import sys >>> jsonlib.dump (["Written to stdout"], sys.stdout, encoding = None) ["Written to stdout"] >>> with open ("/dev/null", "wb") as out: . jsonlib.dump (["Written to a file"], out) >>>
Exceptions
ReadError
Raised by read if an error was encountered parsing the expression. Will contain the line, column, and character position of the error.
Note that this will report the character, not the byte, of the character that caused the error.
WriteError
Raised by write or dump if an error was encountered serializing the passed value.
UnknownSerializerError
A subclass of WriteError that is raised when a value cannot be serialized. See the on_unknown parameter to write .
Change Log
1.6.1
- Fixed error in write() which could cause output truncation.
1.6
- Performance improvements
- coerce_keys no longer attempts to determine the “JSON” format for a coerced value – it will simply call unicode() .
№23 Модуль JSON / Уроки по Python для начинающих
JSON является синтаксисом для хранения и обмена данными. JSON — это текст, написанный в стиле объекта JavaScript.
JSON в Python
Python имеет встроенный модуль json , который может использоваться для работы с данными JSON.
import json
Конвертация из JSON в Python
Если у вас есть строка JSON, вы можете провести над ней парсинг с помощью метода json.loads () .
Как результат, будет словарь python.
Конвертируем из JSON в Python:
import json # немного JSON: x = '' # парсинг x: y = json.loads(x) # результатом будет словарь Python: print(y["age"])
Конвертировать из Python в JSON
Если у вас есть объект Python, вы можете преобразовать его в строку JSON с помощью метода json.dumps() .
import json # создаем словарь x: x = "name": "Viktor", "age": 30, "city": "Minsk" > # конвертируем в JSON: y = json.dumps(x) # в результате получаем строк JSON: print(y)
Вы можете преобразовать следующие типов объекты Python в строки JSON:
Конвертируем объекты Python в строки JSON и выведите значения:
import json print(json.dumps("name": "Viktor", "age": 30>)) print(json.dumps(["Porsche", "BMW"])) print(json.dumps(("Porsche", "BMW"))) print(json.dumps("hello")) print(json.dumps(42)) print(json.dumps(31.76)) print(json.dumps(True)) print(json.dumps(False)) print(json.dumps(None))
["Porsche", "BMW"] ["Porsche", "BMW"] "hello" 42 31.76 true false null
Когда вы конвертируете из Python в JSON, объекты Python преобразуются в эквивалент JSON:
Python
JSON
dict
Object
list
Array
tuple
Array
str
String
int
Number
float
Number
True
true
False
false
None
null
Конвертируйте объект Python, содержащий все типы конвертируемых данных:
import json x = "name": "Viktor", "age": 30, "married": True, "divorced": False, "children": ("Anna","Bogdan"), "pets": None, "cars": [ "model": "BMW 230", "mpg": 27.5>, "model": "Ford Edge", "mpg": 24.1> ] > print(json.dumps(x))
Как конвертировать кириллицу
Если в данных Python есть символы кириллицы, метод json.dumps() преобразует их с кодировкой по умолчанию. Что бы сохранить кириллицу используйте параметр ensure_ascii=False
import json x = "name": "Виктор" > y = "name": "Виктор" > print(json.dumps(x)) print(json.dumps(y, ensure_ascii=False))
Форматирование результата
В приведенном выше примере выводится строка JSON, но читать ее не так просто, без отступов и переносов строк.
У метода json.dumps() есть параметры, облегчающие чтение результата.
Используем параметр indent для определения количества отступов:
json.dumps(x, indent=4)
Вы также можете определить разделители, значение которых по умолчанию — , , : , где запятая и пробел используются для разделения каждого объекта, а двоеточие и пробел — для разделения ключей и значений.
Используем параметр separators чтобы изменить разделитель по умолчанию:
json.dumps(x, indent=4, separators=(". ", " token punctuation">))
Упорядочивание результата
Метод json.dumps() имеет параметры для упорядочивания ключей в результате.
Используем параметр sort_keys чтобы указать, должен ли сортироваться результат.
json.dumps(x, indent=4, sort_keys=True)
Добавление объекта json python
Пожалуйста, исправьте вопрос, чтобы он отражал конкретную проблему с достаточным количеством деталей для возможности дать адекватный ответ.
29 мар 2023 в 2:42
Возможный дубликат вопроса: Создание json файла c помощью python
29 мар 2023 в 2:44
@MrP точно не дубликат того вопроса, там вопрос про соединение словарей скорее, а не про конвертацию в json.
29 мар 2023 в 6:29
с чем конкретно проблема? С открыть файл, с добавить объект, с закрыть файл?
29 мар 2023 в 10:33
"Уточняю: открыть файл, добавить объект json(так что бы другие не удалились), закрыть файл" - никак, json не поддерживает "дозапись". Только прочитать json из файла полностью, добавить в него свои данные, перезаписать данные в файле полностью.
29 мар 2023 в 16:24
2 ответа 2
Сортировка: Сброс на вариант по умолчанию
В комментариях вам верно указали, что нет возможности добавлять записи в json файл. Вы можете записывать, читать, перезаписывать, добавлять в конец файла, добавлять в определенную строку, но все что описано выше - это работа с текстовыми данными, а не с сущностями json или python.
Верный порядок действий такой:
- открыть и прочитать файл (это будет последовательность символов)
- прочитанную последовательность с помощью json модуля сделать понятным для python словарем
- Изменить нужное значение(-я) в словаре
- Преобразовать словарь в формат json (для python это будет опять последовательность символов, грубо говоря строка)
- Полностью перезаписать файл
import json # 1, 2 open with("your.json") as f: json_str = json.load(f) # 3 json_str["name"] = "new_name" # 4, 5 open with("your.json", "w") as f: json.dump(json_str, f)