search

ximion / appstream

Tools and libraries to work with AppStream metadata
http://www.freedesktop.org/wiki/Distributions/AppStream/
GNU Lesser General Public License v2.1
210 stars 115 forks source link

Stabilize AppstreamCompose API #628

Open tytan652 opened 5 months ago

tytan652 commented 5 months ago

I thought it was stable since the compose API was promoted on documentations but the I_KNOW_THE_APPSTREAM_COMPOSE_API_IS_SUBJECT_TO_CHANGE thing indicate the opposite.

If prioritizing the API over the cli tools is really preferred, why keeping this dealbreaker ?

Or they are stuff that needs to be worked on before ?

ximion commented 5 months ago

I am still not happy with it, the API is leaking a few internals for appstream-generator to hook into that could probably be abstracted away better. If you only use the AscCompose class (and not things like AscCanvas) you most likely won't experience much, or any, breakage though.

Ideally I would have more time to work on asgen and the compose library to declare it fully stable, but I currently don't have that time (or funding) sadly.

What do you want to use the API for / what concerns do you have?

tytan652 commented 5 months ago

What do you want to use the API for / what concerns do you have?

I was trying to see how feasible it was to replace the use of appstreamcli compose in flatpak-builder, but this kind of thing blocks the idea.