Open-EO / openeo-python-client

Python client API for OpenEO
https://open-eo.github.io/openeo-python-client/
Apache License 2.0
155 stars 42 forks source link

job manager: rename `start_job` callable to `create_job` #647

Open soxofaan opened 3 weeks ago

soxofaan commented 3 weeks ago

MultiBackendJobManager.run_jobs has a start_job callable to create a job and, as suggested by its name, to start it too. However, blindly starting each job on creation is actually an anti-pattern with the job manager (which knows better when to start jobs, based on capacity).

We should rename start_job to create_job to make the better usage pattern more obvious

soxofaan commented 3 weeks ago

FYI I think we can do this rename while keeping start_job support for some time. We're already doing that with output_file
https://github.com/Open-EO/openeo-python-client/blob/7c321be49bcf6f1dbd091f5f4f4ea1c0163ed7e5/openeo/extra/job_management.py#L450-L457