aiondtech 2.1.0__tar.gz → 2.2.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aiondtech
-Version: 2.1.0
+Version: 2.2.0
 Summary: Official Python SDK for AiondTech Resume Analyser API
 Author-email: AiondTech <support@aiondtech.com>
 Maintainer-email: AiondTech <support@aiondtech.com>
@@ -77,19 +77,31 @@ client = ResumeAnalyser(api_key="your-api-key", production=True)
 
 ## API Endpoints
 
+Credit usage varies depending on resume size and complexity. Every response includes the actual `credits_used` — always check it for accurate tracking.
+
 | Method | Credits | Description |
 |--------|---------|-------------|
-| `resumes.upload()` | 1 | Upload PDF resume |
-| `resumes.upload_and_analyze()` | 3 | Upload + AI parsing |
-| `resumes.upload_analyze_compare()` | 6 | Upload + parse + compare to job |
-| `resumes.analyze()` | 2 | Parse existing resume by ID |
-| `resumes.compare_resumes()` | 3 | Compare resume to job |
+| `resumes.upload()` | Varies | Upload PDF resume |
+| `resumes.upload_and_analyze()` | Varies | Upload + AI parsing |
+| `resumes.upload_analyze_compare()` | Varies | Upload + parse + compare to job |
+| `resumes.analyze()` | Varies | Parse existing resume by ID |
+| `resumes.compare_resumes()` | Varies | Compare resume to job |
 | `resumes.list()` | 0 | List all resumes |
-| `jobs.create()` | 1 | Create job posting |
+| `jobs.create()` | Varies | Create job posting |
 | `jobs.list()` | 0 | List all jobs |
 | `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
@@ -107,7 +119,7 @@ result = client.resumes.upload("path/to/resume.pdf")
 ```python
 result.resume_id     # int — Unique resume ID
 result.message       # str — "Resume uploaded successfully"
-result.credits_used  # int — 1
+result.credits_used  # int — Credits consumed by this call
 result._raw          # dict — Full raw API response
 ```
 
@@ -126,7 +138,7 @@ result = client.resumes.upload_and_analyze("path/to/resume.pdf")
 ```python
 result.resume_id     # int — Unique resume ID
 result.parsed_data   # dict — Full parsed data (see structure below)
-result.credits_used  # int — 3
+result.credits_used  # int — Credits consumed by this call
 result._raw          # dict — Full raw API response
 
 # Convenience properties
@@ -175,7 +187,7 @@ 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 — 6
+result.credits_used      # int — Credits consumed by this call
 result._raw              # dict — Full raw API response
 ```
 
@@ -195,7 +207,7 @@ result = client.resumes.analyze(resume_id=123)
 result.resume_id     # int — Resume ID
 result.partner       # str — Partner identifier
 result.parsed_data   # dict — Full parsed data
-result.credits_used  # int — 2
+result.credits_used  # int — Credits consumed by this call
 result._raw          # dict — Full raw API response
 
 # Convenience properties
@@ -233,7 +245,7 @@ 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 — 1
+job.credits_used # int — Credits consumed by this call
 job._raw         # dict — Full raw API response
 ```
 
@@ -254,8 +266,7 @@ 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.language          # str | None — Detected language (e.g. "en", "ar")
-result.credits_used      # int — 3
+result.credits_used      # int — Credits consumed by this call
 result._raw              # dict — Full raw API response
 ```
 
@@ -391,12 +402,14 @@ job = client.jobs.create(
     description="5+ years Python, Django, AWS, PostgreSQL required..."
 )
 print(f"Created job #{job.job_id}: {job.title}")
+print(f"Credits used: {job.credits_used}")
 
 # Step 2: Upload and analyze a resume
 analysis = client.resumes.upload_and_analyze("candidate_resume.pdf")
 print(f"Candidate: {analysis.full_name}")
 print(f"Skills: {', '.join(analysis.skills)}")
 print(f"Experience: {analysis.total_experience}")
+print(f"Credits used: {analysis.credits_used}")
 
 # Step 3: Compare resume to job
 comparison = client.resumes.compare_resumes(
@@ -406,6 +419,7 @@ comparison = client.resumes.compare_resumes(
 print(f"Score: {comparison.comparison_score}%")
 print(f"Language: {comparison.language}")
 print(f"Reasoning: {comparison.comparison_reason}")
+print(f"Credits used: {comparison.credits_used}")
 
 # Step 4: Check remaining credits
 balance = client.credits.balance()
@@ -417,6 +431,7 @@ print(f"Credits remaining: {balance['remaining']}")
 ```python
 result = client.resumes.upload_analyze_compare("resume.pdf", job_id=job.job_id)
 print(f"Score: {result.comparison_score}% — {result.comparison_reason}")
+print(f"Credits used: {result.credits_used}")
 ```
 
 ### Batch Processing
@@ -426,18 +441,22 @@ import os
 
 job = client.jobs.create("Data Scientist", "ML, Python, statistics...")
 
+total_credits = job.credits_used
 results = []
+
 for pdf in os.listdir("resumes/"):
     if pdf.endswith(".pdf"):
         r = client.resumes.upload_analyze_compare(
             f"resumes/{pdf}", job_id=job.job_id
         )
         results.append(r)
-        print(f"{r.comparison_score:5.1f}% — {pdf}")
+        total_credits += r.credits_used
+        print(f"{r.comparison_score:5.1f}% — {pdf} ({r.credits_used} credits)")
 
 # Sort by score
 results.sort(key=lambda x: x.comparison_score, reverse=True)
 print(f"\nTop candidate: resume_id={results[0].resume_id} ({results[0].comparison_score}%)")
+print(f"Total credits used: {total_credits}")
 ```
 
 ---

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

@@ -41,19 +41,31 @@ client = ResumeAnalyser(api_key="your-api-key", production=True)
 
 ## API Endpoints
 
+Credit usage varies depending on resume size and complexity. Every response includes the actual `credits_used` — always check it for accurate tracking.
+
 | Method | Credits | Description |
 |--------|---------|-------------|
-| `resumes.upload()` | 1 | Upload PDF resume |
-| `resumes.upload_and_analyze()` | 3 | Upload + AI parsing |
-| `resumes.upload_analyze_compare()` | 6 | Upload + parse + compare to job |
-| `resumes.analyze()` | 2 | Parse existing resume by ID |
-| `resumes.compare_resumes()` | 3 | Compare resume to job |
+| `resumes.upload()` | Varies | Upload PDF resume |
+| `resumes.upload_and_analyze()` | Varies | Upload + AI parsing |
+| `resumes.upload_analyze_compare()` | Varies | Upload + parse + compare to job |
+| `resumes.analyze()` | Varies | Parse existing resume by ID |
+| `resumes.compare_resumes()` | Varies | Compare resume to job |
 | `resumes.list()` | 0 | List all resumes |
-| `jobs.create()` | 1 | Create job posting |
+| `jobs.create()` | Varies | Create job posting |
 | `jobs.list()` | 0 | List all jobs |
 | `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
@@ -71,7 +83,7 @@ result = client.resumes.upload("path/to/resume.pdf")
 ```python
 result.resume_id     # int — Unique resume ID
 result.message       # str — "Resume uploaded successfully"
-result.credits_used  # int — 1
+result.credits_used  # int — Credits consumed by this call
 result._raw          # dict — Full raw API response
 ```
 
@@ -90,7 +102,7 @@ result = client.resumes.upload_and_analyze("path/to/resume.pdf")
 ```python
 result.resume_id     # int — Unique resume ID
 result.parsed_data   # dict — Full parsed data (see structure below)
-result.credits_used  # int — 3
+result.credits_used  # int — Credits consumed by this call
 result._raw          # dict — Full raw API response
 
 # Convenience properties
@@ -139,7 +151,7 @@ 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 — 6
+result.credits_used      # int — Credits consumed by this call
 result._raw              # dict — Full raw API response
 ```
 
@@ -159,7 +171,7 @@ result = client.resumes.analyze(resume_id=123)
 result.resume_id     # int — Resume ID
 result.partner       # str — Partner identifier
 result.parsed_data   # dict — Full parsed data
-result.credits_used  # int — 2
+result.credits_used  # int — Credits consumed by this call
 result._raw          # dict — Full raw API response
 
 # Convenience properties
@@ -197,7 +209,7 @@ 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 — 1
+job.credits_used # int — Credits consumed by this call
 job._raw         # dict — Full raw API response
 ```
 
@@ -218,8 +230,7 @@ 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.language          # str | None — Detected language (e.g. "en", "ar")
-result.credits_used      # int — 3
+result.credits_used      # int — Credits consumed by this call
 result._raw              # dict — Full raw API response
 ```
 
@@ -355,12 +366,14 @@ job = client.jobs.create(
     description="5+ years Python, Django, AWS, PostgreSQL required..."
 )
 print(f"Created job #{job.job_id}: {job.title}")
+print(f"Credits used: {job.credits_used}")
 
 # Step 2: Upload and analyze a resume
 analysis = client.resumes.upload_and_analyze("candidate_resume.pdf")
 print(f"Candidate: {analysis.full_name}")
 print(f"Skills: {', '.join(analysis.skills)}")
 print(f"Experience: {analysis.total_experience}")
+print(f"Credits used: {analysis.credits_used}")
 
 # Step 3: Compare resume to job
 comparison = client.resumes.compare_resumes(
@@ -370,6 +383,7 @@ comparison = client.resumes.compare_resumes(
 print(f"Score: {comparison.comparison_score}%")
 print(f"Language: {comparison.language}")
 print(f"Reasoning: {comparison.comparison_reason}")
+print(f"Credits used: {comparison.credits_used}")
 
 # Step 4: Check remaining credits
 balance = client.credits.balance()
@@ -381,6 +395,7 @@ print(f"Credits remaining: {balance['remaining']}")
 ```python
 result = client.resumes.upload_analyze_compare("resume.pdf", job_id=job.job_id)
 print(f"Score: {result.comparison_score}% — {result.comparison_reason}")
+print(f"Credits used: {result.credits_used}")
 ```
 
 ### Batch Processing
@@ -390,18 +405,22 @@ import os
 
 job = client.jobs.create("Data Scientist", "ML, Python, statistics...")
 
+total_credits = job.credits_used
 results = []
+
 for pdf in os.listdir("resumes/"):
     if pdf.endswith(".pdf"):
         r = client.resumes.upload_analyze_compare(
             f"resumes/{pdf}", job_id=job.job_id
         )
         results.append(r)
-        print(f"{r.comparison_score:5.1f}% — {pdf}")
+        total_credits += r.credits_used
+        print(f"{r.comparison_score:5.1f}% — {pdf} ({r.credits_used} credits)")
 
 # Sort by score
 results.sort(key=lambda x: x.comparison_score, reverse=True)
 print(f"\nTop candidate: resume_id={results[0].resume_id} ({results[0].comparison_score}%)")
+print(f"Total credits used: {total_credits}")
 ```
 
 ---
@@ -434,4 +453,4 @@ client = ResumeAnalyser()
 
 ## License
 
-MIT License - see [LICENSE](LICENSE) for details.
+MIT License - see [LICENSE](LICENSE) for details.

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

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