[Docs] Code visualization and documentation for friendli-python

.codeboarding/Data_Models_Error_Handling.json

@@ -0,0 +1,137 @@
+{
+  "description": "This analysis outlines the final component structure of the `friendli_core` SDK, detailing its five key components: Core Client, Service Modules, Data Models & Error Handling, Utility Functions, and Examples and Documentation. It describes each component's role, associated source files, and interactions within the SDK, providing a comprehensive overview of the system's architecture and interdependencies.",
+  "components": [
+    {
+      "name": "Core Client",
+      "description": "The central entry point for the SDK, responsible for managing authentication, session handling, and dispatching requests to the appropriate service modules. It provides the primary interface for users to interact with the Friendli AI platform.",
+      "referenced_source_code": [
+        {
+          "qualified_name": "friendli_core.client",
+          "reference_file": "friendli_core.client.py",
+          "reference_start_line": 1,
+          "reference_end_line": 1
+        }
+      ]
+    },
+    {
+      "name": "Service Modules",
+      "description": "Encapsulate specific API functionalities (e.g., chat, completions, image generation, audio processing). Each module provides high-level methods for its domain, abstracting the underlying RESTful API calls and handling domain-specific logic.",
+      "referenced_source_code": [
+        {
+          "qualified_name": "friendli_core.chat",
+          "reference_file": "/mnt/e/StartUp/friendli-python/src/friendli_core/chat.py",
+          "reference_start_line": null,
+          "reference_end_line": null
+        },
+        {
+          "qualified_name": "friendli_core.completions",
+          "reference_file": "/mnt/e/StartUp/friendli-python/src/friendli_core/completions.py",
+          "reference_start_line": null,
+          "reference_end_line": null
+        },
+        {
+          "qualified_name": "friendli_core.image",
+          "reference_file": "/mnt/e/StartUp/friendli-python/src/friendli_core/image.py",
+          "reference_start_line": null,
+          "reference_end_line": null
+        },
+        {
+          "qualified_name": "friendli_core.audio",
+          "reference_file": "/mnt/e/StartUp/friendli-python/src/friendli_core/audio.py",
+          "reference_start_line": null,
+          "reference_end_line": null
+        }
+      ]
+    },
+    {
+      "name": "Data Models & Error Handling",
+      "description": "Defines standardized data structures for all API requests and responses, ensuring consistent data representation across the SDK. This component also provides a comprehensive set of error types, facilitating robust and standardized error reporting from the Friendli AI platform.",
+      "referenced_source_code": [
+        {
+          "qualified_name": "friendli_core.models",
+          "reference_file": "friendli_core.models.py",
+          "reference_start_line": 1,
+          "reference_end_line": 1
+        },
+        {
+          "qualified_name": "friendli_core.errors",
+          "reference_file": "friendli_core.errors.py",
+          "reference_start_line": 1,
+          "reference_end_line": 1
+        }
+      ]
+    },
+    {
+      "name": "Utility Functions",
+      "description": "Provides common helper functions for SDK-wide tasks such as JSON serialization/deserialization, parameter validation, configuration loading, and other reusable logic that supports the core functionalities.",
+      "referenced_source_code": [
+        {
+          "qualified_name": "friendli_core.utils",
+          "reference_file": "friendli_core.utils.py",
+          "reference_start_line": 1,
+          "reference_end_line": 1
+        }
+      ]
+    },
+    {
+      "name": "Examples and Documentation",
+      "description": "Comprises practical code examples demonstrating how to effectively use the SDK's functionalities and comprehensive documentation (API references, guides) to assist developers in integrating and utilizing the Friendli AI platform.",
+      "referenced_source_code": [
+        {
+          "qualified_name": "examples",
+          "reference_file": "examples/",
+          "reference_start_line": 1,
+          "reference_end_line": 1
+        },
+        {
+          "qualified_name": "docs",
+          "reference_file": "docs/",
+          "reference_start_line": 1,
+          "reference_end_line": 1
+        }
+      ]
+    }
+  ],
+  "components_relations": [
+    {
+      "relation": "uses",
+      "src_name": "Core Client",
+      "dst_name": "Service Modules"
+    },
+    {
+      "relation": "uses",
+      "src_name": "Core Client",
+      "dst_name": "Data Models & Error Handling"
+    },
+    {
+      "relation": "uses",
+      "src_name": "Core Client",
+      "dst_name": "Utility Functions"
+    },
+    {
+      "relation": "utilizes",
+      "src_name": "Service Modules",
+      "dst_name": "Data Models & Error Handling"
+    },
+    {
+      "relation": "uses",
+      "src_name": "Service Modules",
+      "dst_name": "Utility Functions"
+    },
+    {
+      "relation": "showcases usage of",
+      "src_name": "Examples and Documentation",
+      "dst_name": "Core Client"
+    },
+    {
+      "relation": "showcases usage of",
+      "src_name": "Examples and Documentation",
+      "dst_name": "Service Modules"
+    },
+    {
+      "relation": "relies on",
+      "src_name": "Examples and Documentation",
+      "dst_name": "Data Models & Error Handling"
+    }
+  ]
+}

.codeboarding/Data_Models_Error_Handling.md

@@ -0,0 +1,78 @@
+```mermaid
+graph LR
+    Core_Client["Core Client"]
+    Service_Modules["Service Modules"]
+    Data_Models_Error_Handling["Data Models & Error Handling"]
+    Utility_Functions["Utility Functions"]
+    Examples_and_Documentation["Examples and Documentation"]
+    Core_Client -- "uses" --> Service_Modules
+    Core_Client -- "uses" --> Data_Models_Error_Handling
+    Core_Client -- "uses" --> Utility_Functions
+    Service_Modules -- "utilizes" --> Data_Models_Error_Handling
+    Service_Modules -- "uses" --> Utility_Functions
+    Examples_and_Documentation -- "showcases usage of" --> Core_Client
+    Examples_and_Documentation -- "showcases usage of" --> Service_Modules
+    Examples_and_Documentation -- "relies on" --> Data_Models_Error_Handling
+    click Service_Modules href "https://github.com/CodeBoarding/friendli-python/blob/main/.codeboarding/Service_Modules.md" "Details"
+    click Data_Models_Error_Handling href "https://github.com/CodeBoarding/friendli-python/blob/main/.codeboarding/Data_Models_Error_Handling.md" "Details"
+```
+
+[![CodeBoarding](https://img.shields.io/badge/Generated%20by-CodeBoarding-9cf?style=flat-square)](https://github.com/CodeBoarding/CodeBoarding)[![Demo](https://img.shields.io/badge/Try%20our-Demo-blue?style=flat-square)](https://www.codeboarding.org/diagrams)[![Contact](https://img.shields.io/badge/Contact%20us%20-%20contact@codeboarding.org-lightgrey?style=flat-square)](mailto:contact@codeboarding.org)
+
+## Details
+
+This analysis outlines the final component structure of the `friendli_core` SDK, detailing its five key components: Core Client, Service Modules, Data Models & Error Handling, Utility Functions, and Examples and Documentation. It describes each component's role, associated source files, and interactions within the SDK, providing a comprehensive overview of the system's architecture and interdependencies.
+
+### Core Client
+The central entry point for the SDK, responsible for managing authentication, session handling, and dispatching requests to the appropriate service modules. It provides the primary interface for users to interact with the Friendli AI platform.
+
+
+**Related Classes/Methods**:
+
+- `friendli_core.client`
+
+
+### Service Modules [[Expand]](./Service_Modules.md)
+Encapsulate specific API functionalities (e.g., chat, completions, image generation, audio processing). Each module provides high-level methods for its domain, abstracting the underlying RESTful API calls and handling domain-specific logic.
+
+
+**Related Classes/Methods**:
+
+- `friendli_core.chat`
+- `friendli_core.completions`
+- `friendli_core.image`
+- `friendli_core.audio`
+
+
+### Data Models & Error Handling [[Expand]](./Data_Models_Error_Handling.md)
+Defines standardized data structures for all API requests and responses, ensuring consistent data representation across the SDK. This component also provides a comprehensive set of error types, facilitating robust and standardized error reporting from the Friendli AI platform.
+
+
+**Related Classes/Methods**:
+
+- `friendli_core.models`
+- `friendli_core.errors`
+
+
+### Utility Functions
+Provides common helper functions for SDK-wide tasks such as JSON serialization/deserialization, parameter validation, configuration loading, and other reusable logic that supports the core functionalities.
+
+
+**Related Classes/Methods**:
+
+- `friendli_core.utils`
+
+
+### Examples and Documentation
+Comprises practical code examples demonstrating how to effectively use the SDK's functionalities and comprehensive documentation (API references, guides) to assist developers in integrating and utilizing the Friendli AI platform.
+
+
+**Related Classes/Methods**:
+
+- `examples`
+- <a href="https://github.com/CodeBoarding/friendli-python/blob/main/.codeboardingdocs/" target="_blank" rel="noopener noreferrer">`docs`</a>
+
+
+
+
+### [FAQ](https://github.com/CodeBoarding/GeneratedOnBoardings/tree/main?tab=readme-ov-file#faq)

.codeboarding/Friendli_Client_Public_API_.json

@@ -0,0 +1,159 @@
+{
+  "description": "Final Component Overview for the `Friendli Client (Public API)` subsystem, structured according to Client-side SDK patterns.",
+  "components": [
+    {
+      "name": "Core Client (Public API)",
+      "description": "The primary entry point for end-users, offering a high-level, consistent interface for interacting with the Friendli AI platform, supporting both synchronous and asynchronous operations. It acts as the orchestrator, delegating requests to specific service modules.",
+      "referenced_source_code": [
+        {
+          "qualified_name": "friendli_core.sdk",
+          "reference_file": "/mnt/e/StartUp/friendli-python/src/friendli_core/sdk.py",
+          "reference_start_line": null,
+          "reference_end_line": null
+        }
+      ]
+    },
+    {
+      "name": "Service Modules",
+      "description": "Encapsulate the logic for interacting with specific API endpoints (e.g., chat, completions, images, audio). Each module handles the construction of requests, serialization of data models, and deserialization of responses for its domain.",
+      "referenced_source_code": [
+        {
+          "qualified_name": "friendli_core.chat",
+          "reference_file": "/mnt/e/StartUp/friendli-python/src/friendli_core/chat.py",
+          "reference_start_line": null,
+          "reference_end_line": null
+        },
+        {
+          "qualified_name": "friendli_core.completions",
+          "reference_file": "/mnt/e/StartUp/friendli-python/src/friendli_core/completions.py",
+          "reference_start_line": null,
+          "reference_end_line": null
+        },
+        {
+          "qualified_name": "friendli_core.images",
+          "reference_file": "friendli_core.images",
+          "reference_start_line": 1,
+          "reference_end_line": 1
+        },
+        {
+          "qualified_name": "friendli_core.audio",
+          "reference_file": "/mnt/e/StartUp/friendli-python/src/friendli_core/audio.py",
+          "reference_start_line": null,
+          "reference_end_line": null
+        }
+      ]
+    },
+    {
+      "name": "Data Models",
+      "description": "Define the structure of data exchanged with the Friendli AI platform, including request bodies, response objects, and various parameters. Ensures type safety and consistency across all API interactions within the SDK.",
+      "referenced_source_code": [
+        {
+          "qualified_name": "friendli_core.models",
+          "reference_file": "friendli_core.models",
+          "reference_start_line": 1,
+          "reference_end_line": 1
+        }
+      ]
+    },
+    {
+      "name": "HTTP Client/Transport Layer",
+      "description": "Handles the low-level HTTP communication with the Friendli AI platform. This includes managing connections, sending requests, receiving responses, and abstracting away network-level concerns like retries and timeouts.",
+      "referenced_source_code": [
+        {
+          "qualified_name": "friendli_core.http_client",
+          "reference_file": "friendli_core.http_client",
+          "reference_start_line": 1,
+          "reference_end_line": 1
+        }
+      ]
+    },
+    {
+      "name": "Error Handling",
+      "description": "Manages and standardizes error responses from both the API and the network layer. It provides custom exception classes and mechanisms for users to gracefully handle API-related issues and network errors, ensuring a consistent error reporting experience.",
+      "referenced_source_code": [
+        {
+          "qualified_name": "friendli_core.errors",
+          "reference_file": "friendli_core.errors",
+          "reference_start_line": 1,
+          "reference_end_line": 1
+        }
+      ]
+    },
+    {
+      "name": "Configuration Management",
+      "description": "Centralizes and manages SDK-wide configuration settings, such as API keys, base URLs, default timeouts, and retry policies. It provides a consistent and accessible way to configure the SDK's behavior.",
+      "referenced_source_code": [
+        {
+          "qualified_name": "friendli_core.config",
+          "reference_file": "friendli_core.config",
+          "reference_start_line": 1,
+          "reference_end_line": 1
+        }
+      ]
+    },
+    {
+      "name": "Utility Functions",
+      "description": "Provides common helper functions and reusable functionalities that support various parts of the SDK, such as authentication token management, data validation, or specific data transformations that are not tied to a particular API domain.",
+      "referenced_source_code": [
+        {
+          "qualified_name": "friendli_core.utils",
+          "reference_file": "friendli_core.utils",
+          "reference_start_line": 1,
+          "reference_end_line": 1
+        }
+      ]
+    }
+  ],
+  "components_relations": [
+    {
+      "relation": "uses",
+      "src_name": "Core Client (Public API)",
+      "dst_name": "Service Modules"
+    },
+    {
+      "relation": "uses",
+      "src_name": "Core Client (Public API)",
+      "dst_name": "Configuration Management"
+    },
+    {
+      "relation": "uses",
+      "src_name": "Core Client (Public API)",
+      "dst_name": "Data Models"
+    },
+    {
+      "relation": "uses",
+      "src_name": "Core Client (Public API)",
+      "dst_name": "Utility Functions"
+    },
+    {
+      "relation": "uses",
+      "src_name": "Service Modules",
+      "dst_name": "HTTP Client/Transport Layer"
+    },
+    {
+      "relation": "uses",
+      "src_name": "Service Modules",
+      "dst_name": "Data Models"
+    },
+    {
+      "relation": "uses",
+      "src_name": "Service Modules",
+      "dst_name": "Error Handling"
+    },
+    {
+      "relation": "uses",
+      "src_name": "Service Modules",
+      "dst_name": "Utility Functions"
+    },
+    {
+      "relation": "uses",
+      "src_name": "HTTP Client/Transport Layer",
+      "dst_name": "Configuration Management"
+    },
+    {
+      "relation": "uses",
+      "src_name": "HTTP Client/Transport Layer",
+      "dst_name": "Error Handling"
+    }
+  ]
+}