jsonunwrap 0.2.0__tar.gz → 0.2.1__tar.gz

jsonunwrap-0.2.1/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: jsonunwrap
+Version: 0.2.1
+Summary: A small python package that unpacks data from a JSON url and converts it into a csv file.
+Author-email: njuedominic <njuemugodominic@gmail.com>
+Project-URL: Homepage, https://github.com/njuedominic/json-unwrap
+Project-URL: Bug Tracker, https://github.com/njuedominic/json-unwrap/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Requires-Dist: pandas>=2.0.0
+
+# jsonunwrap
+
+**jsonunwrap** is a simple JSON flattening and normalization library.
+
+```python
+>>> import jsonunwrap as ju
+>>> url = "https://dummyjson.com/carts"
+>>> fetchdata = ju.fetch_json(url)
+>>> df = ju.unwrap_data(fetchdata)
+>>> df.columns
+Index(['id', 'user.name', 'hobbies'], dtype='object')
+>>> len(df)
+2
+```
+
+jsonunwrap allows you to deeply normalize complex, semi-structured nested JSON data into clean pandas DataFrames extremely easily.
+
+---
+
+## Installing jsonunwrap
+
+jsonunwrap is available on PyPI:
+
+```bash
+$ python -m pip install jsonunwrap
+```
+
+## Supported Features & Best–Practices
+
+jsonunwrap is ready for the data parsing demands of modern web APIs, automation scripts, and data engineering pipelines.
+
+- Recursive Deep-Flattening (Dot-notation formatting for sub-dictionaries)
+- Automated List Explosion (Spanning embedded primitive lists safely into unique rows)
+- Endpoint Target Binding (Fetch and write stream sequences in a single wrapper)
+- Clean API Namespace (Unified module boundaries with zero complex configuration maps)
+
+---
+
+## Quick Usage Reference
+
+### Download, Normalize, and Export an API Stream to Disk
+
+```python
+import jsonunwrap as ju
+
+target_url = "url"
+output_file = "data/normalized_users.csv"
+
+# Fetch, unwrap nested schemas, and generate a local CSV payload
+df = ju.json_to_csv(target_url, output_file)
+```
+
+---
+
+## Core API Documentation
+
+The complete package interaction map exposes three primary interfaces:
+
+### `jsonunwrap.unwrap_data(data)`
+Recursively flattens an in-memory dictionary or list of records. Returns a parsed `pandas.DataFrame`.
+
+### `jsonunwrap.fetch_json(url, **kwargs)`
+A connection delivery utility utilizing the `requests` transport subsystem. Passes `**kwargs` onwards to target handlers.
+
+### `jsonunwrap.json_to_csv(url, output_path)`
+High-level workflow coordinator connecting remote schema acquisition loops directly to a structural local CSV export.
+
+---
+
+## Contributions & Testing
+
+To test modifications locally or prepare adjustments, execute using `pytest`:
+
+```bash
+\$ git clone https://github.com/njuedominic/json-unwrap
+\$ cd jsonunwrap
+\(python -m pip install -e .[test]\) pytest
+```

jsonunwrap-0.2.1/README.md

@@ -0,0 +1,78 @@
+# jsonunwrap
+
+**jsonunwrap** is a simple JSON flattening and normalization library.
+
+```python
+>>> import jsonunwrap as ju
+>>> url = "https://dummyjson.com/carts"
+>>> fetchdata = ju.fetch_json(url)
+>>> df = ju.unwrap_data(fetchdata)
+>>> df.columns
+Index(['id', 'user.name', 'hobbies'], dtype='object')
+>>> len(df)
+2
+```
+
+jsonunwrap allows you to deeply normalize complex, semi-structured nested JSON data into clean pandas DataFrames extremely easily.
+
+---
+
+## Installing jsonunwrap
+
+jsonunwrap is available on PyPI:
+
+```bash
+$ python -m pip install jsonunwrap
+```
+
+## Supported Features & Best–Practices
+
+jsonunwrap is ready for the data parsing demands of modern web APIs, automation scripts, and data engineering pipelines.
+
+- Recursive Deep-Flattening (Dot-notation formatting for sub-dictionaries)
+- Automated List Explosion (Spanning embedded primitive lists safely into unique rows)
+- Endpoint Target Binding (Fetch and write stream sequences in a single wrapper)
+- Clean API Namespace (Unified module boundaries with zero complex configuration maps)
+
+---
+
+## Quick Usage Reference
+
+### Download, Normalize, and Export an API Stream to Disk
+
+```python
+import jsonunwrap as ju
+
+target_url = "url"
+output_file = "data/normalized_users.csv"
+
+# Fetch, unwrap nested schemas, and generate a local CSV payload
+df = ju.json_to_csv(target_url, output_file)
+```
+
+---
+
+## Core API Documentation
+
+The complete package interaction map exposes three primary interfaces:
+
+### `jsonunwrap.unwrap_data(data)`
+Recursively flattens an in-memory dictionary or list of records. Returns a parsed `pandas.DataFrame`.
+
+### `jsonunwrap.fetch_json(url, **kwargs)`
+A connection delivery utility utilizing the `requests` transport subsystem. Passes `**kwargs` onwards to target handlers.
+
+### `jsonunwrap.json_to_csv(url, output_path)`
+High-level workflow coordinator connecting remote schema acquisition loops directly to a structural local CSV export.
+
+---
+
+## Contributions & Testing
+
+To test modifications locally or prepare adjustments, execute using `pytest`:
+
+```bash
+\$ git clone https://github.com/njuedominic/json-unwrap
+\$ cd jsonunwrap
+\(python -m pip install -e .[test]\) pytest
+```

{jsonunwrap-0.2.0 → jsonunwrap-0.2.1}/jsonunwrap/core.py

@@ -11,27 +11,28 @@ def unwrap_data(data: Union[Dict[str, Any], List[Any]]) -> pd.DataFrame:
     """
     Normalizes and deeply flattens semi-structured JSON data into a pandas DataFrame.
     """
-    # Simply convert a single dictionary into a list containing that dictionary
     if isinstance(data, dict):
         main_data = [data]
     else:
         main_data = data
 
-    # Perform the initial normalization
     df = pd.json_normalize(main_data)
 
-    # Automatically iterate through the columns and deeply flatten any nested structures
+    # Professional Fix: Track already exploded primitive columns to prevent loops
+    exploded_columns = set()
+
     changed = True
     while changed:
         changed = False
         for col in list(df.columns):
-            # Explode lists
-            if any(isinstance(val, list) for val in df[col].dropna()):
+            # 1. Explode lists (Only if we haven't exploded this exact column name yet)
+            if col not in exploded_columns and any(isinstance(val, list) for val in df[col].dropna()):
                 df = df.explode(col)
+                exploded_columns.add(col)  # Mark as done so we don't repeat it!
                 changed = True
-                break  # Refresh columns list after structural changes
+                break  # Refresh columns list
 
-            # Normalize and merge nested dictionaries
+            # 2. Normalize and merge nested dictionaries
             if any(isinstance(val, dict) for val in df[col].dropna()):
                 nested_df = pd.json_normalize(df[col]).set_index(df.index)
                 df = df.drop(columns=[col]).join(nested_df, rsuffix=f"_{col}")

jsonunwrap-0.2.1/jsonunwrap.egg-info/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: jsonunwrap
+Version: 0.2.1
+Summary: A small python package that unpacks data from a JSON url and converts it into a csv file.
+Author-email: njuedominic <njuemugodominic@gmail.com>
+Project-URL: Homepage, https://github.com/njuedominic/json-unwrap
+Project-URL: Bug Tracker, https://github.com/njuedominic/json-unwrap/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Requires-Dist: pandas>=2.0.0
+
+# jsonunwrap
+
+**jsonunwrap** is a simple JSON flattening and normalization library.
+
+```python
+>>> import jsonunwrap as ju
+>>> url = "https://dummyjson.com/carts"
+>>> fetchdata = ju.fetch_json(url)
+>>> df = ju.unwrap_data(fetchdata)
+>>> df.columns
+Index(['id', 'user.name', 'hobbies'], dtype='object')
+>>> len(df)
+2
+```
+
+jsonunwrap allows you to deeply normalize complex, semi-structured nested JSON data into clean pandas DataFrames extremely easily.
+
+---
+
+## Installing jsonunwrap
+
+jsonunwrap is available on PyPI:
+
+```bash
+$ python -m pip install jsonunwrap
+```
+
+## Supported Features & Best–Practices
+
+jsonunwrap is ready for the data parsing demands of modern web APIs, automation scripts, and data engineering pipelines.
+
+- Recursive Deep-Flattening (Dot-notation formatting for sub-dictionaries)
+- Automated List Explosion (Spanning embedded primitive lists safely into unique rows)
+- Endpoint Target Binding (Fetch and write stream sequences in a single wrapper)
+- Clean API Namespace (Unified module boundaries with zero complex configuration maps)
+
+---
+
+## Quick Usage Reference
+
+### Download, Normalize, and Export an API Stream to Disk
+
+```python
+import jsonunwrap as ju
+
+target_url = "url"
+output_file = "data/normalized_users.csv"
+
+# Fetch, unwrap nested schemas, and generate a local CSV payload
+df = ju.json_to_csv(target_url, output_file)
+```
+
+---
+
+## Core API Documentation
+
+The complete package interaction map exposes three primary interfaces:
+
+### `jsonunwrap.unwrap_data(data)`
+Recursively flattens an in-memory dictionary or list of records. Returns a parsed `pandas.DataFrame`.
+
+### `jsonunwrap.fetch_json(url, **kwargs)`
+A connection delivery utility utilizing the `requests` transport subsystem. Passes `**kwargs` onwards to target handlers.
+
+### `jsonunwrap.json_to_csv(url, output_path)`
+High-level workflow coordinator connecting remote schema acquisition loops directly to a structural local CSV export.
+
+---
+
+## Contributions & Testing
+
+To test modifications locally or prepare adjustments, execute using `pytest`:
+
+```bash
+\$ git clone https://github.com/njuedominic/json-unwrap
+\$ cd jsonunwrap
+\(python -m pip install -e .[test]\) pytest
+```

{jsonunwrap-0.2.0 → jsonunwrap-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "jsonunwrap"
-version = "0.2.0"
+version = "0.2.1"
 authors = [
     { name = "njuedominic", email="njuemugodominic@gmail.com"}
 ]

jsonunwrap-0.2.0/PKG-INFO

@@ -1,28 +0,0 @@
-Metadata-Version: 2.4
-Name: jsonunwrap
-Version: 0.2.0
-Summary: A small python package that unpacks data from a JSON url and converts it into a csv file.
-Author-email: njuedominic <njuemugodominic@gmail.com>
-Project-URL: Homepage, https://github.com/njuedominic/json-unwrap
-Project-URL: Bug Tracker, https://github.com/njuedominic/json-unwrap/issues
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >3.8
-Description-Content-Type: text/markdown
-Requires-Dist: requests>=2.28.0
-Requires-Dist: pandas>=2.0.0
-
-### JSON Unwrap
-A small python package that unpacks data from a JSON url and converts it into a csv file.
-
-### Current features
-* Convert one JSON url to a csv
-* Automatically creates a data folder if it does not exist
-
-### Roadmap
-* Custom file names for output csv
-* Convert into a dataframe ready for use in a notebook environment
-* Error handling for a failed url
-* Tests
-* Documentation examples

jsonunwrap-0.2.0/README.md

@@ -1,13 +0,0 @@
-### JSON Unwrap
-A small python package that unpacks data from a JSON url and converts it into a csv file.
-
-### Current features
-* Convert one JSON url to a csv
-* Automatically creates a data folder if it does not exist
-
-### Roadmap
-* Custom file names for output csv
-* Convert into a dataframe ready for use in a notebook environment
-* Error handling for a failed url
-* Tests
-* Documentation examples

jsonunwrap-0.2.0/jsonunwrap.egg-info/PKG-INFO

@@ -1,28 +0,0 @@
-Metadata-Version: 2.4
-Name: jsonunwrap
-Version: 0.2.0
-Summary: A small python package that unpacks data from a JSON url and converts it into a csv file.
-Author-email: njuedominic <njuemugodominic@gmail.com>
-Project-URL: Homepage, https://github.com/njuedominic/json-unwrap
-Project-URL: Bug Tracker, https://github.com/njuedominic/json-unwrap/issues
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >3.8
-Description-Content-Type: text/markdown
-Requires-Dist: requests>=2.28.0
-Requires-Dist: pandas>=2.0.0
-
-### JSON Unwrap
-A small python package that unpacks data from a JSON url and converts it into a csv file.
-
-### Current features
-* Convert one JSON url to a csv
-* Automatically creates a data folder if it does not exist
-
-### Roadmap
-* Custom file names for output csv
-* Convert into a dataframe ready for use in a notebook environment
-* Error handling for a failed url
-* Tests
-* Documentation examples