`json` --- JSON 인코더와 디코더¶

flowdas

이 페이지에서는 JSON 문서의 {} 리터럴을 가리키기 위해 "오브젝트"라는 표현을 사용하고 있습니다. "객체"는 파이썬 객체를 가리키는 데 사용합니다.

RFC 7159(RFC 4627을 대체합니다)와 ECMA-404로 규정되는 JSON (JavaScript Object Notation)은 JavaScript 객체 리터럴 문법에서 영감을 얻은 경량 데이터 교환 형식입니다 (JavaScript 1의 엄격한 부분집합은 아닙니다).

json은 표준 라이브러리 marshal과 pickle 모듈 사용자에게 익숙한 API를 제공합니다.

기본 파이썬 객체 계층 구조 인코딩:

>>> import json
>>> json.dumps(['foo', {'bar': ('baz', None, 1.0, 2)}])
'["foo", {"bar": ["baz", null, 1.0, 2]}]'
>>> print(json.dumps("\"foo\bar"))
"\"foo\bar"
>>> print(json.dumps('\u1234'))
"\u1234"
>>> print(json.dumps('\\'))
"\\"
>>> print(json.dumps({"c": 0, "b": 0, "a": 0}, sort_keys=True))
{"a": 0, "b": 0, "c": 0}
>>> from io import StringIO
>>> io = StringIO()
>>> json.dump(['streaming API'], io)
>>> io.getvalue()
'["streaming API"]'

간결한 인코딩:

>>> import json
>>> json.dumps([1, 2, 3, {'4': 5, '6': 7}], separators=(',', ':'))
'[1,2,3,{"4":5,"6":7}]'

flowdas

유니코드가 포함되었을 때, 더 간결한 출력은 json.dumps(obj, ensure_ascii=False, separators=(',', ':'))로 얻을 수 있습니다.

예쁜 인쇄:

>>> import json
>>> print(json.dumps({'4': 5, '6': 7}, sort_keys=True, indent=4))
{
    "4": 5,
    "6": 7
}

JSON 디코딩:

>>> import json
>>> json.loads('["foo", {"bar":["baz", null, 1.0, 2]}]')
['foo', {'bar': ['baz', None, 1.0, 2]}]
>>> json.loads('"\\"foo\\bar"')
'"foo\x08ar'
>>> from io import StringIO
>>> io = StringIO('["streaming API"]')
>>> json.load(io)
['streaming API']

JSON 객체 디코딩 특수화:

>>> import json
>>> def as_complex(dct):
...     if '__complex__' in dct:
...         return complex(dct['real'], dct['imag'])
...     return dct
...
>>> json.loads('{"__complex__": true, "real": 1, "imag": 2}',
...     object_hook=as_complex)
(1+2j)
>>> import decimal
>>> json.loads('1.1', parse_float=decimal.Decimal)
Decimal('1.1')

JSONEncoder 확장하기:

>>> import json
>>> class ComplexEncoder(json.JSONEncoder):
...     def default(self, obj):
...         if isinstance(obj, complex):
...             return [obj.real, obj.imag]
...         # 베이스 클래스의 default 메서드가 TypeError를 발생 시키도록 합니다
...         return json.JSONEncoder.default(self, obj)
...
>>> json.dumps(2 + 1j, cls=ComplexEncoder)
'[2.0, 1.0]'
>>> ComplexEncoder().encode(2 + 1j)
'[2.0, 1.0]'
>>> list(ComplexEncoder().iterencode(2 + 1j))
['[2.0', ', 1.0', ']']

셸에서 json.tool을 사용하여 유효성을 검사하고 예쁘게 인쇄합니다:

$ echo '{"json":"obj"}' | python -m json.tool
{
    "json": "obj"
}
$ echo '{1.2:3.4}' | python -m json.tool
Expecting property name enclosed in double quotes: line 1 column 2 (char 1)

자세한 설명은 명령 줄 인터페이스를 참조하십시오.

참고

JSON은 YAML 1.2의 부분 집합입니다. 이 모듈의 기본 설정(특히 기본 separators 값)으로 생성된 JSON은 YAML 1.0과 1.1의 부분 집합이기도 합니다. 따라서 이 모듈을 YAML 직렬화기로 사용할 수도 있습니다.

참고

이 모듈의 인코더와 디코더는 기본적으로 입력과 출력 순서를 유지합니다. 하부 컨테이너에 순서가 없을 때만 순서가 손실됩니다.

파이썬 3.7 이전에는, dict의 순서가 보장되지 않아서, collections.OrderedDict가 특별히 요청되지 않는 한 입력과 출력은 일반적으로 뒤섞였습니다. 파이썬 3.7부터, 일반 dict가 순서를 보존하기 때문에, 더는 JSON 생성과 구문 분석을 위해 collections.OrderedDict를 지정할 필요가 없습니다.

기본 사용법¶

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(.write()를 지원하는 파일류 객체)로 직렬화합니다.

skipkeys가 참이면 (기본값: False), 기본형(str, int, float, bool, None)이 아닌 딕셔너리 키는 TypeError를 발생시키는 대신 건너뜁니다.

json 모듈은 항상 bytes 객체가 아니라 str 객체를 생성합니다. 따라서, fp.write()는 str 입력을 지원해야 합니다.

ensure_ascii가 참(기본값)이면, 출력에서 모든 비 ASCII 문자가 이스케이프 되도록 보장됩니다. ensure_ascii가 거짓이면, 그 문자들은 있는 그대로 출력됩니다.

check_circular가 거짓이면 (기본값: True), 컨테이너형에 대한 순환 참조 검사를 건너뛰고 순환 참조는 OverflowError를 일으킵니다 (또는 더 나빠질 수 있습니다).

allow_nan이 거짓이면 (기본값: True), JSON 사양을 엄격히 준수하여 범위를 벗어난 float 값(nan, inf, -inf)을 직렬화하면 ValueError를 일으킵니다. allow_nan이 참이면, JavaScript의 대응 물(NaN, Infinity, -Infinity)이 사용됩니다.

indent가 음이 아닌 정수나 문자열이면, JSON 배열 요소와 오브젝트 멤버가 해당 들여쓰기 수준으로 예쁘게 인쇄됩니다. 0, 음수 또는 ""의 들여쓰기 수준은 줄 넘김만 삽입합니다. None(기본값)은 가장 간결한(compact) 표현을 선택합니다. 양의 정수 indent를 사용하면, 수준 당 그만큼의 스페이스로 들여쓰기합니다. indent가 문자열이면 (가령 "\t"), 각 수준을 들려 쓰는 데 그 문자열을 사용합니다.

버전 3.2에서 변경: indent에 정수뿐만 아니라 문자열을 허용합니다.

지정되면, separators는 (item_separator, key_separator) 튜플이어야 합니다. 기본값은 indent가 None이면 (', ', ': ')이고, 그렇지 않으면 (',', ': ')입니다. 가장 간결한 JSON 표현을 얻으려면, (',', ':')를 지정하여 공백을 제거해야 합니다.

버전 3.4에서 변경: indent가 None이 아니면, (',', ': ')를 기본값으로 사용합니다.

지정되면, default는 달리 직렬화할 수 없는 객체에 대해 호출되는 함수여야 합니다. 객체의 JSON 인코딩 가능한 버전을 반환하거나 TypeError를 발생시켜야 합니다. 지정하지 않으면, TypeError가 발생합니다.

sort_keys가 참이면 (기본값: False), 딕셔너리의 출력이 키로 정렬됩니다.

사용자 정의 JSONEncoder 서브 클래스(예를 들어, default() 메서드를 재정의하여 추가 형을 직렬화하는 것)를 사용하려면, cls 키워드 인자로 지정하십시오; 그렇지 않으면 JSONEncoder가 사용됩니다.

버전 3.6에서 변경: 모든 선택적 매개 변수는 이제 키워드-전용입니다.

참고

pickle과 marshal과 달리, JSON은 프레임 프로토콜이 아니므로 같은 fp를 사용하여 dump()를 반복 호출하여 여러 객체를 직렬화하려고 하면 잘못된 JSON 파일이 생성됩니다.

flowdas

프레임 프로토콜이 아니라는 말은, 각 JSON을 구분할 수 있는 구분자나, 각 JSON을 둘러싸는 프레임이 정의되지 않았다는 뜻입니다. 그래서 여러 개의 JSON을 이어붙이면 더는 올바른 JSON이 아니게 됩니다.

하지만 여러 JSON을 이어붙이는 방법은 실제로 많이 사용됩니다. 가령 JSON을 들여쓰기 없이 간결하게 만든 다음 끝에 줄 넘김을 추가해서 각 JSON을 구분합니다. 이런 형식은 구조화된 로그에 많이 사용되고 있고, Pandas에는 아예 이런 형식의 파일을 읽어 들이는 함수가 있기도 합니다.

flowdas

JavaScript는 int와 float를 구분하지 않고 모두 부동 소수점으로 표현합니다. 이 때문에 JSON에도 단지 숫자 형만 있습니다. 64비트 배정도 부동 소수점을 사용하는 시스템에서, 손실 없이 저장될 수 있는 정수의 범위는 [-(2**53)+1, (2**53)-1] 입니다. 이 범위를 벗어나는 정수를 JSON으로 인코딩하면, 그 JSON을 사용하는 플랫폼(가령 브라우저)에 따라 다른 값으로 인식될 수 있습니다.

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 형식의 str로 직렬화합니다. 인자는 dump()에서와 같은 의미입니다.

참고

JSON의 키/값 쌍에 있는 키는 항상 str 형입니다. 딕셔너리를 JSON으로 변환하면, 딕셔너리의 모든 키가 문자열로 강제 변환됩니다. 이것의 결과로, 딕셔너리를 JSON으로 변환한 다음 다시 딕셔너리로 변환하면, 딕셔너리가 원래의 것과 같지 않을 수 있습니다. 즉, x에 비 문자열 키가 있으면 loads(dumps(x)) != x입니다.

flowdas

str로 변환할 수 있는 모든 키가 허용되는 것은 아닙니다. dump()가 허용하는 딕셔너리의 키는 str, int, float, bool, None 뿐입니다. bytes, tuple, decimal.Decimal 등은 TypeError를 일으킵니다. 이 과정은 값을 처리하는 과정과는 달리, default 인자를 사용하지 않습니다. 따라서 이 동작을 바꾸려면 JSONEncoder.iterencode()를 재정의해야 합니다.

float가 키로 사용되면 allow_nan 인자의 영향을 받습니다.

이 변환에 의존하는 것은 별로 현명한 선택이 아닙니다. 키를 직접 문자열로 사전에 변환하는 것이 좋습니다.

json.load(fp, *, cls=None, object_hook=None, parse_float=None, parse_int=None, parse_constant=None, object_pairs_hook=None, **kw)¶

이 변환표를 사용하여 fp(JSON 문서를 포함하는 .read()를 지원하는 텍스트 파일이나 바이너리 파일)를 파이썬 객체로 역 직렬화합니다.

object_hook은 모든 오브젝트 리터럴의 디코딩된 결과(dict)로 호출되는 선택적 함수입니다. object_hook의 반환 값이 dict 대신에 사용됩니다. 이 기능은 사용자 정의 디코더를 구현하는 데 사용할 수 있습니다 (예를 들어, JSON-RPC 클래스 힌팅(class hinting)).

flowdas

JSON-RPC 1.0에 포함된 클래스 힌팅은 확장형을 지원하기 위한 규격으로 JSON-RPC 2.0에서는 제거되었습니다. JSON 오브젝트를 다음과 같은 형식으로 전달합니다:

{"__jsonclass__":["constructor", [param1,...]], "prop1": ...}

object_hook은 이런 형태의 딕셔너리를 constructor가 가리키는 클래스의 인스턴스로 변환할 수 있습니다.

object_pairs_hook은 모든 오브젝트 리터럴의 쌍의 순서 있는 목록으로 디코딩된 결과로 호출되는 선택적 함수입니다. dict 대신 object_pairs_hook의 반환 값이 사용됩니다. 이 기능은 사용자 정의 디코더를 구현하는 데 사용할 수 있습니다. object_hook도 정의되어 있으면, object_pairs_hook이 우선순위를 갖습니다.

버전 3.1에서 변경: object_pairs_hook에 대한 지원이 추가되었습니다.

parse_float가 지정되면, 디코딩될 모든 JSON float의 문자열로 호출됩니다. 기본적으로, 이것은 float(num_str)와 동등합니다. JSON float에 대해 다른 데이터형이나 구문 분석기를 사용하고자 할 때 사용될 수 있습니다 (예를 들어, decimal.Decimal).

parse_int가 지정되면, 디코딩될 모든 JSON int의 문자열로 호출됩니다. 기본적으로 이것은 int(num_str)와 동등합니다. JSON 정수에 대해 다른 데이터형이나 구문 분석기를 사용하고자 할 때 사용될 수 있습니다 (예를 들어 float).

parse_constant가 지정되면, 다음과 같은 문자열 중 하나로 호출됩니다: '-Infinity', 'Infinity', 'NaN'. 잘못된 JSON 숫자를 만날 때 예외를 발생시키는 데 사용할 수 있습니다.

버전 3.1에서 변경: parse_constant는 더는 'null', 'true', 'false'에 대해 호출되지 않습니다.

사용자 정의 JSONDecoder 서브 클래스를 사용하려면, cls 키워드 인자로 지정하십시오; 그렇지 않으면 JSONDecoder가 사용됩니다. 추가 키워드 인자는 클래스 생성자에 전달됩니다.

역 직렬화되는 데이터가 유효한 JSON 문서가 아니면, JSONDecodeError가 발생합니다.

버전 3.6에서 변경: 모든 선택적 매개 변수는 이제 키워드-전용입니다.

버전 3.6에서 변경: fp는 이제 바이너리 파일이 될 수 있습니다. 입력 인코딩은 UTF-8, UTF-16 또는 UTF-32 여야 합니다.

json.loads(s, *, cls=None, object_hook=None, parse_float=None, parse_int=None, parse_constant=None, object_pairs_hook=None, **kw)¶

이 변환표를 사용하여 s(JSON 문서를 포함하는 str, bytes 또는 bytearray 인스턴스)를 파이썬 객체로 역 직렬화합니다.

다른 인자는 load()와 같은 의미를 가집니다.

역 직렬화되는 데이터가 유효한 JSON 문서가 아니면, JSONDecodeError가 발생합니다.

버전 3.6에서 변경: s는 이제 bytes나 bytearray 형일 수 있습니다. 입력 인코딩은 UTF-8, UTF-16 또는 UTF-32 여야 합니다.

버전 3.9에서 변경: 키워드 인자 encoding이 제거되었습니다.

인코더와 디코더¶

class json.JSONDecoder(*, object_hook=None, parse_float=None, parse_int=None, parse_constant=None, strict=True, object_pairs_hook=None)¶

간단한 JSON 디코더.

기본적으로 디코딩할 때 다음과 같은 변환을 수행합니다:

JSON	파이썬
오브젝트(object)	dict
배열(array)	list
문자열(string)	str
숫자 (정수)	int
숫자 (실수)	float
true	True
false	False
null	None

또한, NaN, Infinity 및 -Infinity를 해당 float 값으로 이해합니다. 이 값은 JSON 명세에 속하지 않습니다.

object_hook이 지정되면, 모든 JSON 오브젝트의 디코딩된 결과로 호출되며, 반환 값을 주어진 dict 대신 사용합니다. 사용자 정의 역 직렬화를 제공하는 데 사용할 수 있습니다 (예를 들어, JSON-RPC 클래스 힌팅을 지원하기 위해).

object_pairs_hook이 지정되면 모든 오브젝트 리터럴의 쌍의 순서 있는 목록으로 디코딩된 결과로 호출됩니다. dict 대신 object_pairs_hook의 반환 값이 사용됩니다. 이 기능은 사용자 정의 디코더를 구현하는 데 사용할 수 있습니다. object_hook도 정의되어 있으면, object_pairs_hook이 우선순위를 갖습니다.

버전 3.1에서 변경: object_pairs_hook에 대한 지원이 추가되었습니다.

parse_float가 지정되면, 디코딩될 모든 JSON float의 문자열로 호출됩니다. 기본적으로, 이것은 float(num_str)와 동등합니다. JSON float에 대해 다른 데이터형이나 구문 분석기를 사용하고자 할 때 사용될 수 있습니다 (예를 들어, decimal.Decimal).

parse_int가 지정되면, 디코딩될 모든 JSON int의 문자열로 호출됩니다. 기본적으로 이것은 int(num_str)와 동등합니다. JSON 정수에 대해 다른 데이터형이나 구문 분석기를 사용하고자 할 때 사용될 수 있습니다 (예를 들어 float).

parse_constant가 지정되면, 다음과 같은 문자열 중 하나로 호출됩니다: '-Infinity', 'Infinity', 'NaN'. 잘못된 JSON 숫자를 만날 때 예외를 발생시키는 데 사용할 수 있습니다.

strict가 거짓이면 (True가 기본값입니다), 문자열 안에 제어 문자가 허용됩니다. 이 문맥에서 제어 문자는 0--31 범위의 문자 코드를 가진 것들인데, '\t' (탭), '\n', '\r' 및 '\0'을 포함합니다.

역 직렬화되는 데이터가 유효한 JSON 문서가 아니면, JSONDecodeError가 발생합니다.

버전 3.6에서 변경: 모든 매개 변수가 이제 키워드-전용입니다.

decode(s)¶

s(JSON 문서가 포함된 str 인스턴스)의 파이썬 표현을 반환합니다.

주어진 JSON 문서가 유효하지 않으면 JSONDecodeError가 발생합니다.

raw_decode(s)¶

s(JSON 문서로 시작하는 str)에서 JSON 문서를 디코딩하고, 파이썬 표현과 문서가 끝난 s에서의 인덱스로 구성된 2-튜플을 반환합니다.

끝에 여분의 데이터가 있을 수 있는 문자열에서 JSON 문서를 디코딩하는 데 사용할 수 있습니다.

class json.JSONEncoder(*, skipkeys=False, ensure_ascii=True, check_circular=True, allow_nan=True, sort_keys=False, indent=None, separators=None, default=None)¶

파이썬 데이터 구조를 위한 확장 가능한 JSON 인코더

기본적으로 다음 객체와 형을 지원합니다.:

파이썬	JSON
dict	오브젝트(object)
list, tuple	배열(array)
str	문자열(string)
int, float, int와 float에서 파생된 열거형	숫자(number)
True	true
False	false
None	null

버전 3.4에서 변경: int와 float 파생 Enum 클래스에 대한 지원이 추가되었습니다.

다른 객체를 인식하도록 확장하려면, 서브 클래스를 만들고, 가능하면 o에 대한 직렬화 가능 객체를 반환하고, 그렇지 않으면 (TypeError를 발생시키기 위해) 슈퍼 클래스 구현을 호출하는 다른 메서드로 default() 메서드를 구현합니다.

skipkeys가 거짓(기본값)이면, str, int, float 또는 None이 아닌 키를 인코딩하려고 시도할 때 TypeError가 발생합니다. skipkeys가 참이면 이러한 항목은 단순히 건너뜁니다.

ensure_ascii가 참(기본값)이면, 출력에서 모든 비 ASCII 문자가 이스케이프 되도록 보장됩니다. ensure_ascii가 거짓이면, 그 문자들은 있는 그대로 출력됩니다.

check_circular가 참(기본값)이면, 리스트, 딕셔너리 및 사용자 정의 객체는 무한 재귀 (OverflowError를 유발할 수 있습니다)를 방지하기 위해 인코딩 중에 순환 참조를 검사합니다. 그렇지 않으면, 그러한 검사가 수행되지 않습니다.

allow_nan이 참(기본값)이면, NaN, Infinity 및 -Infinity는 그 자체로 인코딩됩니다. 이 동작은 JSON 사양을 따르지 않지만, 대부분의 JavaScript 기반 인코더 및 디코더와 일치합니다. 그렇지 않으면, 그러한 float를 인코딩하는 것은 ValueError가 됩니다.

sort_keys가 참(기본값: False)이면, 딕셔너리의 출력이 키로 정렬됩니다; JSON 직렬화를 이전과 비교할 수 있도록 해서 회귀 테스트에 유용합니다.

indent가 음이 아닌 정수나 문자열이면, JSON 배열 요소와 오브젝트 멤버가 해당 들여쓰기 수준으로 예쁘게 인쇄됩니다. 0, 음수 또는 ""의 들여쓰기 수준은 줄 넘김만 삽입합니다. None(기본값)은 가장 간결한(compact) 표현을 선택합니다. 양의 정수 indent를 사용하면, 수준 당 그만큼의 스페이스로 들여쓰기합니다. indent가 문자열이면 (가령 "\t"), 각 수준을 들려 쓰는 데 그 문자열을 사용합니다.

버전 3.2에서 변경: indent에 정수뿐만 아니라 문자열을 허용합니다.

지정되면, separators는 (item_separator, key_separator) 튜플이어야 합니다. 기본값은 indent가 None이면 (', ', ': ')이고, 그렇지 않으면 (',', ': ')입니다. 가장 간결한 JSON 표현을 얻으려면, (',', ':')를 지정하여 공백을 제거해야 합니다.

버전 3.4에서 변경: indent가 None이 아니면, (',', ': ')를 기본값으로 사용합니다.

지정되면, default는 달리 직렬화할 수 없는 객체에 대해 호출되는 함수여야 합니다. 객체의 JSON 인코딩 가능한 버전을 반환하거나 TypeError를 발생시켜야 합니다. 지정하지 않으면, TypeError가 발생합니다.

버전 3.6에서 변경: 모든 매개 변수가 이제 키워드-전용입니다.

default(o)¶

o의 직렬화 가능 객체를 반환하거나 (TypeError를 발생시키기 위해서) 베이스 구현을 호출하도록 서브 클래스에 이 메서드를 구현하십시오.

예를 들어, 임의의 이터레이터를 지원하려면, 다음과 같이 default()를 구현할 수 있습니다:

def default(self, o):
   try:
       iterable = iter(o)
   except TypeError:
       pass
   else:
       return list(iterable)
   # 베이스 클래스의 default 메서드가 TypeError를 발생시키도록 합시다
   return json.JSONEncoder.default(self, o)

encode(o)¶

파이썬 데이터 구조 o의 JSON 문자열 표현을 반환합니다. 예를 들면:

>>> json.JSONEncoder().encode({"foo": ["bar", "baz"]})
'{"foo": ["bar", "baz"]}'

iterencode(o)¶

주어진 객체 o를 인코딩하고, 준비될 때마다 각 문자열 표현을 산출(yield)합니다. 예를 들면:

for chunk in json.JSONEncoder().iterencode(bigobject):
    mysocket.write(chunk)

예외¶

exception json.JSONDecodeError(msg, doc, pos)¶

다음 추가 어트리뷰트가 있는 ValueError의 서브 클래스:

msg¶: 형식 없는 에러 메시지.

doc¶: 구문 분석 중인 JSON 문서.

pos¶: 구문 분석에 실패한 위치의 시작 부분을 나타내는 doc의 인덱스.

lineno¶: pos에 해당하는 줄.

colno¶: pos에 해당하는 열.

버전 3.5에 추가.

표준 준수와 상호 운용성¶

JSON 형식은 RFC 7159와 ECMA-404에 의해 지정됩니다. 이 절에서는 이 모듈의 RFC 준수 수준에 대해 자세히 설명합니다. 단순화를 위해, JSONEncoder 및 JSONDecoder 서브 클래스와 명시적으로 언급되지 않은 매개 변수는 고려되지 않습니다.

유효한 JavaScript이지만 유효한 JSON이 아닌 확장을 구현함으로써, 이 모듈은 엄격한 방식으로 RFC를 준수하지는 않습니다. 특히:

무한대와 NaN 숫자 값이 받아들여지고 출력됩니다;
오브젝트 내에서 반복되는 이름이 허용되고, 마지막 이름-값 쌍의 값만 사용됩니다.

RFC가 RFC를 준수하는 구문 분석기가 RFC를 준수하지 않는 입력 텍스트를 받아들이도록 허용하기 때문에, 이 모듈의 역 직렬화기는 기본 설정에서 기술적으로 RFC를 준수합니다.

flowdas

앞에 나열한 표준 위반 사례들로는, 엄밀한 의미에서도 JSONDecoder가 표준을 위반한다고 말할 수 없다는 뜻입니다.

문자 인코딩¶

RFC는 UTF-8, UTF-16 또는 UTF-32를 사용하여 JSON을 표현할 것을 요구하고, 최대 상호 운용성을 위해 권장되는 기본값은 UTF-8입니다.

RFC에 의해 요구되는 것은 아니지만 허용되기 때문에, 이 모듈의 직렬화기는 기본적으로 ensure_ascii=True를 설정하므로, 결과 문자열에 ASCII 문자만 포함되도록 출력을 이스케이핑 합니다.

ensure_ascii 매개 변수 외에도, 이 모듈은 파이썬 객체와 유니코드 문자열 사이의 변환으로 엄격하게 정의되어 있으므로, 문자 인코딩 문제를 직접 다루지 않습니다.

RFC는 JSON 텍스트의 시작 부분에 바이트 순서 표시(BOM)를 추가하는 것을 금지하고 있으며, 이 모듈의 직렬화기는 BOM을 출력에 추가하지 않습니다. RFC는 JSON 역 직렬화기가 입력에서 초기 BOM을 무시하는 것을 허용하지만 요구하지는 않습니다. 이 모듈의 역 직렬화기는 초기 BOM이 있을 때 ValueError를 발생시킵니다.

RFC는 유효한 유니코드 문자에 해당하지 않는 바이트 시퀀스(예를 들어, 쌍을 이루지 않은 UTF-16 대리 코드(unpaired UTF-16 surrogates))가 포함된 JSON 문자열을 명시적으로 금지하지 않지만, 상호 운용성 문제를 일으킬 수 있다고 지적하고 있습니다. 기본적으로, 이 모듈은 이러한 시퀀스의 코드 포인트를 받아들이고 (원래 str에 있을 때) 출력합니다.

무한대와 NaN 숫자 값¶

RFC는 무한대나 NaN 숫자 값의 표현을 허용하지 않습니다. 그런데도, 기본적으로, 이 모듈은 유효한 JSON 숫자 리터럴 값인 것처럼 Infinity, -Infinity 및 NaN을 받아들이고 출력합니다:

>>> # 이 호출 중 어느 것도 예외를 발생시키지 않지만, 결과는 유효한 JSON이 아닙니다
>>> json.dumps(float('-inf'))
'-Infinity'
>>> json.dumps(float('nan'))
'NaN'
>>> # 역 직렬화 때도 마찬가지입니다
>>> json.loads('-Infinity')
-inf
>>> json.loads('NaN')
nan

직렬화기에서, allow_nan 매개 변수를 사용하여 이 동작을 변경할 수 있습니다. 역 직렬화기에서, parse_constant 매개 변수를 사용하여 이 동작을 변경할 수 있습니다.

오브젝트 내에서 반복된 이름¶

RFC는 JSON 오브젝트 내에서 이름이 고유해야 한다고 지정하지만, JSON 오브젝트 내에서 반복되는 이름을 처리하는 방법을 지정하지는 않습니다. 기본적으로, 이 모듈은 예외를 발생시키지 않습니다; 대신, 주어진 이름에 대한 마지막 이름-값 쌍을 제외한 모든 것을 무시합니다:

>>> weird_json = '{"x": 1, "x": 2, "x": 3}'
>>> json.loads(weird_json)
{'x': 3}

object_pairs_hook 매개 변수는 이 동작을 변경하는 데 사용할 수 있습니다.

오브젝트나 배열이 아닌 최상윗값¶

폐지된 RFC 4627에 의해 지정된 이전 버전의 JSON은 JSON 텍스트의 최상윗값이 JSON 오브젝트나 배열(파이썬 dict나 list)이어야 하고, JSON null, 불리언, 숫자 또는 문자열 값이 될 수 없다고 요구합니다. RFC 7159는 그 제한을 제거했으며, 이 모듈은 직렬화기와 역 직렬화기에서 이러한 제한을 구현하지 않으며, 그런 적도 없습니다.

이와 관계없이, 최대한의 상호 운용성을 위해, 여러분은 자발적으로 제한을 준수하기를 원할 수 있습니다.

구현 제약 사항¶

일부 JSON 역 직렬화기 구현은 다음과 같은 것들에 대한 제한을 설정할 수 있습니다:

받아들인 JSON 텍스트의 크기
JSON 오브젝트와 배열의 최대 중첩 수준
JSON 숫자의 범위와 정밀도
JSON 문자열의 내용과 최대 길이

이 모듈은 관련 파이썬 데이터형 자체나 파이썬 인터프리터 자체의 한계 외에는 어떤 제한도 가하지 않습니다.

JSON으로 직렬화할 때, 여러분의 JSON을 사용할 응용 프로그램에 있는 이러한 제한 사항에 주의하십시오. 특히, JSON 숫자가 IEEE 754 배정도 숫자로 역 직렬화되는 것이 일반적이고, 그래서 그 표현의 범위와 정밀도 제한이 적용됩니다. 이것은 매우 큰 규모의 파이썬 int 값을 직렬화하거나, decimal.Decimal과 같은 "색다른" 숫자 형의 인스턴스를 직렬화할 때 특히 중요합니다.

명령 줄 인터페이스¶

소스 코드: Lib/json/tool.py

json.tool 모듈은 JSON 객체의 유효성을 검사하고 예쁘게 인쇄하는 간단한 명령 줄 인터페이스를 제공합니다.

선택적 infile과 outfile 인자가 지정되지 않으면, 각각 sys.stdin과 sys.stdout이 사용됩니다:

$ echo '{"json": "obj"}' | python -m json.tool
{
    "json": "obj"
}
$ echo '{1.2:3.4}' | python -m json.tool
Expecting property name enclosed in double quotes: line 1 column 2 (char 1)

버전 3.5에서 변경: 출력은 이제 입력과 같은 순서입니다. 딕셔너리의 출력을 키에 대해 알파벳 순으로 정렬하려면 --sort-keys 옵션을 사용하십시오.

명령 줄 옵션¶

infile¶

유효성을 검사하거나 예쁘게 인쇄할 JSON 파일:

$ python -m json.tool mp_films.json
[
    {
        "title": "And Now for Something Completely Different",
        "year": 1971
    },
    {
        "title": "Monty Python and the Holy Grail",
        "year": 1975
    }
]

infile이 지정되지 않으면, sys.stdin에서 읽습니다.

outfile¶: infile의 출력을 지정된 outfile에 씁니다. 그렇지 않으면, sys.stdout에 씁니다.

--sort-keys¶: 딕셔너리의 출력을 키에 대해 알파벳 순으로 정렬합니다.

버전 3.5에 추가.

--no-ensure-ascii¶: 비 ASCII 문자의 이스케이프를 비활성화합니다. 자세한 내용은 json.dumps()를 참조하십시오.

버전 3.9에 추가.

--json-lines¶: 모든 입력 행을 별도의 JSON 객체로 구문 분석합니다.

버전 3.8에 추가.

--indent, --tab, --no-indent, --compact¶: 공백 제어를 위한 상호 배타적 옵션.

버전 3.9에 추가.

-h, --help¶: 도움말 메시지를 표시합니다.

각주

1: the errata for RFC 7159에서 언급했듯이, JSON은 문자열에 U+2028(LINE SEPARATOR)과 U+2029(PARAGRAPH SEPARATOR) 문자를 허용하지만, JavaScript(ECMAScript Edition 5.1 기준)는 허용하지 않습니다.

`json` --- JSON 인코더와 디코더¶

기본 사용법¶

인코더와 디코더¶

예외¶

표준 준수와 상호 운용성¶

문자 인코딩¶

무한대와 NaN 숫자 값¶

오브젝트 내에서 반복된 이름¶

오브젝트나 배열이 아닌 최상윗값¶

구현 제약 사항¶

명령 줄 인터페이스¶

명령 줄 옵션¶

목차

이전 항목

다음 항목

json --- JSON 인코더와 디코더¶

기본 사용법¶

인코더와 디코더¶

예외¶

표준 준수와 상호 운용성¶

문자 인코딩¶

무한대와 NaN 숫자 값¶

오브젝트 내에서 반복된 이름¶

오브젝트나 배열이 아닌 최상윗값¶

구현 제약 사항¶

명령 줄 인터페이스¶

명령 줄 옵션¶

`json` --- JSON 인코더와 디코더¶