Open-EO / Open-EO/openeo-python-driver

Make openeo-processes version more explicit

Open
#240 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
12
Forks
8
Avg merge
6d 3h
Merged PRs (30d)
4

Description

In openEO there is no direct coupling between openeo API version (now at 1.2) and openeo processes version (now at 2.0).

A user has at most control over the API version they want, e.g. through the API endpoint they connect to (e.g. https://openeo.vito.be/openeo/1.1 or https://openeo.vito.be/openeo/1.2). However, last week we experienced that the processes version is quite relevant too (e.g. user was using text_merge which was renamed to text_concat` in 2.0).

Related: in #195 we also had the problem of how to introduce the 2.0 version of processes in the VITO backend, without breaking existing usage and decided to link processes 2.0 to api version 1.2.

Some ideas to improve the situation:

  • more explicitly expose what processes version is is available, e.g. through the capabilities doc
  • allow user to explicitly pick the desired process version, e.g. through the connection url: /openeo/1.2-2.0 would be api 1.2 with processes 2.0 ?

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing related issue #195 and the capabilities document mentioned in this issue. Clarify whether the desired change is to expose the available processes version, allow explicit selection through the connection URL, or both. Done means the chosen versioning behavior and compatibility expectations are specified.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
api, backend-api-design
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.