Refactor project structure, rename package to Clappia API Tools, and release v1.0.1 (#7)

* Refactor project structure and rename package to Clappia API Tools

- Updated package name from `clappia-tools` to `clappia-api-tools` in `pyproject.toml`, `README.md`, and `uv.lock`.
- Adjusted test paths in `pyproject.toml` to reflect the new package structure.
- Removed unused modules and files related to the previous package structure.
- Enhanced documentation in `README.md` to clarify the purpose and features of the Clappia API Tools.
- Updated version to 1.0.0 to reflect the changes made in the package structure and naming.

Signed-off-by: Rishabh Verma <rishabh.v@clappia.com>

* Update package references and remove AppManagementClient

- Changed package references from `clappia-tools` to `clappia-api-tools` in `pyproject.toml` and `README.md`.
- Removed the `AppManagementClient` class and its references throughout the codebase, consolidating functionality into `AppDefinitionClient`.
- Updated documentation to reflect the removal of `AppManagementClient` and added new methods for app creation and field management in `AppDefinitionClient`.
- Adjusted tests to ensure compatibility with the updated client structure.

Signed-off-by: Rishabh Verma <rishabh.v@clappia.com>

* Update version to 1.0.1 in pyproject.toml and __init__.py

Signed-off-by: Rishabh Verma <rishabh.v@clappia.com>

---------

Signed-off-by: Rishabh Verma <rishabh.v@clappia.com>

Author: madara-uchihaaa

README.md

@@ -1,74 +1,92 @@
-# Clappia Tools
+# Clappia API Tools
 
-**LangChain integration for Clappia API**
+**Clappia APIs SDK**
 
-[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/clappia-tools)](https://pypi.org/project/clappia-tools/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/clappia-api-tools)](https://pypi.org/project/clappia-api-tools/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
 ---
 
 ## Overview
 
-Clappia Tools is a Python package that provides a unified client and a set of tools for seamless integration with the [Clappia API](https://www.clappia.com/). It enables developers to automate workflows, manage submissions, and interact with Clappia apps programmatically. The package is designed for use in automation, data integration, and agent-based systems (e.g., LangChain agents).
+Clappia API Tools is a Python package that provides a set of clients for seamless integration with the [Clappia API](https://developer.clappia.com/). It enables developers to automate workflows, manage submissions, and interact with Clappia apps programmatically. The package is designed for use in automation, data integration, and agent-based systems (e.g., LangChain agents, MCP).
 
 ---
 
 ## Features
 
--  **Unified API Client**: One client for all Clappia API operations.
+-  **Multiple API Clients**: Dedicated clients for each Clappia API operation.
 -  **Submission Management**: Create, edit, update owners, and change status of submissions.
--  **App Definition Retrieval**: Fetch complete app structure and metadata.
+-  **App Definition Retrieval**: Fetch complete app structure and metadata and  manage the app structure via fields and sections updates.
 -  **Input Validation**: Built-in validation for IDs, emails, and status objects.
--  **Extensible Tools**: Modular functions for each operation, easily integrated into agents or scripts.
 -  **Comprehensive Testing**: Includes unit and integration tests.
 
 ---
 
+## Available Clients
+
+-  `SubmissionClient`: Manage submissions (create, edit, update owners, change status)
+-  `AppDefinitionClient`: Retrieve app definitions and metadata and  Manage app structure (fields, sections, creation)
+
+---
+
+## Documentation
+
+-  [Submission Client Reference](docs/submission_client.md)
+-  [App Definition Client Reference](docs/app_definition_client.md)
+
+---
+
 ## Installation
 
 ```bash
-pip install clappia-tools
+pip install clappia-api-tools
 ```
 
 Or, for development:
 
 ```bash
-git clone https://github.com/clappia-dev/clappia-tools.git
-cd clappia-tools
-pip install -e .[dev]
+git clone https://github.com/clappia-dev/clappia-api-tools.git
+cd clappia-api-tools
+pip install -e ."[dev]"
 ```
 
 ---
 
+## First-Time Setup
+
+Before using or testing Clappia API Tools, set up your environment variables. Create a `.env` file in the project root with the following content:
+
+```env
+CLAPPIA_API_KEY=your-api-key
+CLAPPIA_BASE_URL=https://api.clappia.com
+CLAPPIA_WORKPLACE_ID=your-workplace-id
+```
+
+-  Replace `your-api-key` and `your-workplace-id` with your actual Clappia credentials.
+-  The `.env` file is included in `.gitignore` and will not be committed.
+-  The package uses [python-dotenv](https://pypi.org/project/python-dotenv/) to load these variables automatically if present.
+
+---
+
 ## Configuration
 
-You must provide your Clappia API credentials and workspace information directly when initializing the `ClappiaClient`:
+You must provide your Clappia API credentials and workspace information directly when initializing any client:
 
 -  `api_key`: Your Clappia API key
 -  `base_url`: The base URL for the Clappia API (e.g., `https://api.clappia.com`)
 -  `workplace_id`: Your Clappia workplace ID
 
-**Example:**
-
-```python
-from clappia_tools import ClappiaClient
-
-client = ClappiaClient(
-    api_key="your-api-key",
-    base_url="https://api.clappia.com",
-    workplace_id="your-workplace-id"
-)
-```
 ---
 
 ## Usage
 
-### Basic Client Usage
+### SubmissionClient Example
 
 ```python
-from clappia_tools import ClappiaClient
+from clappia_api_tools.client.submission_client import SubmissionClient
 
-client = ClappiaClient(
+client = SubmissionClient(
     api_key="your-api-key",
     base_url="https://api.clappia.com",
     workplace_id="your-workplace-id"
@@ -78,69 +96,29 @@ client = ClappiaClient(
 result = client.create_submission(
     app_id="MFX093412",
     data={"employee_name": "John Doe", "department": "Engineering"},
-    email="user@example.com"
+    requesting_user_email_address="user@example.com"
 )
 print(result)
-
-# Edit a submission
-result = client.edit_submission(
-    app_id="MFX093412",
-    submission_id="HGO51464561",
-    data={"department": "Marketing"},
-    email="user@example.com"
-)
-print(result)
-
-# Get app definition
-result = client.get_app_definition(app_id="MFX093412")
-print(result)
 ```
 
-### Tool Functions
-
-You can also use the modular tool functions directly:
+### AppDefinitionClient Example
 
 ```python
-from clappia_tools._tools import (
-    create_clappia_submission,
-    edit_clappia_submission,
-    get_app_definition,
-    update_clappia_submission_owners,
-    update_clappia_submission_status,
-)
+from clappia_api_tools.client.app_definition_client import AppDefinitionClient
 
-# Create a submission
-data = {"employee_name": "Jane Doe", "department": "HR"}
-response = create_clappia_submission("MFX093412", data, "user@example.com")
-print(response)
-
-# Update submission owners
-response = update_clappia_submission_owners(
-    "MFX093412", "HGO51464561", "admin@example.com", ["user1@company.com", "user2@company.com"]
+client = AppDefinitionClient(
+    api_key="your-api-key",
+    base_url="https://api.clappia.com",
+    workplace_id="your-workplace-id"
 )
-print(response)
 
-# Update submission status
-response = update_clappia_submission_status(
-    "MFX093412", "HGO51464561", "admin@example.com", {"statusName": "Approved", "comments": "Reviewed."}
-)
-print(response)
+# Get app definition
+result = client.get_definition(app_id="MFX093412")
+print(result)
 ```
 
 ---
 
-## Available Tools
-
--  `create_clappia_submission(app_id, data, email)`
--  `edit_clappia_submission(app_id, submission_id, data, email)`
--  `get_app_definition(app_id, language="en", strip_html=True, include_tags=True)`
--  `update_clappia_submission_owners(app_id, submission_id, requesting_user_email_address, email_ids)`
--  `update_clappia_submission_status(app_id, submission_id, requesting_user_email_address, status)`
-
-See docstrings in each tool for detailed argument and return value descriptions.
-
----
-
 ## Input Validation
 
 -  **App ID**: Must be uppercase letters and numbers (e.g., `MFX093412`).
@@ -154,6 +132,8 @@ Invalid inputs will return descriptive error messages.
 
 ## Testing
 
+Before running tests, ensure your `.env` file is present in the project root with valid credentials. The test suite will load environment variables automatically.
+
 Run all tests (unit and integration):
 
 ```bash

clappia_tools/__init__.py clappia_api_tools/__init__.pyclappia_tools/__init__.py renamed to clappia_api_tools/__init__.py

@@ -6,11 +6,10 @@
 
 from .client.clappia_client import ClappiaClient
 from .client.app_definition_client import AppDefinitionClient
-from .client.app_management_client import AppManagementClient
 from .client.submission_client import SubmissionClient
 
-__version__ = "0.1.5"
-__all__ = ["ClappiaClient", "AppDefinitionClient", "AppManagementClient", "SubmissionClient"]
+__version__ = "1.0.1"
+__all__ = ["ClappiaClient", "AppDefinitionClient", "SubmissionClient"]
 
 
 def __dir__():

clappia_tools/_enums/__init__.py clappia_api_tools/_enums/__init__.pyclappia_tools/_enums/__init__.py renamed to clappia_api_tools/_enums/__init__.py

@@ -2,7 +2,7 @@
 import json
 import requests
 from typing import Optional, Dict, Any, Tuple
-from clappia_tools._utils.logging_utils import get_logger
+from clappia_api_tools._utils.logging_utils import get_logger
 
 logger = get_logger(__name__)
 

clappia_tools/_enums/enums.py clappia_api_tools/_enums/enums.pyclappia_tools/_enums/enums.py renamed to clappia_api_tools/_enums/enums.py

@@ -1,6 +1,6 @@
 import re
 from typing import Tuple, List
-from clappia_tools._models.model import Section
+from clappia_api_tools._models.model import Section
 
 class ClappiaInputValidator:
     """Validates user inputs like app IDs, emails, etc."""