# JSON Anatomy
[](https://deamonpog.github.io/json-anatomy/)
[](https://www.python.org/downloads/)
[](./LICENSE)
**Dissect JSON structure and navigate data safely with intuitive exploration tools.**
JSON Anatomy provides a robust suite of tools designed for developers and data professionals who need to introspect, analyze, and safely navigate complex JSON data structures. Whether you're working with APIs, configuration files, or large datasets, JSON Anatomy offers both low-level utilities and high-level abstractions to make JSON exploration intuitive and error-free.
## ✨ Key Features
- **🔍 Structural Analysis**: Automatic schema discovery and hierarchy inspection
- **🛡️ Safe Navigation**: Exception-free access with monadic-style `Maybe` wrapper
- **🔧 Comprehensive Utilities**: File operations, XML integration, and unified interface
- **📊 Enterprise Ready**: Type safety, performance optimization, and comprehensive documentation
## 🚀 Quick Start
### Installation
```bash
pip install json-anatomy
```
### Basic Usage
```python
import jsonanatomy as ja
# Sample data
data = {
"users": [
{"name": "Alice", "age": 30, "email": "alice@example.com"},
{"name": "Bob", "age": 25},
{"name": "Charlie", "age": 35, "email": "charlie@example.com"}
],
"metadata": {"version": "1.0", "created": "2024-01-01"}
}
# Safe navigation with automatic error handling
explorer = ja.Xplore(data)
user_name = explorer['users'][0]['name'].value() # Returns: "Alice"
missing_field = explorer['users'][1]['email'].value() # Returns: None (no exception)
# Structural analysis
explore = ja.Explore(data['users'])
field_frequency = explore.field_counts()
print(field_frequency) # {'name': 3, 'age': 3, 'email': 2}
# File operations
json_files = ja.get_json_file_paths('/path/to/data', '*.json')
for file_path in json_files:
data = ja.read_json_file(file_path)
explorer = ja.Xplore(data)
# Process safely...
```
## 📚 Documentation
- **[Complete Documentation](https://deamonpog.github.io/json-anatomy/)**: Comprehensive guides and examples
- **[API Reference](https://deamonpog.github.io/json-anatomy/api/)**: Detailed API documentation with examples
## 🏗️ Core Components
- **`Explore`**: Lightweight structural analysis and schema discovery
- **`Maybe`**: Monadic wrapper for safe, chainable data access
- **`SimpleXML`**: Efficient XML-to-dictionary conversion utilities
- **`Xplore`**: Unified facade combining all functionality
## 🎯 Use Cases
- **API Response Analysis**: Schema evolution tracking and data validation
- **Configuration Management**: Safe navigation of complex configuration hierarchies
- **Data Pipeline Processing**: ETL operations with robust error handling
- **Research and Analysis**: Dataset exploration and statistical analysis
## 📄 License
JSON Anatomy is licensed under the [Apache License 2.0](./LICENSE).
© 2025 Chathura Jayalath. See the [NOTICE](./NOTICE) file for more details.
Raw data
{
"_id": null,
"home_page": null,
"name": "json-anatomy",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "Chathura Jayalath <chathura@example.com>",
"keywords": "json, schema, structure, introspection, navigation, analysis, exploration, data-science, api",
"author": null,
"author_email": "Chathura Jayalath <chathura@example.com>",
"download_url": "https://files.pythonhosted.org/packages/f9/44/406989a5c032e27c1f33b913f23994f0f61a5634db400ae85807bdaa5e26/json_anatomy-0.1.0.tar.gz",
"platform": null,
"description": "# JSON Anatomy\r\n\r\n[](https://deamonpog.github.io/json-anatomy/)\r\n[](https://www.python.org/downloads/)\r\n[](./LICENSE)\r\n\r\n**Dissect JSON structure and navigate data safely with intuitive exploration tools.**\r\n\r\nJSON Anatomy provides a robust suite of tools designed for developers and data professionals who need to introspect, analyze, and safely navigate complex JSON data structures. Whether you're working with APIs, configuration files, or large datasets, JSON Anatomy offers both low-level utilities and high-level abstractions to make JSON exploration intuitive and error-free.\r\n\r\n## \u2728 Key Features\r\n\r\n- **\ud83d\udd0d Structural Analysis**: Automatic schema discovery and hierarchy inspection\r\n- **\ud83d\udee1\ufe0f Safe Navigation**: Exception-free access with monadic-style `Maybe` wrapper\r\n- **\ud83d\udd27 Comprehensive Utilities**: File operations, XML integration, and unified interface\r\n- **\ud83d\udcca Enterprise Ready**: Type safety, performance optimization, and comprehensive documentation\r\n\r\n## \ud83d\ude80 Quick Start\r\n\r\n### Installation\r\n\r\n```bash\r\npip install json-anatomy\r\n```\r\n\r\n### Basic Usage\r\n\r\n```python\r\nimport jsonanatomy as ja\r\n\r\n# Sample data\r\ndata = {\r\n \"users\": [\r\n {\"name\": \"Alice\", \"age\": 30, \"email\": \"alice@example.com\"},\r\n {\"name\": \"Bob\", \"age\": 25},\r\n {\"name\": \"Charlie\", \"age\": 35, \"email\": \"charlie@example.com\"}\r\n ],\r\n \"metadata\": {\"version\": \"1.0\", \"created\": \"2024-01-01\"}\r\n}\r\n\r\n# Safe navigation with automatic error handling\r\nexplorer = ja.Xplore(data)\r\nuser_name = explorer['users'][0]['name'].value() # Returns: \"Alice\"\r\nmissing_field = explorer['users'][1]['email'].value() # Returns: None (no exception)\r\n\r\n# Structural analysis\r\nexplore = ja.Explore(data['users'])\r\nfield_frequency = explore.field_counts()\r\nprint(field_frequency) # {'name': 3, 'age': 3, 'email': 2}\r\n\r\n# File operations\r\njson_files = ja.get_json_file_paths('/path/to/data', '*.json')\r\nfor file_path in json_files:\r\n data = ja.read_json_file(file_path)\r\n explorer = ja.Xplore(data)\r\n # Process safely...\r\n```\r\n\r\n## \ud83d\udcda Documentation\r\n\r\n- **[Complete Documentation](https://deamonpog.github.io/json-anatomy/)**: Comprehensive guides and examples\r\n- **[API Reference](https://deamonpog.github.io/json-anatomy/api/)**: Detailed API documentation with examples\r\n\r\n## \ud83c\udfd7\ufe0f Core Components\r\n\r\n- **`Explore`**: Lightweight structural analysis and schema discovery\r\n- **`Maybe`**: Monadic wrapper for safe, chainable data access\r\n- **`SimpleXML`**: Efficient XML-to-dictionary conversion utilities\r\n- **`Xplore`**: Unified facade combining all functionality\r\n\r\n## \ud83c\udfaf Use Cases\r\n\r\n- **API Response Analysis**: Schema evolution tracking and data validation\r\n- **Configuration Management**: Safe navigation of complex configuration hierarchies\r\n- **Data Pipeline Processing**: ETL operations with robust error handling\r\n- **Research and Analysis**: Dataset exploration and statistical analysis\r\n\r\n## \ud83d\udcc4 License\r\n\r\nJSON Anatomy is licensed under the [Apache License 2.0](./LICENSE). \r\n\u00a9 2025 Chathura Jayalath. See the [NOTICE](./NOTICE) file for more details.\r\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Dissect JSON structure and navigate data safely with intuitive exploration tools.",
"version": "0.1.0",
"project_urls": {
"Bug Tracker": "https://github.com/deamonpog/json-anatomy/issues",
"Changelog": "https://github.com/deamonpog/json-anatomy/releases",
"Documentation": "https://deamonpog.github.io/json-anatomy/",
"Homepage": "https://github.com/deamonpog/json-anatomy",
"Repository": "https://github.com/deamonpog/json-anatomy"
},
"split_keywords": [
"json",
" schema",
" structure",
" introspection",
" navigation",
" analysis",
" exploration",
" data-science",
" api"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "8380d88ef9c5f2174d6dc0fde13e8fd89da2e3dfb4a47d0431afd824d41cc8a6",
"md5": "42263b66732ed14bdddcfac881b2af7e",
"sha256": "b92453b68d163541a71c601aa3f3f6b6312e5ba1e88171b4ffcb83231ef98163"
},
"downloads": -1,
"filename": "json_anatomy-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "42263b66732ed14bdddcfac881b2af7e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 16912,
"upload_time": "2025-10-21T01:29:40",
"upload_time_iso_8601": "2025-10-21T01:29:40.288187Z",
"url": "https://files.pythonhosted.org/packages/83/80/d88ef9c5f2174d6dc0fde13e8fd89da2e3dfb4a47d0431afd824d41cc8a6/json_anatomy-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f944406989a5c032e27c1f33b913f23994f0f61a5634db400ae85807bdaa5e26",
"md5": "3f4c329d9e610fe6943db8aa3b06197c",
"sha256": "81402e1648297da15af106e32da5d158be969c91c00c8c987a7d8ce5a5e729fb"
},
"downloads": -1,
"filename": "json_anatomy-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "3f4c329d9e610fe6943db8aa3b06197c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 14305,
"upload_time": "2025-10-21T01:29:41",
"upload_time_iso_8601": "2025-10-21T01:29:41.713601Z",
"url": "https://files.pythonhosted.org/packages/f9/44/406989a5c032e27c1f33b913f23994f0f61a5634db400ae85807bdaa5e26/json_anatomy-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-21 01:29:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "deamonpog",
"github_project": "json-anatomy",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "json-anatomy"
}
JSON
