deadline-suggester
Realistic job deadline recommendations for freelance and contract workflows.
pip install deadline-suggester
Python 3.9+
Overview
deadline-suggester analyzes job specifications and historical completion data to recommend achievable deadlines, accounting for agent availability and rush pricing.
Quick Start
from deadline_suggester import DeadlineSuggesterClient, JobSpecification
client = DeadlineSuggesterClient()
job = JobSpecification( job_type="translation", complexity="medium", word_count=2000, attachments=1, budget_usd=150.0, preferred_deadline_hours=24.0, )
recommendation = client.recommend(job) print(recommendation.suggested_deadline) print(recommendation.recommended_hours)
API Reference
JobSpecification
Describes the job to be evaluated.
| Parameter | Type | Description |
|---|---|---|
job_type |
str |
Category of work |
complexity |
str |
low, medium, or high |
word_count |
int | None |
Optional word count |
attachments |
int |
Number of attachments |
budget_usd |
float |
Job budget in USD |
preferred_deadline_hours |
float | None |
Client preferred deadline |
DeadlineSuggesterClient Methods
| Method | Description |
|---|---|
recommend(job) |
Returns a DeadlineRecommendation for the given JobSpecification |
record_completion(job, actual_hours) |
Records actual completion time to improve future estimates |
estimate_availability() |
Returns an AgentAvailability snapshot |
rush_premium(job) |
Returns the rush multiplier for expedited delivery |
License
MIT
Metadata
Release files for deadline-suggester 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| deadline_suggester-1.0.0.tar.gz | 3.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| deadline_suggester-1.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 8.3 kB
Release files / deadline_suggester-1.0.0.tar.gz
| Download URL | deadline_suggester-1.0.0.tar.gz |
|---|---|
| Size | 3.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3e6ac602b169186d0d2fcaff26dd7a1129b197c61b695e44aed59e7666d70c3b
|
|
BLAKE2b-256 checksum How to use checksums |
ab1ccad1123ddbd71adb223f9bace328dd91ae102d7cc7dfeae4365c796bd93e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.12
|
Release files / deadline_suggester-1.0.0-py3-none-any.whl
| Download URL | deadline_suggester-1.0.0-py3-none-any.whl |
|---|---|
| Size | 4.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
daa3731ee905f5c2ffda14a0c74b53c40b0e61dd4ab9461ec8a2ab305f1ead5d
|
|
BLAKE2b-256 checksum How to use checksums |
85f2da3f69f0f818f470334f4abdecf84aef0df20ad0d8a4f2353b5a317d2f0f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.12
|