rxresume-python 0.2.0__py3-none-any.whl → 0.3.0__py3-none-any.whl

reactive_resume/api/__init__.py

@@ -2,10 +2,25 @@
 
 from .auth import AuthAPI, AsyncAuthAPI
 from .resumes import ResumesAPI, AsyncResumesAPI
+from .applications import ApplicationsAPI, AsyncApplicationsAPI
+from .statistics import StatisticsAPI, AsyncStatisticsAPI
+from .storage import StorageAPI, AsyncStorageAPI
+from .agent import AgentAPI, AsyncAgentAPI
+from .ai_providers import AiProvidersAPI, AsyncAiProvidersAPI
 
 __all__ = [
     "AuthAPI",
     "AsyncAuthAPI",
     "ResumesAPI",
     "AsyncResumesAPI",
+    "ApplicationsAPI",
+    "AsyncApplicationsAPI",
+    "StatisticsAPI",
+    "AsyncStatisticsAPI",
+    "StorageAPI",
+    "AsyncStorageAPI",
+    "AgentAPI",
+    "AsyncAgentAPI",
+    "AiProvidersAPI",
+    "AsyncAiProvidersAPI",
 ]

reactive_resume/api/agent.py

@@ -0,0 +1,37 @@
+"""Agent API endpoints implementation."""
+
+from ..models.agent import AgentRequest, AgentResponse
+
+
+class AgentAPI:
+    """Synchronous AI Agent operations."""
+
+    def __init__(self, client) -> None:
+        self._client = client
+
+    def chat(self, resume_id: str, prompt: str) -> AgentResponse:
+        """Send a prompt to the AI Agent relative to a specific resume context."""
+        payload = AgentRequest(prompt=prompt).model_dump()
+        response = self._client._request(
+            "POST",
+            f"/api/openapi/agent/{resume_id}/chat",
+            json=payload,
+        )
+        return AgentResponse.model_validate(response)
+
+
+class AsyncAgentAPI:
+    """Asynchronous AI Agent operations."""
+
+    def __init__(self, client) -> None:
+        self._client = client
+
+    async def chat(self, resume_id: str, prompt: str) -> AgentResponse:
+        """Send a prompt to the AI Agent asynchronously relative to a specific resume context."""
+        payload = AgentRequest(prompt=prompt).model_dump()
+        response = await self._client._request(
+            "POST",
+            f"/api/openapi/agent/{resume_id}/chat",
+            json=payload,
+        )
+        return AgentResponse.model_validate(response)

reactive_resume/api/ai_providers.py

@@ -0,0 +1,31 @@
+"""AI Providers API endpoints implementation."""
+
+from typing import List, Dict, Any
+
+
+class AiProvidersAPI:
+    """Synchronous AI Providers operations."""
+
+    def __init__(self, client) -> None:
+        self._client = client
+
+    def list(self) -> List[Dict[str, Any]]:
+        """List all configured AI Providers."""
+        response = self._client._request("GET", "/api/openapi/ai-providers")
+        if isinstance(response, list):
+            return response
+        return [response]
+
+
+class AsyncAiProvidersAPI:
+    """Asynchronous AI Providers operations."""
+
+    def __init__(self, client) -> None:
+        self._client = client
+
+    async def list(self) -> List[Dict[str, Any]]:
+        """List all configured AI Providers asynchronously."""
+        response = await self._client._request("GET", "/api/openapi/ai-providers")
+        if isinstance(response, list):
+            return response
+        return [response]

reactive_resume/api/applications.py

@@ -0,0 +1,78 @@
+"""Applications API endpoints implementation."""
+
+from typing import List, Dict, Any
+from ..models.application import Application, ApplicationCreate
+
+
+class ApplicationsAPI:
+    """Synchronous Applications operations."""
+
+    def __init__(self, client) -> None:
+        self._client = client
+
+    def list(self) -> List[Application]:
+        """List all job applications."""
+        response = self._client._request("GET", "/api/openapi/applications")
+        if isinstance(response, dict) and "data" in response:
+            items = response["data"]
+        else:
+            items = response
+        return [Application.model_validate(item) for item in items]
+
+    def get(self, app_id: str) -> Application:
+        """Retrieve a specific job application by ID."""
+        response = self._client._request("GET", f"/api/openapi/applications/{app_id}")
+        return Application.model_validate(response)
+
+    def create(self, data: ApplicationCreate) -> Application:
+        """Log/create a new job application."""
+        payload = data.model_dump(by_alias=True, exclude_none=True)
+        response = self._client._request("POST", "/api/openapi/applications", json=payload)
+        return Application.model_validate(response)
+
+    def update(self, app_id: str, data: Dict[str, Any]) -> Application:
+        """Update an existing job application."""
+        response = self._client._request("PATCH", f"/api/openapi/applications/{app_id}", json=data)
+        return Application.model_validate(response)
+
+    def delete(self, app_id: str) -> None:
+        """Delete a job application by ID."""
+        self._client._request("DELETE", f"/api/openapi/applications/{app_id}")
+
+
+class AsyncApplicationsAPI:
+    """Asynchronous Applications operations."""
+
+    def __init__(self, client) -> None:
+        self._client = client
+
+    async def list(self) -> List[Application]:
+        """List all job applications asynchronously."""
+        response = await self._client._request("GET", "/api/openapi/applications")
+        if isinstance(response, dict) and "data" in response:
+            items = response["data"]
+        else:
+            items = response
+        return [Application.model_validate(item) for item in items]
+
+    async def get(self, app_id: str) -> Application:
+        """Retrieve a specific job application by ID asynchronously."""
+        response = await self._client._request("GET", f"/api/openapi/applications/{app_id}")
+        return Application.model_validate(response)
+
+    async def create(self, data: ApplicationCreate) -> Application:
+        """Log/create a new job application asynchronously."""
+        payload = data.model_dump(by_alias=True, exclude_none=True)
+        response = await self._client._request("POST", "/api/openapi/applications", json=payload)
+        return Application.model_validate(response)
+
+    async def update(self, app_id: str, data: Dict[str, Any]) -> Application:
+        """Update an existing job application asynchronously."""
+        response = await self._client._request(
+            "PATCH", f"/api/openapi/applications/{app_id}", json=data
+        )
+        return Application.model_validate(response)
+
+    async def delete(self, app_id: str) -> None:
+        """Delete a job application by ID asynchronously."""
+        await self._client._request("DELETE", f"/api/openapi/applications/{app_id}")

reactive_resume/api/statistics.py

@@ -0,0 +1,27 @@
+"""Statistics API endpoints implementation."""
+
+from ..models.statistics import ResumeStats
+
+
+class StatisticsAPI:
+    """Synchronous Statistics operations."""
+
+    def __init__(self, client) -> None:
+        self._client = client
+
+    def get(self, resume_id: str) -> ResumeStats:
+        """Retrieve interaction statistics for a specific resume."""
+        response = self._client._request("GET", f"/api/openapi/statistics/{resume_id}")
+        return ResumeStats.model_validate(response)
+
+
+class AsyncStatisticsAPI:
+    """Asynchronous Statistics operations."""
+
+    def __init__(self, client) -> None:
+        self._client = client
+
+    async def get(self, resume_id: str) -> ResumeStats:
+        """Retrieve interaction statistics for a specific resume asynchronously."""
+        response = await self._client._request("GET", f"/api/openapi/statistics/{resume_id}")
+        return ResumeStats.model_validate(response)

reactive_resume/api/storage.py

@@ -0,0 +1,53 @@
+"""Storage API endpoints implementation."""
+
+from ..models.storage import StorageFile
+
+
+class StorageAPI:
+    """Synchronous Storage operations."""
+
+    def __init__(self, client) -> None:
+        self._client = client
+
+    def upload_file(self, file_content: bytes, filename: str) -> StorageFile:
+        """Upload a file to storage.
+
+        Args:
+            file_content: Raw bytes of the file.
+            filename: Target name for the uploaded file.
+
+        Returns:
+            Metadata details of the uploaded file.
+        """
+        files = {"file": (filename, file_content)}
+        response = self._client._request(
+            "POST",
+            "/api/openapi/storage/upload",
+            files=files,
+        )
+        return StorageFile.model_validate(response)
+
+
+class AsyncStorageAPI:
+    """Asynchronous Storage operations."""
+
+    def __init__(self, client) -> None:
+        self._client = client
+
+    async def upload_file(self, file_content: bytes, filename: str) -> StorageFile:
+        """Upload a file to storage asynchronously.
+
+        Args:
+            file_content: Raw bytes of the file.
+            filename: Target name for the uploaded file.
+
+        Returns:
+            Metadata details of the uploaded file.
+        """
+        files = {"file": (filename, file_content)}
+        response = await self._client._request(
+            "POST",
+            "/api/openapi/storage/upload",
+            files=files,
+        )
+        return StorageFile.model_validate(response)

reactive_resume/core/async_client.py

@@ -11,6 +11,11 @@ from .exceptions import (
 )
 from ..api.auth import AsyncAuthAPI
 from ..api.resumes import AsyncResumesAPI
+from ..api.applications import AsyncApplicationsAPI
+from ..api.statistics import AsyncStatisticsAPI
+from ..api.storage import AsyncStorageAPI
+from ..api.agent import AsyncAgentAPI
+from ..api.ai_providers import AsyncAiProvidersAPI
 
 
 class AsyncRxResumeClient:
@@ -57,6 +62,11 @@ class AsyncRxResumeClient:
         # Initialize API sections
         self.auth = AsyncAuthAPI(self)
         self.resumes = AsyncResumesAPI(self)
+        self.applications = AsyncApplicationsAPI(self)
+        self.statistics = AsyncStatisticsAPI(self)
+        self.storage = AsyncStorageAPI(self)
+        self.agent = AsyncAgentAPI(self)
+        self.ai_providers = AsyncAiProvidersAPI(self)
 
     def set_token(self, token: str) -> None:
         """Update client headers with a new Bearer token."""

reactive_resume/core/client.py

@@ -11,6 +11,11 @@ from .exceptions import (
 )
 from ..api.auth import AuthAPI
 from ..api.resumes import ResumesAPI
+from ..api.applications import ApplicationsAPI
+from ..api.statistics import StatisticsAPI
+from ..api.storage import StorageAPI
+from ..api.agent import AgentAPI
+from ..api.ai_providers import AiProvidersAPI
 
 
 class RxResumeClient:
@@ -57,6 +62,11 @@ class RxResumeClient:
         # Initialize API sections
         self.auth = AuthAPI(self)
         self.resumes = ResumesAPI(self)
+        self.applications = ApplicationsAPI(self)
+        self.statistics = StatisticsAPI(self)
+        self.storage = StorageAPI(self)
+        self.agent = AgentAPI(self)
+        self.ai_providers = AiProvidersAPI(self)
 
     def set_token(self, token: str) -> None:
         """Update client headers with a new Bearer token."""

reactive_resume/models/__init__.py

@@ -24,6 +24,11 @@ from .resume import (
     ResumeImportData,
 )
 
+from .application import Application, ApplicationCreate
+from .statistics import ResumeStats
+from .storage import StorageFile
+from .agent import AgentRequest, AgentResponse
+
 __all__ = [
     "User",
     "URLModel",
@@ -46,4 +51,10 @@ __all__ = [
     "ResumeData",
     "Resume",
     "ResumeImportData",
+    "Application",
+    "ApplicationCreate",
+    "ResumeStats",
+    "StorageFile",
+    "AgentRequest",
+    "AgentResponse",
 ]

reactive_resume/models/agent.py

@@ -0,0 +1,15 @@
+"""Pydantic models representing AI Agent communication in Reactive Resume."""
+
+from pydantic import BaseModel
+
+
+class AgentRequest(BaseModel):
+    """Payload to send to the AI Agent."""
+
+    prompt: str
+
+
+class AgentResponse(BaseModel):
+    """Response returned by the AI Agent."""
+
+    response: str

reactive_resume/models/application.py

@@ -0,0 +1,33 @@
+"""Pydantic models representing job applications in Reactive Resume."""
+
+from pydantic import BaseModel, Field, ConfigDict
+from datetime import datetime
+from typing import Optional
+
+
+class Application(BaseModel):
+    """Represents a job application in the tracker."""
+
+    model_config = ConfigDict(populate_by_name=True)
+
+    id: str
+    user_id: str = Field(..., alias="userId")
+    company: str
+    position: str
+    stage: str = "Applied"  # Applied, Interviewing, Offered, Rejected
+    date: datetime
+    summary: str = ""
+    url: str = ""
+    created_at: datetime = Field(..., alias="createdAt")
+    updated_at: datetime = Field(..., alias="updatedAt")
+
+
+class ApplicationCreate(BaseModel):
+    """Payload to log/create a new job application."""
+
+    company: str
+    position: str
+    stage: Optional[str] = "Applied"
+    date: Optional[datetime] = None
+    summary: Optional[str] = ""
+    url: Optional[str] = ""

reactive_resume/models/statistics.py

@@ -0,0 +1,14 @@
+"""Pydantic models representing resume interaction statistics."""
+
+from pydantic import BaseModel, ConfigDict
+from typing import Dict, Any
+
+
+class ResumeStats(BaseModel):
+    """Represents view and download statistics for a resume."""
+
+    model_config = ConfigDict(populate_by_name=True)
+
+    views: int = 0
+    downloads: int = 0
+    history: Dict[str, Any] = {}

reactive_resume/models/storage.py

@@ -0,0 +1,14 @@
+"""Pydantic models representing storage files in Reactive Resume."""
+
+from pydantic import BaseModel, Field, ConfigDict
+
+
+class StorageFile(BaseModel):
+    """Represents a file/blob uploaded to Reactive Resume storage."""
+
+    model_config = ConfigDict(populate_by_name=True)
+
+    filename: str
+    url: str
+    size: int
+    mime_type: str = Field(..., alias="mimeType")

{rxresume_python-0.2.0.dist-info → rxresume_python-0.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rxresume-python
-Version: 0.2.0
+Version: 0.3.0
 Summary: Unofficial Python API client (SDK) for Reactive Resume v4
 Author: Ata Can Yaymacı
 License: MIT
@@ -42,10 +42,12 @@ It supports both synchronous (`httpx.Client`) and asynchronous (`httpx.AsyncClie
 ## Features
 
 - **Dual client modes**: Support for both sync and async APIs.
-- **Type safety**: Fully typed models for Resumes, Sections, Basics, and Users using Pydantic V2.
+- **Full API coverage**: Integrated modules for Resume management, Auth, Job Tracker (Applications), AI Agent prompts, AI Providers configurations, Statistics, and Storage uploads.
+- **Type safety**: Fully typed models for all entities using Pydantic V2.
 - **Robust error handling**: Raw API status errors are automatically parsed into specific exceptions (`AuthenticationError`, `NotFoundError`, etc.).
 - **Developer Experience (DX)**: Code-completion ready with clear typing and docstrings.
 
+
 ---
 
 ## Installation
@@ -111,8 +113,36 @@ with RxResumeClient(base_url="https://rxresu.me", api_key="your_api_key") as cli
         print(f"Resume: {resume.name} (Slug: {resume.slug})")
 ```
 
+### 3. Advanced Features (AI Agent, Storage, Statistics, Applications)
+
+```python
+with RxResumeClient(base_url="https://rxresu.me", api_key="your_api_key") as client:
+    # 1. Ask the AI agent to optimize a resume summary
+    ai_response = client.agent.chat("resume_id_here", "Suggest a professional summary for a software developer.")
+    print(f"AI Suggestion: {ai_response.response}")
+
+    # 2. Upload a profile image to storage
+    with open("avatar.png", "rb") as f:
+        file_metadata = client.storage.upload_file(f.read(), "avatar.png")
+    print(f"Uploaded Image URL: {file_metadata.url}")
+
+    # 3. Retrieve resume metrics
+    stats = client.statistics.get("resume_id_here")
+    print(f"Views: {stats.views}, Downloads: {stats.downloads}")
+
+    # 4. Log a new job application
+    from reactive_resume.models import ApplicationCreate
+    app = client.applications.create(ApplicationCreate(
+        company="Google",
+        position="Senior Backend Engineer",
+        stage="Interviewing"
+    ))
+    print(f"Logged Application ID: {app.id}")
+```
+
 ---
 
+
 ## Error Handling
 
 All client API calls map HTTP errors to specific exception classes:

rxresume_python-0.3.0.dist-info/RECORD

@@ -0,0 +1,25 @@
+reactive_resume/__init__.py,sha256=F5Ze9bu2L1pwIrtYLnXAXeV6cL2p72xDy5I8qnJQfPM,581
+reactive_resume/api/__init__.py,sha256=s2r4tjKHikLjXu8295otFMoOnjlJmFmxiFvZv2QR0X0,722
+reactive_resume/api/agent.py,sha256=MVGFyQXHT3Mxuwa6WqZ-qd3BJyqOJmUUkOWfojahs3E,1221
+reactive_resume/api/ai_providers.py,sha256=jEScZih5NcX0KJifgY0I3ojMvjnoPEE1-gXdS0tfBrw,928
+reactive_resume/api/applications.py,sha256=ePoDy_0abZ7Adyr0dW7QiDozbJ5wVVIWUOeYYhzaZx4,3360
+reactive_resume/api/auth.py,sha256=YkuUjWSOEhxmuY2znOmLf9b2i915I4seNblkk1icBvI,2177
+reactive_resume/api/resumes.py,sha256=fiysbrwWxIccYwSzmuI_5KdrPVSkaPLTTKMf0c-Im4c,5701
+reactive_resume/api/statistics.py,sha256=kj62qmtk2dVqsuIZE5CXaz__ARbyaE8bQ4NEcVDAeqQ,923
+reactive_resume/api/storage.py,sha256=99XzgSYLL_LiPc6sQwBhzYFg8pmbjcRYv0iqaZb7j08,1507
+reactive_resume/core/__init__.py,sha256=TXvcDN-AFX5ctGXoaqHck1eoi0jxLLBCh5J-6ySFZe8,343
+reactive_resume/core/async_client.py,sha256=vand_BXlUVUK-pC1gWB8T_XM9devyIcZBIUxAJFE_4I,5343
+reactive_resume/core/client.py,sha256=Iy6rY5E6p7oNC3WTxZeIL4CYqYr4ikTXwhhqcWpk4vs,5209
+reactive_resume/core/exceptions.py,sha256=cFOPfpmowDu4D5YSLkpnH0brUyTAvwydnwRg1-bpGl4,1124
+reactive_resume/models/__init__.py,sha256=qndsXl18lIOC9TvscDa-jrE7MByDEFF2DYSZypriWtg,1115
+reactive_resume/models/agent.py,sha256=Q9Od-Jdjv8cgj0qtxqA6pmP9NVwetGh3D2yYsLla9TM,301
+reactive_resume/models/application.py,sha256=B2_iHIVaiXr0c0-q48C3R4kNCSeiq0w4mHosd8wEfe0,922
+reactive_resume/models/resume.py,sha256=BoBkk77v_eEBIrHUCqBiYQrQEsm3VXUtIc1bQpn8hrY,4620
+reactive_resume/models/statistics.py,sha256=1vIDT3NkYIX2ANisb1h1pDD9yu9VNeu4I2e4pby62VQ,365
+reactive_resume/models/storage.py,sha256=k7PNmImB6ualqVXGw-UUv9z7bXRWz1fdHW_I5cKvJxM,372
+reactive_resume/models/user.py,sha256=uR8NS0R4Dca63cEh40TjJlrgtDuPmO6TKE6VEvCKTUU,939
+rxresume_python-0.3.0.dist-info/licenses/LICENSE,sha256=Mlna-n1TpPV1TDC0tRQe0QsOMi2-5jTgvnypocbGghw,1073
+rxresume_python-0.3.0.dist-info/METADATA,sha256=-a45jKVBotz2YgE0tUfFO5-YBXqZhPAnmExIppFov5o,6090
+rxresume_python-0.3.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+rxresume_python-0.3.0.dist-info/top_level.txt,sha256=XqM8_KWS_Y5kNXEG18kAShCVtNwErO1NfCeCZ1u-INo,16
+rxresume_python-0.3.0.dist-info/RECORD,,

rxresume_python-0.2.0.dist-info/RECORD

@@ -1,16 +0,0 @@
-reactive_resume/__init__.py,sha256=F5Ze9bu2L1pwIrtYLnXAXeV6cL2p72xDy5I8qnJQfPM,581
-reactive_resume/api/__init__.py,sha256=t4sq_czaOLuPxyMhnXFoFTAWsr3qidF5i3RTlESRn8M,221
-reactive_resume/api/auth.py,sha256=YkuUjWSOEhxmuY2znOmLf9b2i915I4seNblkk1icBvI,2177
-reactive_resume/api/resumes.py,sha256=fiysbrwWxIccYwSzmuI_5KdrPVSkaPLTTKMf0c-Im4c,5701
-reactive_resume/core/__init__.py,sha256=TXvcDN-AFX5ctGXoaqHck1eoi0jxLLBCh5J-6ySFZe8,343
-reactive_resume/core/async_client.py,sha256=n779xddhVoWhzta3_SdDom0hRPBH5sbH20xR02B5j7Y,4866
-reactive_resume/core/client.py,sha256=XfPqleKefk7A0VxXjSydWIWuwwuPMFdEfzJUrmaf_Ps,4782
-reactive_resume/core/exceptions.py,sha256=cFOPfpmowDu4D5YSLkpnH0brUyTAvwydnwRg1-bpGl4,1124
-reactive_resume/models/__init__.py,sha256=OFiJN0Aep4gKOKn0vVSg6AzMDL8_hvWi3ZazE5ys0u4,819
-reactive_resume/models/resume.py,sha256=BoBkk77v_eEBIrHUCqBiYQrQEsm3VXUtIc1bQpn8hrY,4620
-reactive_resume/models/user.py,sha256=uR8NS0R4Dca63cEh40TjJlrgtDuPmO6TKE6VEvCKTUU,939
-rxresume_python-0.2.0.dist-info/licenses/LICENSE,sha256=Mlna-n1TpPV1TDC0tRQe0QsOMi2-5jTgvnypocbGghw,1073
-rxresume_python-0.2.0.dist-info/METADATA,sha256=y7gujS_S9vboAuIAqu2BRWYwOb1OJKVw8wT392wyQz8,4873
-rxresume_python-0.2.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
-rxresume_python-0.2.0.dist-info/top_level.txt,sha256=XqM8_KWS_Y5kNXEG18kAShCVtNwErO1NfCeCZ1u-INo,16
-rxresume_python-0.2.0.dist-info/RECORD,,