Creation of Transactional Client

[Yuvraj-Dhepe]

Hey Team,
I want to create a Client for performing the operations of Create, Update and Delete on the Stac objects.
Basically the operations that I see here: https://stac-utils.github.io/stac-fastapi/api/stac_fastapi/types/core/

I had few queries in this regards:

• 1. I am wondering, will I be able to do that by simply inheriting the BaseTransactionClient Async one or normal one and simply defining the operations. Or the class is just meant for server purposes.
• 2. What is the difference in Async and Plane Transaction Clients, apart from the async concepts, if there is anything else, which one of them should be used in which scenario
• 3. Will be great, if there are some resources, that can direct me towards implementing clients with best practices, being a newbie, I just know calling plane requests method, directly on the running server urls.

Thank you 😄

[vincentsarago]

@Yuvraj-Dhepe

I am wondering, will I be able to do that by simply inheriting the BaseTransactionClient Async one or normal one and simply defining the operations. Or the class is just meant for server purposes.

you can have a look at https://github.com/stac-utils/stac-fastapi-pgstac/blob/df4c12abdc2a4cb016e57d5da88423fa97e32fad/stac_fastapi/pgstac/transactions.py#L68-L204

What is the difference in Async and Plane Transaction Clients, apart from the async concepts, if there is anything else, which one of them should be used in which scenario

nothing else than just being async

Will be great, if there are some resources, that can direct me towards implementing clients with best practices, being a newbie, I just know calling plane requests method, directly on the running server urls.

stac-fastapi modules serve as base for backend libraries like stac-fastapi-pgstac or https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch. The current maintainers (myself and other devseed team member) are aware that the docs could be better but we are focusing on the code for the moment, but we will be more than happy to review any PR 🙏