text2json-sdk 0.1.0__tar.gz

text2json_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: text2json-sdk
+Version: 0.1.0
+Summary: Convert structured text data into JSON easily
+Author-email: Gautam-Shah <gautm.shah1404@gmail.com>
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# Text2JSON SDK
+
+A lightweight Python SDK to convert structured text (list-based data) into clean JSON format using predefined keys.
+
+---
+
+## 🚀 Installation
+
+Install from PyPI:
+
+```bash
+pip install text2json-sdk
+```
+
+---
+
+## 📌 Quick Start
+
+```python
+from text2json_sdk import Text2JSON
+
+keys = ["Name", "Enrollment", "Department", "Location"]
+
+data = [
+    ["Gautam", "001", "Production", "Pune"],
+    ["Dhruv", "002", "Production", "Gujarat"]
+]
+
+converter = Text2JSON(keys)
+
+# Get Python object
+result = converter.fill(data)
+print(result)
+
+# Get JSON string
+json_result = converter.fill(data, as_json=True)
+print(json_result)
+```
+
+---
+
+## 🧠 How It Works
+
+1. Define a list of keys (schema)
+2. Provide structured data as list of rows
+3. SDK maps each row to keys
+4. Returns JSON-ready output
+
+---
+
+## 📦 Example Output
+
+```json
+[
+  {
+    "Name": "Gautam",
+    "Enrollment": "001",
+    "Department": "Production",
+    "Location": "Pune"
+  },
+  {
+    "Name": "Dhruv",
+    "Enrollment": "002",
+    "Department": "Production",
+    "Location": "Gujarat"
+  }
+]
+```
+
+---
+
+## ✅ Features
+
+- Simple and intuitive API
+- Converts list-based data into structured JSON
+- Handles missing values automatically
+- Input validation with clear errors
+- Optional JSON string output
+
+---
+
+## ⚠️ Error Handling
+
+The SDK raises `StructureError` in the following cases:
+
+- Keys are not a list of strings
+- Keys list is empty
+- Data is not a list of lists
+- Row contains too many values
+- Row format is invalid
+
+Example:
+
+```python
+from text2json_sdk import Text2JSON
+from text2json_sdk.exceptions import StructureError
+
+try:
+    converter = Text2JSON(["Name", "Age"])
+    converter.fill([["Alice", 25, "Extra"]])
+except StructureError as e:
+    print(e)
+```
+
+---
+
+## 🧪 Development Setup
+
+Clone the repository and install locally:
+
+```bash
+git clone <your-repo-url>
+cd text2json_sdk
+pip install -e .
+```
+
+Run tests (if added):
+
+```bash
+pytest
+```
+
+---
+
+## Upload to PyPI:
+
+```bash
+twine upload dist/*
+```
+
+---
+
+## 🛠 Future Improvements
+
+- CSV file support
+- CLI tool (`text2json file.csv`)
+- Schema validation
+- Async support
+- Integration with pandas
+
+---
+
+## 💡 Philosophy
+
+This SDK focuses on simplicity and developer experience:
+
+> "Make structured data transformation effortless and readable."
+

text2json_sdk-0.1.0/README.md

@@ -0,0 +1,148 @@
+# Text2JSON SDK
+
+A lightweight Python SDK to convert structured text (list-based data) into clean JSON format using predefined keys.
+
+---
+
+## 🚀 Installation
+
+Install from PyPI:
+
+```bash
+pip install text2json-sdk
+```
+
+---
+
+## 📌 Quick Start
+
+```python
+from text2json_sdk import Text2JSON
+
+keys = ["Name", "Enrollment", "Department", "Location"]
+
+data = [
+    ["Gautam", "001", "Production", "Pune"],
+    ["Dhruv", "002", "Production", "Gujarat"]
+]
+
+converter = Text2JSON(keys)
+
+# Get Python object
+result = converter.fill(data)
+print(result)
+
+# Get JSON string
+json_result = converter.fill(data, as_json=True)
+print(json_result)
+```
+
+---
+
+## 🧠 How It Works
+
+1. Define a list of keys (schema)
+2. Provide structured data as list of rows
+3. SDK maps each row to keys
+4. Returns JSON-ready output
+
+---
+
+## 📦 Example Output
+
+```json
+[
+  {
+    "Name": "Gautam",
+    "Enrollment": "001",
+    "Department": "Production",
+    "Location": "Pune"
+  },
+  {
+    "Name": "Dhruv",
+    "Enrollment": "002",
+    "Department": "Production",
+    "Location": "Gujarat"
+  }
+]
+```
+
+---
+
+## ✅ Features
+
+- Simple and intuitive API
+- Converts list-based data into structured JSON
+- Handles missing values automatically
+- Input validation with clear errors
+- Optional JSON string output
+
+---
+
+## ⚠️ Error Handling
+
+The SDK raises `StructureError` in the following cases:
+
+- Keys are not a list of strings
+- Keys list is empty
+- Data is not a list of lists
+- Row contains too many values
+- Row format is invalid
+
+Example:
+
+```python
+from text2json_sdk import Text2JSON
+from text2json_sdk.exceptions import StructureError
+
+try:
+    converter = Text2JSON(["Name", "Age"])
+    converter.fill([["Alice", 25, "Extra"]])
+except StructureError as e:
+    print(e)
+```
+
+---
+
+## 🧪 Development Setup
+
+Clone the repository and install locally:
+
+```bash
+git clone <your-repo-url>
+cd text2json_sdk
+pip install -e .
+```
+
+Run tests (if added):
+
+```bash
+pytest
+```
+
+---
+
+## Upload to PyPI:
+
+```bash
+twine upload dist/*
+```
+
+---
+
+## 🛠 Future Improvements
+
+- CSV file support
+- CLI tool (`text2json file.csv`)
+- Schema validation
+- Async support
+- Integration with pandas
+
+---
+
+## 💡 Philosophy
+
+This SDK focuses on simplicity and developer experience:
+
+> "Make structured data transformation effortless and readable."
+

text2json_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,17 @@
+[project]
+name = "text2json-sdk"
+version = "0.1.0"
+description = "Convert structured text data into JSON easily"
+readme = "README.md"
+requires-python = ">=3.8"
+authors = [
+    { name = "Gautam-Shah", email = "gautm.shah1404@gmail.com" }
+]
+dependencies = []
+
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["."]

text2json_sdk-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

text2json_sdk-0.1.0/text2json_sdk/__init__.py

@@ -0,0 +1,4 @@
+from .core import Text2JSON
+
+__all__ = ["Text2JSON"]
+__version__ = "0.1.0"

text2json_sdk-0.1.0/text2json_sdk/core.py

@@ -0,0 +1,55 @@
+import json
+from typing import List, Any
+
+from .exceptions import StructureError
+
+
+class Text2JSON:
+    """
+    Convert structured list data into JSON using predefined keys.
+    """
+
+    def __init__(self, keys: List[str]):
+        if not isinstance(keys, list) or not all(isinstance(k, str) for k in keys):
+            raise StructureError("Keys must be a list of strings")
+
+        if len(keys) == 0:
+            raise StructureError("Keys list cannot be empty")
+
+        self.keys = [k.strip() for k in keys]
+
+    def fill(self, data: List[List[Any]], as_json: bool = False):
+        """
+        Convert list of rows into structured JSON.
+
+        :param data: List of lists (rows)
+        :param as_json: If True, returns JSON string instead of Python object
+        :return: List of dictionaries OR JSON string
+        """
+
+        if not isinstance(data, list):
+            raise StructureError("Data must be a list of lists")
+
+        result = []
+
+        for idx, row in enumerate(data):
+            if not isinstance(row, list):
+                raise StructureError(f"Row {idx} is not a list")
+
+            # Normalize row values
+            row = [str(item).strip() for item in row]
+
+            # Handle missing values
+            if len(row) < len(self.keys):
+                row += [None] * (len(self.keys) - len(row))
+
+            # Handle extra values
+            if len(row) > len(self.keys):
+                raise StructureError(
+                    f"Row {idx} has too many values. Expected {len(self.keys)}, got {len(row)}"
+                )
+
+            obj = dict(zip(self.keys, row))
+            result.append(obj)
+
+        return json.dumps(result, indent=2) if as_json else result

text2json_sdk-0.1.0/text2json_sdk/exceptions.py

@@ -0,0 +1,3 @@
+class StructureError(Exception):
+    """Raised when input structure is invalid"""
+    pass

text2json_sdk-0.1.0/text2json_sdk.egg-info/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: text2json-sdk
+Version: 0.1.0
+Summary: Convert structured text data into JSON easily
+Author-email: Gautam-Shah <gautm.shah1404@gmail.com>
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# Text2JSON SDK
+
+A lightweight Python SDK to convert structured text (list-based data) into clean JSON format using predefined keys.
+
+---
+
+## 🚀 Installation
+
+Install from PyPI:
+
+```bash
+pip install text2json-sdk
+```
+
+---
+
+## 📌 Quick Start
+
+```python
+from text2json_sdk import Text2JSON
+
+keys = ["Name", "Enrollment", "Department", "Location"]
+
+data = [
+    ["Gautam", "001", "Production", "Pune"],
+    ["Dhruv", "002", "Production", "Gujarat"]
+]
+
+converter = Text2JSON(keys)
+
+# Get Python object
+result = converter.fill(data)
+print(result)
+
+# Get JSON string
+json_result = converter.fill(data, as_json=True)
+print(json_result)
+```
+
+---
+
+## 🧠 How It Works
+
+1. Define a list of keys (schema)
+2. Provide structured data as list of rows
+3. SDK maps each row to keys
+4. Returns JSON-ready output
+
+---
+
+## 📦 Example Output
+
+```json
+[
+  {
+    "Name": "Gautam",
+    "Enrollment": "001",
+    "Department": "Production",
+    "Location": "Pune"
+  },
+  {
+    "Name": "Dhruv",
+    "Enrollment": "002",
+    "Department": "Production",
+    "Location": "Gujarat"
+  }
+]
+```
+
+---
+
+## ✅ Features
+
+- Simple and intuitive API
+- Converts list-based data into structured JSON
+- Handles missing values automatically
+- Input validation with clear errors
+- Optional JSON string output
+
+---
+
+## ⚠️ Error Handling
+
+The SDK raises `StructureError` in the following cases:
+
+- Keys are not a list of strings
+- Keys list is empty
+- Data is not a list of lists
+- Row contains too many values
+- Row format is invalid
+
+Example:
+
+```python
+from text2json_sdk import Text2JSON
+from text2json_sdk.exceptions import StructureError
+
+try:
+    converter = Text2JSON(["Name", "Age"])
+    converter.fill([["Alice", 25, "Extra"]])
+except StructureError as e:
+    print(e)
+```
+
+---
+
+## 🧪 Development Setup
+
+Clone the repository and install locally:
+
+```bash
+git clone <your-repo-url>
+cd text2json_sdk
+pip install -e .
+```
+
+Run tests (if added):
+
+```bash
+pytest
+```
+
+---
+
+## Upload to PyPI:
+
+```bash
+twine upload dist/*
+```
+
+---
+
+## 🛠 Future Improvements
+
+- CSV file support
+- CLI tool (`text2json file.csv`)
+- Schema validation
+- Async support
+- Integration with pandas
+
+---
+
+## 💡 Philosophy
+
+This SDK focuses on simplicity and developer experience:
+
+> "Make structured data transformation effortless and readable."
+

text2json_sdk-0.1.0/text2json_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+text2json_sdk/__init__.py
+text2json_sdk/core.py
+text2json_sdk/exceptions.py
+text2json_sdk.egg-info/PKG-INFO
+text2json_sdk.egg-info/SOURCES.txt
+text2json_sdk.egg-info/dependency_links.txt
+text2json_sdk.egg-info/top_level.txt

text2json_sdk-0.1.0/text2json_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

text2json_sdk-0.1.0/text2json_sdk.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+dist
+text2json_sdk