aiondtech 2.2.0__tar.gz → 2.3.0__tar.gz

{aiondtech-2.2.0 → aiondtech-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aiondtech
-Version: 2.2.0
+Version: 2.3.0
 Summary: Official Python SDK for AiondTech Resume Analyser API
 Author-email: AiondTech <support@aiondtech.com>
 Maintainer-email: AiondTech <support@aiondtech.com>
@@ -92,16 +92,6 @@ Credit usage varies depending on resume size and complexity. Every response incl
 | `credits.balance()` | 0 | Check credit balance |
 | `credits.usage()` | 0 | View usage history |
 
-**Tracking credits:**
-
-```python
-result = client.resumes.upload_and_analyze("resume.pdf")
-print(f"This call used {result.credits_used} credits")
-
-balance = client.credits.balance()
-print(f"Remaining: {balance['remaining']}")
-```
-
 ---
 
 ## Detailed Usage
@@ -112,15 +102,18 @@ Upload a PDF resume without parsing. Returns a `resume_id` for later use.
 
 ```python
 result = client.resumes.upload("path/to/resume.pdf")
+
+print(f"Resume ID: {result.resume_id}")
+print(f"Message: {result.message}")
+print(f"Credits Used: {result.credits_used}")
 ```
 
-**Return type:** `ResumeUploadResult`
+**Output:**
 
-```python
-result.resume_id     # int — Unique resume ID
-result.message       # str — "Resume uploaded successfully"
-result.credits_used  # int — Credits consumed by this call
-result._raw          # dict — Full raw API response
+```
+Resume ID: 450
+Message: Resume uploaded successfully
+Credits Used: 1
 ```
 
 ---
@@ -131,25 +124,31 @@ Upload a PDF and immediately extract structured data (AI-powered parsing).
 
 ```python
 result = client.resumes.upload_and_analyze("path/to/resume.pdf")
-```
 
-**Return type:** `ResumeAnalysisResult`
+print(f"Resume ID: {result.resume_id}")
+print(f"Full Name: {result.full_name}")
+print(f"Email: {result.email}")
+print(f"Skills: {result.skills}")
+print(f"Job Titles: {result.job_titles}")
+print(f"Total Experience: {result.total_experience}")
+print(f"Credits Used: {result.credits_used}")
+print(f"Parsed Data: {result.parsed_data}")
+```
 
-```python
-result.resume_id     # int — Unique resume ID
-result.parsed_data   # dict — Full parsed data (see structure below)
-result.credits_used  # int — Credits consumed by this call
-result._raw          # dict — Full raw API response
+**Output:**
 
-# Convenience properties
-result.full_name         # str | None
-result.email             # str | None
-result.skills            # list[str]
-result.job_titles        # list[str]
-result.total_experience  # str | None
+```
+Resume ID: 450
+Full Name: John Doe
+Email: john@example.com
+Skills: ['Python', 'Django', 'AWS']
+Job Titles: ['Senior Developer', 'Tech Lead']
+Total Experience: 8 years
+Credits Used: 5
+Parsed Data: {'full_name': 'John Doe', 'email': 'john@example.com', ...}
 ```
 
-**`parsed_data` structure:**
+**Full `parsed_data` structure:**
 
 ```python
 {
@@ -175,20 +174,25 @@ result.total_experience  # str | None
 Upload a resume, parse it, and compare against a job posting in one call.
 
 ```python
-result = client.resumes.upload_analyze_compare("resume.pdf", job_id=42)
+result = client.resumes.upload_analyze_compare("resume.pdf", job_id=56)
+
+print(f"Resume ID: {result.resume_id}")
+print(f"Job ID: {result.job_id}")
+print(f"Score: {result.comparison_score}")
+print(f"Reason: {result.comparison_reason}")
+print(f"Parsed Data: {result.parsed_data}")
+print(f"Credits Used: {result.credits_used}")
 ```
 
-**Return type:** `ResumeComparisonResult`
+**Output:**
 
-```python
-result.resume_id         # int — Resume ID
-result.job_id            # int — Job ID compared against
-result.comparison_score  # float — Match score (0-100)
-result.comparison_reason # str — Detailed reasoning
-result.language          # str | None — Detected language (e.g. "en", "ar")
-result.parsed_data       # dict | None — Parsed resume data
-result.credits_used      # int — Credits consumed by this call
-result._raw              # dict — Full raw API response
+```
+Resume ID: 449
+Job ID: 56
+Score: 30
+Reason: The candidate has a strong technical background...
+Parsed Data: {'full_name': 'Salem O. Ba Atya', 'email': 'Baatyaso@gmail.com', ...}
+Credits Used: 9
 ```
 
 ---
@@ -198,30 +202,43 @@ result._raw              # dict — Full raw API response
 Parse an already-uploaded resume by its ID.
 
 ```python
-result = client.resumes.analyze(resume_id=123)
+result = client.resumes.analyze(resume_id=444)
+
+print(f"Resume ID: {result.resume_id}")
+print(f"Partner: {result.partner}")
+print(f"Full Name: {result.full_name}")
+print(f"Email: {result.email}")
+print(f"Phone: {result.phone}")
+print(f"LinkedIn: {result.linkedin}")
+print(f"Location: {result.location}")
+print(f"Skills: {result.skills}")
+print(f"Job Titles: {result.job_titles}")
+print(f"Companies: {result.companies}")
+print(f"Education: {result.education}")
+print(f"Total Experience: {result.total_experience}")
+print(f"Certifications: {result.certifications}")
+print(f"Credits Used: {result.credits_used}")
+print(f"Parsed Data: {result.parsed_data}")
 ```
 
-**Return type:** `ParsedResumeResult`
+**Output:**
 
-```python
-result.resume_id     # int — Resume ID
-result.partner       # str — Partner identifier
-result.parsed_data   # dict — Full parsed data
-result.credits_used  # int — Credits consumed by this call
-result._raw          # dict — Full raw API response
-
-# Convenience properties
-result.full_name         # str | None
-result.email             # str | None
-result.phone             # str | None
-result.linkedin          # str | None
-result.location          # str | None
-result.skills            # list[str]
-result.job_titles        # list[str]
-result.companies         # list[str]
-result.education         # list[str]
-result.total_experience  # str | None
-result.certifications    # list[str]
+```
+Resume ID: 444
+Partner: your-partner-id
+Full Name: John Doe
+Email: john@example.com
+Phone: +1234567890
+LinkedIn: linkedin.com/in/johndoe
+Location: New York, NY
+Skills: ['Python', 'Django', 'AWS']
+Job Titles: ['Senior Developer', 'Tech Lead']
+Companies: ['Google', 'Meta']
+Education: ['BSc Computer Science - MIT']
+Total Experience: 8 years
+Certifications: ['AWS Certified Solutions Architect']
+Credits Used: 3
+Parsed Data: {'full_name': 'John Doe', ...}
 ```
 
 ---
@@ -235,18 +252,24 @@ job = client.jobs.create(
     title="Senior Python Developer",
     description="We are looking for an experienced Python developer..."
 )
+
+print(f"Job ID: {job.job_id}")
+print(f"Title: {job.title}")
+print(f"Description: {job.description}")
+print(f"Created By: {job.created_by}")
+print(f"Created At: {job.created_at}")
+print(f"Credits Used: {job.credits_used}")
 ```
 
-**Return type:** `JobResult`
+**Output:**
 
-```python
-job.job_id       # int — Unique job ID
-job.title        # str — Job title
-job.description  # str — Job description
-job.created_by   # str — Creator identifier
-job.created_at   # str | None — Creation timestamp
-job.credits_used # int — Credits consumed by this call
-job._raw         # dict — Full raw API response
+```
+Job ID: 57
+Title: Senior Python Developer
+Description: We are looking for an experienced Python developer...
+Created By: your-partner-id
+Created At: 2026-02-06T10:30:00Z
+Credits Used: 1
 ```
 
 ---
@@ -256,18 +279,25 @@ job._raw         # dict — Full raw API response
 Compare an existing resume against an existing job posting.
 
 ```python
-result = client.resumes.compare_resumes(resume_id=123, job_id=456)
+result = client.resumes.compare_resumes(resume_id=445, job_id=56)
+
+print(f"Resume ID: {result.resume_id}")
+print(f"Job ID: {result.job_id}")
+print(f"Score: {result.comparison_score}")
+print(f"Reason: {result.comparison_reason}")
+print(f"Language: {result.language}")
+print(f"Credits Used: {result.credits_used}")
 ```
 
-**Return type:** `ResumeComparisonResult`
+**Output:**
 
-```python
-result.resume_id         # int — Resume ID
-result.job_id            # int — Job ID
-result.comparison_score  # float — Match score (0-100)
-result.comparison_reason # str — Detailed reasoning
-result.credits_used      # int — Credits consumed by this call
-result._raw              # dict — Full raw API response
+```
+Resume ID: 445
+Job ID: 56
+Score: 75
+Reason: The candidate demonstrates strong alignment with the role requirements...
+Language: en
+Credits Used: 5
 ```
 
 ---
@@ -278,23 +308,28 @@ List all uploaded resumes with pagination.
 
 ```python
 result = client.resumes.list(page=1, limit=50)
-```
 
-**Return type:** `ResumeListResult`
+print(f"Total: {result.total}")
+print(f"Page: {result.page}")
+print(f"Limit: {result.limit}")
+print(f"Has More: {result.has_more}")
+print(f"Count: {len(result)}")
 
-```python
-result.resumes   # list[dict] — List of resume objects
-result.total     # int — Total number of resumes
-result.page      # int — Current page
-result.limit     # int — Items per page
-result.has_more  # bool — Whether more pages exist
-result._raw      # dict — Full raw API response
-
-# Iterable
 for resume in result:
-    print(resume["id"], resume.get("full_name"))
+    print(f"  ID: {resume['id']}, Name: {resume.get('full_name')}, File: {resume.get('filename')}")
+```
 
-len(result)  # Number of resumes on this page
+**Output:**
+
+```
+Total: 120
+Page: 1
+Limit: 50
+Has More: True
+Count: 50
+  ID: 450, Name: John Doe, File: resume.pdf
+  ID: 449, Name: Salem O. Ba Atya, File: Salem_20220524.pdf
+  ...
 ```
 
 ---
@@ -305,21 +340,28 @@ List all job postings with pagination.
 
 ```python
 result = client.jobs.list(page=1, limit=50)
-```
 
-**Return type:** `JobListResult`
+print(f"Total: {result.total}")
+print(f"Page: {result.page}")
+print(f"Limit: {result.limit}")
+print(f"Has More: {result.has_more}")
+print(f"Count: {len(result)}")
 
-```python
-result.jobs      # list[dict] — List of job objects
-result.total     # int — Total number of jobs
-result.page      # int — Current page
-result.limit     # int — Items per page
-result.has_more  # bool — Whether more pages exist
-result._raw      # dict — Full raw API response
-
-# Iterable
 for job in result:
-    print(job["id"], job["title"])
+    print(f"  ID: {job['id']}, Title: {job['title']}")
+```
+
+**Output:**
+
+```
+Total: 10
+Page: 1
+Limit: 50
+Has More: False
+Count: 10
+  ID: 56, Title: Senior Python Developer
+  ID: 55, Title: Data Scientist
+  ...
 ```
 
 ---
@@ -328,18 +370,22 @@ for job in result:
 
 ```python
 balance = client.credits.balance()
+
+print(f"Total: {balance.get('total')}")
+print(f"Used This Month: {balance.get('used_mtd')}")
+print(f"Remaining: {balance.get('remaining')}")
+print(f"Plan: {balance.get('plan_name')}")
+print(f"Resets At: {balance.get('resets_at')}")
 ```
 
-**Returns:** `dict`
+**Output:**
 
-```python
-{
-    "total": 1000,
-    "used_mtd": 150,
-    "remaining": 850,
-    "plan_name": "Professional",
-    "resets_at": "2026-03-01T00:00:00Z"
-}
+```
+Total: 1000
+Used This Month: 150
+Remaining: 850
+Plan: Professional
+Resets At: 2026-03-01T00:00:00Z
 ```
 
 ---
@@ -348,8 +394,11 @@ balance = client.credits.balance()
 
 ```python
 usage = client.credits.usage()
+print(usage)
+
 # Or with date filters
 usage = client.credits.usage(start_date="2026-01-01", end_date="2026-01-31")
+print(usage)
 ```
 
 ---
@@ -401,8 +450,7 @@ job = client.jobs.create(
     title="Senior Python Developer",
     description="5+ years Python, Django, AWS, PostgreSQL required..."
 )
-print(f"Created job #{job.job_id}: {job.title}")
-print(f"Credits used: {job.credits_used}")
+print(f"Created job #{job.job_id}: {job.title} ({job.credits_used} credits)")
 
 # Step 2: Upload and analyze a resume
 analysis = client.resumes.upload_and_analyze("candidate_resume.pdf")
@@ -417,7 +465,6 @@ comparison = client.resumes.compare_resumes(
     job_id=job.job_id
 )
 print(f"Score: {comparison.comparison_score}%")
-print(f"Language: {comparison.language}")
 print(f"Reasoning: {comparison.comparison_reason}")
 print(f"Credits used: {comparison.credits_used}")
 

{aiondtech-2.2.0 → aiondtech-2.3.0}/README.md

@@ -56,16 +56,6 @@ Credit usage varies depending on resume size and complexity. Every response incl
 | `credits.balance()` | 0 | Check credit balance |
 | `credits.usage()` | 0 | View usage history |
 
-**Tracking credits:**
-
-```python
-result = client.resumes.upload_and_analyze("resume.pdf")
-print(f"This call used {result.credits_used} credits")
-
-balance = client.credits.balance()
-print(f"Remaining: {balance['remaining']}")
-```
-
 ---
 
 ## Detailed Usage
@@ -76,15 +66,18 @@ Upload a PDF resume without parsing. Returns a `resume_id` for later use.
 
 ```python
 result = client.resumes.upload("path/to/resume.pdf")
+
+print(f"Resume ID: {result.resume_id}")
+print(f"Message: {result.message}")
+print(f"Credits Used: {result.credits_used}")
 ```
 
-**Return type:** `ResumeUploadResult`
+**Output:**
 
-```python
-result.resume_id     # int — Unique resume ID
-result.message       # str — "Resume uploaded successfully"
-result.credits_used  # int — Credits consumed by this call
-result._raw          # dict — Full raw API response
+```
+Resume ID: 450
+Message: Resume uploaded successfully
+Credits Used: 1
 ```
 
 ---
@@ -95,25 +88,31 @@ Upload a PDF and immediately extract structured data (AI-powered parsing).
 
 ```python
 result = client.resumes.upload_and_analyze("path/to/resume.pdf")
-```
 
-**Return type:** `ResumeAnalysisResult`
+print(f"Resume ID: {result.resume_id}")
+print(f"Full Name: {result.full_name}")
+print(f"Email: {result.email}")
+print(f"Skills: {result.skills}")
+print(f"Job Titles: {result.job_titles}")
+print(f"Total Experience: {result.total_experience}")
+print(f"Credits Used: {result.credits_used}")
+print(f"Parsed Data: {result.parsed_data}")
+```
 
-```python
-result.resume_id     # int — Unique resume ID
-result.parsed_data   # dict — Full parsed data (see structure below)
-result.credits_used  # int — Credits consumed by this call
-result._raw          # dict — Full raw API response
+**Output:**
 
-# Convenience properties
-result.full_name         # str | None
-result.email             # str | None
-result.skills            # list[str]
-result.job_titles        # list[str]
-result.total_experience  # str | None
+```
+Resume ID: 450
+Full Name: John Doe
+Email: john@example.com
+Skills: ['Python', 'Django', 'AWS']
+Job Titles: ['Senior Developer', 'Tech Lead']
+Total Experience: 8 years
+Credits Used: 5
+Parsed Data: {'full_name': 'John Doe', 'email': 'john@example.com', ...}
 ```
 
-**`parsed_data` structure:**
+**Full `parsed_data` structure:**
 
 ```python
 {
@@ -139,20 +138,25 @@ result.total_experience  # str | None
 Upload a resume, parse it, and compare against a job posting in one call.
 
 ```python
-result = client.resumes.upload_analyze_compare("resume.pdf", job_id=42)
+result = client.resumes.upload_analyze_compare("resume.pdf", job_id=56)
+
+print(f"Resume ID: {result.resume_id}")
+print(f"Job ID: {result.job_id}")
+print(f"Score: {result.comparison_score}")
+print(f"Reason: {result.comparison_reason}")
+print(f"Parsed Data: {result.parsed_data}")
+print(f"Credits Used: {result.credits_used}")
 ```
 
-**Return type:** `ResumeComparisonResult`
+**Output:**
 
-```python
-result.resume_id         # int — Resume ID
-result.job_id            # int — Job ID compared against
-result.comparison_score  # float — Match score (0-100)
-result.comparison_reason # str — Detailed reasoning
-result.language          # str | None — Detected language (e.g. "en", "ar")
-result.parsed_data       # dict | None — Parsed resume data
-result.credits_used      # int — Credits consumed by this call
-result._raw              # dict — Full raw API response
+```
+Resume ID: 449
+Job ID: 56
+Score: 30
+Reason: The candidate has a strong technical background...
+Parsed Data: {'full_name': 'Salem O. Ba Atya', 'email': 'Baatyaso@gmail.com', ...}
+Credits Used: 9
 ```
 
 ---
@@ -162,30 +166,43 @@ result._raw              # dict — Full raw API response
 Parse an already-uploaded resume by its ID.
 
 ```python
-result = client.resumes.analyze(resume_id=123)
+result = client.resumes.analyze(resume_id=444)
+
+print(f"Resume ID: {result.resume_id}")
+print(f"Partner: {result.partner}")
+print(f"Full Name: {result.full_name}")
+print(f"Email: {result.email}")
+print(f"Phone: {result.phone}")
+print(f"LinkedIn: {result.linkedin}")
+print(f"Location: {result.location}")
+print(f"Skills: {result.skills}")
+print(f"Job Titles: {result.job_titles}")
+print(f"Companies: {result.companies}")
+print(f"Education: {result.education}")
+print(f"Total Experience: {result.total_experience}")
+print(f"Certifications: {result.certifications}")
+print(f"Credits Used: {result.credits_used}")
+print(f"Parsed Data: {result.parsed_data}")
 ```
 
-**Return type:** `ParsedResumeResult`
+**Output:**
 
-```python
-result.resume_id     # int — Resume ID
-result.partner       # str — Partner identifier
-result.parsed_data   # dict — Full parsed data
-result.credits_used  # int — Credits consumed by this call
-result._raw          # dict — Full raw API response
-
-# Convenience properties
-result.full_name         # str | None
-result.email             # str | None
-result.phone             # str | None
-result.linkedin          # str | None
-result.location          # str | None
-result.skills            # list[str]
-result.job_titles        # list[str]
-result.companies         # list[str]
-result.education         # list[str]
-result.total_experience  # str | None
-result.certifications    # list[str]
+```
+Resume ID: 444
+Partner: your-partner-id
+Full Name: John Doe
+Email: john@example.com
+Phone: +1234567890
+LinkedIn: linkedin.com/in/johndoe
+Location: New York, NY
+Skills: ['Python', 'Django', 'AWS']
+Job Titles: ['Senior Developer', 'Tech Lead']
+Companies: ['Google', 'Meta']
+Education: ['BSc Computer Science - MIT']
+Total Experience: 8 years
+Certifications: ['AWS Certified Solutions Architect']
+Credits Used: 3
+Parsed Data: {'full_name': 'John Doe', ...}
 ```
 
 ---
@@ -199,18 +216,24 @@ job = client.jobs.create(
     title="Senior Python Developer",
     description="We are looking for an experienced Python developer..."
 )
+
+print(f"Job ID: {job.job_id}")
+print(f"Title: {job.title}")
+print(f"Description: {job.description}")
+print(f"Created By: {job.created_by}")
+print(f"Created At: {job.created_at}")
+print(f"Credits Used: {job.credits_used}")
 ```
 
-**Return type:** `JobResult`
+**Output:**
 
-```python
-job.job_id       # int — Unique job ID
-job.title        # str — Job title
-job.description  # str — Job description
-job.created_by   # str — Creator identifier
-job.created_at   # str | None — Creation timestamp
-job.credits_used # int — Credits consumed by this call
-job._raw         # dict — Full raw API response
+```
+Job ID: 57
+Title: Senior Python Developer
+Description: We are looking for an experienced Python developer...
+Created By: your-partner-id
+Created At: 2026-02-06T10:30:00Z
+Credits Used: 1
 ```
 
 ---
@@ -220,18 +243,25 @@ job._raw         # dict — Full raw API response
 Compare an existing resume against an existing job posting.
 
 ```python
-result = client.resumes.compare_resumes(resume_id=123, job_id=456)
+result = client.resumes.compare_resumes(resume_id=445, job_id=56)
+
+print(f"Resume ID: {result.resume_id}")
+print(f"Job ID: {result.job_id}")
+print(f"Score: {result.comparison_score}")
+print(f"Reason: {result.comparison_reason}")
+print(f"Language: {result.language}")
+print(f"Credits Used: {result.credits_used}")
 ```
 
-**Return type:** `ResumeComparisonResult`
+**Output:**
 
-```python
-result.resume_id         # int — Resume ID
-result.job_id            # int — Job ID
-result.comparison_score  # float — Match score (0-100)
-result.comparison_reason # str — Detailed reasoning
-result.credits_used      # int — Credits consumed by this call
-result._raw              # dict — Full raw API response
+```
+Resume ID: 445
+Job ID: 56
+Score: 75
+Reason: The candidate demonstrates strong alignment with the role requirements...
+Language: en
+Credits Used: 5
 ```
 
 ---
@@ -242,23 +272,28 @@ List all uploaded resumes with pagination.
 
 ```python
 result = client.resumes.list(page=1, limit=50)
-```
 
-**Return type:** `ResumeListResult`
+print(f"Total: {result.total}")
+print(f"Page: {result.page}")
+print(f"Limit: {result.limit}")
+print(f"Has More: {result.has_more}")
+print(f"Count: {len(result)}")
 
-```python
-result.resumes   # list[dict] — List of resume objects
-result.total     # int — Total number of resumes
-result.page      # int — Current page
-result.limit     # int — Items per page
-result.has_more  # bool — Whether more pages exist
-result._raw      # dict — Full raw API response
-
-# Iterable
 for resume in result:
-    print(resume["id"], resume.get("full_name"))
+    print(f"  ID: {resume['id']}, Name: {resume.get('full_name')}, File: {resume.get('filename')}")
+```
 
-len(result)  # Number of resumes on this page
+**Output:**
+
+```
+Total: 120
+Page: 1
+Limit: 50
+Has More: True
+Count: 50
+  ID: 450, Name: John Doe, File: resume.pdf
+  ID: 449, Name: Salem O. Ba Atya, File: Salem_20220524.pdf
+  ...
 ```
 
 ---
@@ -269,21 +304,28 @@ List all job postings with pagination.
 
 ```python
 result = client.jobs.list(page=1, limit=50)
-```
 
-**Return type:** `JobListResult`
+print(f"Total: {result.total}")
+print(f"Page: {result.page}")
+print(f"Limit: {result.limit}")
+print(f"Has More: {result.has_more}")
+print(f"Count: {len(result)}")
 
-```python
-result.jobs      # list[dict] — List of job objects
-result.total     # int — Total number of jobs
-result.page      # int — Current page
-result.limit     # int — Items per page
-result.has_more  # bool — Whether more pages exist
-result._raw      # dict — Full raw API response
-
-# Iterable
 for job in result:
-    print(job["id"], job["title"])
+    print(f"  ID: {job['id']}, Title: {job['title']}")
+```
+
+**Output:**
+
+```
+Total: 10
+Page: 1
+Limit: 50
+Has More: False
+Count: 10
+  ID: 56, Title: Senior Python Developer
+  ID: 55, Title: Data Scientist
+  ...
 ```
 
 ---
@@ -292,18 +334,22 @@ for job in result:
 
 ```python
 balance = client.credits.balance()
+
+print(f"Total: {balance.get('total')}")
+print(f"Used This Month: {balance.get('used_mtd')}")
+print(f"Remaining: {balance.get('remaining')}")
+print(f"Plan: {balance.get('plan_name')}")
+print(f"Resets At: {balance.get('resets_at')}")
 ```
 
-**Returns:** `dict`
+**Output:**
 
-```python
-{
-    "total": 1000,
-    "used_mtd": 150,
-    "remaining": 850,
-    "plan_name": "Professional",
-    "resets_at": "2026-03-01T00:00:00Z"
-}
+```
+Total: 1000
+Used This Month: 150
+Remaining: 850
+Plan: Professional
+Resets At: 2026-03-01T00:00:00Z
 ```
 
 ---
@@ -312,8 +358,11 @@ balance = client.credits.balance()
 
 ```python
 usage = client.credits.usage()
+print(usage)
+
 # Or with date filters
 usage = client.credits.usage(start_date="2026-01-01", end_date="2026-01-31")
+print(usage)
 ```
 
 ---
@@ -365,8 +414,7 @@ job = client.jobs.create(
     title="Senior Python Developer",
     description="5+ years Python, Django, AWS, PostgreSQL required..."
 )
-print(f"Created job #{job.job_id}: {job.title}")
-print(f"Credits used: {job.credits_used}")
+print(f"Created job #{job.job_id}: {job.title} ({job.credits_used} credits)")
 
 # Step 2: Upload and analyze a resume
 analysis = client.resumes.upload_and_analyze("candidate_resume.pdf")
@@ -381,7 +429,6 @@ comparison = client.resumes.compare_resumes(
     job_id=job.job_id
 )
 print(f"Score: {comparison.comparison_score}%")
-print(f"Language: {comparison.language}")
 print(f"Reasoning: {comparison.comparison_reason}")
 print(f"Credits used: {comparison.credits_used}")
 

{aiondtech-2.2.0 → aiondtech-2.3.0}/aiondtech/__init__.py

@@ -31,7 +31,7 @@ Environment Variables:
     AIONDTECH_BASE_URL: Custom API URL (default: https://api.dev.aiondtech.com)
 """
 
-__version__ = "2.2.0"
+__version__ = "2.3.0"
 __author__ = "AiondTech"
 
 from .client import ResumeAnalyser, Client

{aiondtech-2.2.0 → aiondtech-2.3.0}/aiondtech/client.py

@@ -62,7 +62,7 @@ class HTTPClient:
         self.session = requests.Session()
         self.session.headers.update({
             "Accept": "application/json",
-            "User-Agent": "aiondtech-python/2.2.0",
+            "User-Agent": "aiondtech-python/2.3.0",
             "X-API-Key": api_key,
         })
     
@@ -299,10 +299,11 @@ class Resumes:
             print(f"Name: {parsed.full_name}")
             print(f"Skills: {parsed.skills}")
         """
+        form_data = {"resume_id": str(resume_id)}
         data = self._client.request(
             "POST",
             "/external/analyze-resume-by-id",
-            params={"resume_id": resume_id}
+            data=form_data
         )
         return ParsedResumeResult.from_response(data)
     
@@ -358,14 +359,14 @@ class Resumes:
             print(f"Reasoning: {result.comparison_reason}")
             print(f"Language: {result.language}")
         """
-        payload = {
-            "resume_id": resume_id,
-            "job_id": job_id
+        form_data = {
+            "resume_id": str(resume_id),
+            "job_id": str(job_id)
         }
         data = self._client.request(
             "POST",
             "/external/compare-resumes",
-            json_data=payload
+            data=form_data
         )
         return ResumeComparisonResult.from_response(data)
     

{aiondtech-2.2.0 → aiondtech-2.3.0}/aiondtech.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aiondtech
-Version: 2.2.0
+Version: 2.3.0
 Summary: Official Python SDK for AiondTech Resume Analyser API
 Author-email: AiondTech <support@aiondtech.com>
 Maintainer-email: AiondTech <support@aiondtech.com>
@@ -92,16 +92,6 @@ Credit usage varies depending on resume size and complexity. Every response incl
 | `credits.balance()` | 0 | Check credit balance |
 | `credits.usage()` | 0 | View usage history |
 
-**Tracking credits:**
-
-```python
-result = client.resumes.upload_and_analyze("resume.pdf")
-print(f"This call used {result.credits_used} credits")
-
-balance = client.credits.balance()
-print(f"Remaining: {balance['remaining']}")
-```
-
 ---
 
 ## Detailed Usage
@@ -112,15 +102,18 @@ Upload a PDF resume without parsing. Returns a `resume_id` for later use.
 
 ```python
 result = client.resumes.upload("path/to/resume.pdf")
+
+print(f"Resume ID: {result.resume_id}")
+print(f"Message: {result.message}")
+print(f"Credits Used: {result.credits_used}")
 ```
 
-**Return type:** `ResumeUploadResult`
+**Output:**
 
-```python
-result.resume_id     # int — Unique resume ID
-result.message       # str — "Resume uploaded successfully"
-result.credits_used  # int — Credits consumed by this call
-result._raw          # dict — Full raw API response
+```
+Resume ID: 450
+Message: Resume uploaded successfully
+Credits Used: 1
 ```
 
 ---
@@ -131,25 +124,31 @@ Upload a PDF and immediately extract structured data (AI-powered parsing).
 
 ```python
 result = client.resumes.upload_and_analyze("path/to/resume.pdf")
-```
 
-**Return type:** `ResumeAnalysisResult`
+print(f"Resume ID: {result.resume_id}")
+print(f"Full Name: {result.full_name}")
+print(f"Email: {result.email}")
+print(f"Skills: {result.skills}")
+print(f"Job Titles: {result.job_titles}")
+print(f"Total Experience: {result.total_experience}")
+print(f"Credits Used: {result.credits_used}")
+print(f"Parsed Data: {result.parsed_data}")
+```
 
-```python
-result.resume_id     # int — Unique resume ID
-result.parsed_data   # dict — Full parsed data (see structure below)
-result.credits_used  # int — Credits consumed by this call
-result._raw          # dict — Full raw API response
+**Output:**
 
-# Convenience properties
-result.full_name         # str | None
-result.email             # str | None
-result.skills            # list[str]
-result.job_titles        # list[str]
-result.total_experience  # str | None
+```
+Resume ID: 450
+Full Name: John Doe
+Email: john@example.com
+Skills: ['Python', 'Django', 'AWS']
+Job Titles: ['Senior Developer', 'Tech Lead']
+Total Experience: 8 years
+Credits Used: 5
+Parsed Data: {'full_name': 'John Doe', 'email': 'john@example.com', ...}
 ```
 
-**`parsed_data` structure:**
+**Full `parsed_data` structure:**
 
 ```python
 {
@@ -175,20 +174,25 @@ result.total_experience  # str | None
 Upload a resume, parse it, and compare against a job posting in one call.
 
 ```python
-result = client.resumes.upload_analyze_compare("resume.pdf", job_id=42)
+result = client.resumes.upload_analyze_compare("resume.pdf", job_id=56)
+
+print(f"Resume ID: {result.resume_id}")
+print(f"Job ID: {result.job_id}")
+print(f"Score: {result.comparison_score}")
+print(f"Reason: {result.comparison_reason}")
+print(f"Parsed Data: {result.parsed_data}")
+print(f"Credits Used: {result.credits_used}")
 ```
 
-**Return type:** `ResumeComparisonResult`
+**Output:**
 
-```python
-result.resume_id         # int — Resume ID
-result.job_id            # int — Job ID compared against
-result.comparison_score  # float — Match score (0-100)
-result.comparison_reason # str — Detailed reasoning
-result.language          # str | None — Detected language (e.g. "en", "ar")
-result.parsed_data       # dict | None — Parsed resume data
-result.credits_used      # int — Credits consumed by this call
-result._raw              # dict — Full raw API response
+```
+Resume ID: 449
+Job ID: 56
+Score: 30
+Reason: The candidate has a strong technical background...
+Parsed Data: {'full_name': 'Salem O. Ba Atya', 'email': 'Baatyaso@gmail.com', ...}
+Credits Used: 9
 ```
 
 ---
@@ -198,30 +202,43 @@ result._raw              # dict — Full raw API response
 Parse an already-uploaded resume by its ID.
 
 ```python
-result = client.resumes.analyze(resume_id=123)
+result = client.resumes.analyze(resume_id=444)
+
+print(f"Resume ID: {result.resume_id}")
+print(f"Partner: {result.partner}")
+print(f"Full Name: {result.full_name}")
+print(f"Email: {result.email}")
+print(f"Phone: {result.phone}")
+print(f"LinkedIn: {result.linkedin}")
+print(f"Location: {result.location}")
+print(f"Skills: {result.skills}")
+print(f"Job Titles: {result.job_titles}")
+print(f"Companies: {result.companies}")
+print(f"Education: {result.education}")
+print(f"Total Experience: {result.total_experience}")
+print(f"Certifications: {result.certifications}")
+print(f"Credits Used: {result.credits_used}")
+print(f"Parsed Data: {result.parsed_data}")
 ```
 
-**Return type:** `ParsedResumeResult`
+**Output:**
 
-```python
-result.resume_id     # int — Resume ID
-result.partner       # str — Partner identifier
-result.parsed_data   # dict — Full parsed data
-result.credits_used  # int — Credits consumed by this call
-result._raw          # dict — Full raw API response
-
-# Convenience properties
-result.full_name         # str | None
-result.email             # str | None
-result.phone             # str | None
-result.linkedin          # str | None
-result.location          # str | None
-result.skills            # list[str]
-result.job_titles        # list[str]
-result.companies         # list[str]
-result.education         # list[str]
-result.total_experience  # str | None
-result.certifications    # list[str]
+```
+Resume ID: 444
+Partner: your-partner-id
+Full Name: John Doe
+Email: john@example.com
+Phone: +1234567890
+LinkedIn: linkedin.com/in/johndoe
+Location: New York, NY
+Skills: ['Python', 'Django', 'AWS']
+Job Titles: ['Senior Developer', 'Tech Lead']
+Companies: ['Google', 'Meta']
+Education: ['BSc Computer Science - MIT']
+Total Experience: 8 years
+Certifications: ['AWS Certified Solutions Architect']
+Credits Used: 3
+Parsed Data: {'full_name': 'John Doe', ...}
 ```
 
 ---
@@ -235,18 +252,24 @@ job = client.jobs.create(
     title="Senior Python Developer",
     description="We are looking for an experienced Python developer..."
 )
+
+print(f"Job ID: {job.job_id}")
+print(f"Title: {job.title}")
+print(f"Description: {job.description}")
+print(f"Created By: {job.created_by}")
+print(f"Created At: {job.created_at}")
+print(f"Credits Used: {job.credits_used}")
 ```
 
-**Return type:** `JobResult`
+**Output:**
 
-```python
-job.job_id       # int — Unique job ID
-job.title        # str — Job title
-job.description  # str — Job description
-job.created_by   # str — Creator identifier
-job.created_at   # str | None — Creation timestamp
-job.credits_used # int — Credits consumed by this call
-job._raw         # dict — Full raw API response
+```
+Job ID: 57
+Title: Senior Python Developer
+Description: We are looking for an experienced Python developer...
+Created By: your-partner-id
+Created At: 2026-02-06T10:30:00Z
+Credits Used: 1
 ```
 
 ---
@@ -256,18 +279,25 @@ job._raw         # dict — Full raw API response
 Compare an existing resume against an existing job posting.
 
 ```python
-result = client.resumes.compare_resumes(resume_id=123, job_id=456)
+result = client.resumes.compare_resumes(resume_id=445, job_id=56)
+
+print(f"Resume ID: {result.resume_id}")
+print(f"Job ID: {result.job_id}")
+print(f"Score: {result.comparison_score}")
+print(f"Reason: {result.comparison_reason}")
+print(f"Language: {result.language}")
+print(f"Credits Used: {result.credits_used}")
 ```
 
-**Return type:** `ResumeComparisonResult`
+**Output:**
 
-```python
-result.resume_id         # int — Resume ID
-result.job_id            # int — Job ID
-result.comparison_score  # float — Match score (0-100)
-result.comparison_reason # str — Detailed reasoning
-result.credits_used      # int — Credits consumed by this call
-result._raw              # dict — Full raw API response
+```
+Resume ID: 445
+Job ID: 56
+Score: 75
+Reason: The candidate demonstrates strong alignment with the role requirements...
+Language: en
+Credits Used: 5
 ```
 
 ---
@@ -278,23 +308,28 @@ List all uploaded resumes with pagination.
 
 ```python
 result = client.resumes.list(page=1, limit=50)
-```
 
-**Return type:** `ResumeListResult`
+print(f"Total: {result.total}")
+print(f"Page: {result.page}")
+print(f"Limit: {result.limit}")
+print(f"Has More: {result.has_more}")
+print(f"Count: {len(result)}")
 
-```python
-result.resumes   # list[dict] — List of resume objects
-result.total     # int — Total number of resumes
-result.page      # int — Current page
-result.limit     # int — Items per page
-result.has_more  # bool — Whether more pages exist
-result._raw      # dict — Full raw API response
-
-# Iterable
 for resume in result:
-    print(resume["id"], resume.get("full_name"))
+    print(f"  ID: {resume['id']}, Name: {resume.get('full_name')}, File: {resume.get('filename')}")
+```
 
-len(result)  # Number of resumes on this page
+**Output:**
+
+```
+Total: 120
+Page: 1
+Limit: 50
+Has More: True
+Count: 50
+  ID: 450, Name: John Doe, File: resume.pdf
+  ID: 449, Name: Salem O. Ba Atya, File: Salem_20220524.pdf
+  ...
 ```
 
 ---
@@ -305,21 +340,28 @@ List all job postings with pagination.
 
 ```python
 result = client.jobs.list(page=1, limit=50)
-```
 
-**Return type:** `JobListResult`
+print(f"Total: {result.total}")
+print(f"Page: {result.page}")
+print(f"Limit: {result.limit}")
+print(f"Has More: {result.has_more}")
+print(f"Count: {len(result)}")
 
-```python
-result.jobs      # list[dict] — List of job objects
-result.total     # int — Total number of jobs
-result.page      # int — Current page
-result.limit     # int — Items per page
-result.has_more  # bool — Whether more pages exist
-result._raw      # dict — Full raw API response
-
-# Iterable
 for job in result:
-    print(job["id"], job["title"])
+    print(f"  ID: {job['id']}, Title: {job['title']}")
+```
+
+**Output:**
+
+```
+Total: 10
+Page: 1
+Limit: 50
+Has More: False
+Count: 10
+  ID: 56, Title: Senior Python Developer
+  ID: 55, Title: Data Scientist
+  ...
 ```
 
 ---
@@ -328,18 +370,22 @@ for job in result:
 
 ```python
 balance = client.credits.balance()
+
+print(f"Total: {balance.get('total')}")
+print(f"Used This Month: {balance.get('used_mtd')}")
+print(f"Remaining: {balance.get('remaining')}")
+print(f"Plan: {balance.get('plan_name')}")
+print(f"Resets At: {balance.get('resets_at')}")
 ```
 
-**Returns:** `dict`
+**Output:**
 
-```python
-{
-    "total": 1000,
-    "used_mtd": 150,
-    "remaining": 850,
-    "plan_name": "Professional",
-    "resets_at": "2026-03-01T00:00:00Z"
-}
+```
+Total: 1000
+Used This Month: 150
+Remaining: 850
+Plan: Professional
+Resets At: 2026-03-01T00:00:00Z
 ```
 
 ---
@@ -348,8 +394,11 @@ balance = client.credits.balance()
 
 ```python
 usage = client.credits.usage()
+print(usage)
+
 # Or with date filters
 usage = client.credits.usage(start_date="2026-01-01", end_date="2026-01-31")
+print(usage)
 ```
 
 ---
@@ -401,8 +450,7 @@ job = client.jobs.create(
     title="Senior Python Developer",
     description="5+ years Python, Django, AWS, PostgreSQL required..."
 )
-print(f"Created job #{job.job_id}: {job.title}")
-print(f"Credits used: {job.credits_used}")
+print(f"Created job #{job.job_id}: {job.title} ({job.credits_used} credits)")
 
 # Step 2: Upload and analyze a resume
 analysis = client.resumes.upload_and_analyze("candidate_resume.pdf")
@@ -417,7 +465,6 @@ comparison = client.resumes.compare_resumes(
     job_id=job.job_id
 )
 print(f"Score: {comparison.comparison_score}%")
-print(f"Language: {comparison.language}")
 print(f"Reasoning: {comparison.comparison_reason}")
 print(f"Credits used: {comparison.credits_used}")
 

{aiondtech-2.2.0 → aiondtech-2.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "aiondtech"
-version = "2.2.0"
+version = "2.3.0"
 description = "Official Python SDK for AiondTech Resume Analyser API"
 readme = "README.md"
 license = {text = "MIT"}