From e9fed01d150d3aced5505915dae994736cb776f2 Mon Sep 17 00:00:00 2001 From: Jane Gao Date: Mon, 22 May 2017 13:42:58 -0700 Subject: [PATCH 1/3] Add addtional examples for json normalization --- doc/source/io.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/doc/source/io.rst b/doc/source/io.rst index 9692766505d7a..1b8b57f246e8d 100644 --- a/doc/source/io.rst +++ b/doc/source/io.rst @@ -1991,6 +1991,18 @@ Normalization pandas provides a utility function to take a dict or list of dicts and *normalize* this semi-structured data into a flat table. +.. ipython:: python + + from pandas.io.json import json_normalize + data = [ + {'id': 1, 'name': {'first': 'Coleen', 'last': 'Volk'}}, + {'name': {'given': 'Mose', 'family': 'Regner'}}, + {'id': 2, 'name': 'Faye Raker'} + ] + json_normalize(data) + +.. _io.jsonl: + .. ipython:: python from pandas.io.json import json_normalize From c85a31837609bc0cd0833784892771f9e057c302 Mon Sep 17 00:00:00 2001 From: Jane Gao Date: Mon, 22 May 2017 13:46:52 -0700 Subject: [PATCH 2/3] Add addtional examples for json normalization --- pandas/io/json/normalize.py | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/pandas/io/json/normalize.py b/pandas/io/json/normalize.py index 401d8d9ead2b8..509d982ae5fa8 100644 --- a/pandas/io/json/normalize.py +++ b/pandas/io/json/normalize.py @@ -135,6 +135,19 @@ def json_normalize(data, record_path=None, meta=None, Examples -------- + >>> from pandas.io.json import json_normalize + >>> data = [ + ... {'id': 1, 'name': {'first': 'Coleen', 'last': 'Volk'}}, + ... {'name': {'given': 'Mose', 'family': 'Regner'}}, + ... {'id': 2, 'name': 'Faye Raker'} + ... ] + >>> json_normalize(data) + id name name.family name.first name.given name.last + 0 1.0 NaN NaN Coleen NaN Volk + 1 NaN NaN Regner NaN Mose NaN + 2 2.0 Faye Raker NaN NaN NaN NaN + + >>> from pandas.io.json import json_normalize >>> data = [{'state': 'Florida', ... 'shortname': 'FL', ... 'info': { @@ -150,7 +163,6 @@ def json_normalize(data, record_path=None, meta=None, ... }, ... 'counties': [{'name': 'Summit', 'population': 1234}, ... {'name': 'Cuyahoga', 'population': 1337}]}] - >>> from pandas.io.json import json_normalize >>> result = json_normalize(data, 'counties', ['state', 'shortname', ... ['info', 'governor']]) >>> result From c25252ff7caa4a453e7c5292ae694bf8f3c85ef7 Mon Sep 17 00:00:00 2001 From: Joris Van den Bossche Date: Fri, 18 Aug 2017 17:24:20 +0200 Subject: [PATCH 3/3] remove duplicate imports and link anchor --- doc/source/io.rst | 11 +++-------- pandas/io/json/normalize.py | 9 +++------ 2 files changed, 6 insertions(+), 14 deletions(-) diff --git a/doc/source/io.rst b/doc/source/io.rst index 1b8b57f246e8d..3c256a4236f9f 100644 --- a/doc/source/io.rst +++ b/doc/source/io.rst @@ -1994,18 +1994,13 @@ into a flat table. .. ipython:: python from pandas.io.json import json_normalize - data = [ - {'id': 1, 'name': {'first': 'Coleen', 'last': 'Volk'}}, - {'name': {'given': 'Mose', 'family': 'Regner'}}, - {'id': 2, 'name': 'Faye Raker'} - ] + data = [{'id': 1, 'name': {'first': 'Coleen', 'last': 'Volk'}}, + {'name': {'given': 'Mose', 'family': 'Regner'}}, + {'id': 2, 'name': 'Faye Raker'}] json_normalize(data) -.. _io.jsonl: - .. ipython:: python - from pandas.io.json import json_normalize data = [{'state': 'Florida', 'shortname': 'FL', 'info': { diff --git a/pandas/io/json/normalize.py b/pandas/io/json/normalize.py index 509d982ae5fa8..72776ed01de15 100644 --- a/pandas/io/json/normalize.py +++ b/pandas/io/json/normalize.py @@ -136,18 +136,15 @@ def json_normalize(data, record_path=None, meta=None, -------- >>> from pandas.io.json import json_normalize - >>> data = [ - ... {'id': 1, 'name': {'first': 'Coleen', 'last': 'Volk'}}, - ... {'name': {'given': 'Mose', 'family': 'Regner'}}, - ... {'id': 2, 'name': 'Faye Raker'} - ... ] + >>> data = [{'id': 1, 'name': {'first': 'Coleen', 'last': 'Volk'}}, + ... {'name': {'given': 'Mose', 'family': 'Regner'}}, + ... {'id': 2, 'name': 'Faye Raker'}] >>> json_normalize(data) id name name.family name.first name.given name.last 0 1.0 NaN NaN Coleen NaN Volk 1 NaN NaN Regner NaN Mose NaN 2 2.0 Faye Raker NaN NaN NaN NaN - >>> from pandas.io.json import json_normalize >>> data = [{'state': 'Florida', ... 'shortname': 'FL', ... 'info': {