3f4fdb0f69
The idea behind `SecretSync` is a nice thing: it allows use to re-use our async implementations of methods for the synchronous versions. The big problem with it, is that it makes debugging issues much harder (especially with issues related to freezes) since things can seem to be stuck in `poll()` somewhere. Even though it adds quite a bit of code, I think it makes sense to replace some instances with a proper synchronous implementation. Note that we don't do this for all usages of `SecretSync` though, as some things will need some kind of main loop interaction anyway (for example, when waiting for a portal's Response signal) Another nice advantage is that it's easier to follow the logic in the sync code than the async version.
libsecret
A GObject-based library for storing and receiving secrets. libsecret provides a convenient wrapper around two different mechanisms: If available, secrets are stored in the freedesktop secret service. Otherwise, secrets are stored in a file that is encrypted using a master secret that was provided by the secret portal.
Documentation
You can find the nightly documentation at https://gnome.pages.gitlab.gnome.org/libsecret/.
Building
To build, test and install libsecret, you can use the following commands:
$ meson setup _build
$ meson compile -C _build
$ meson test -C _build
$ meson install -C _build
Contributing
You can browse the code, issues and more at libsecret's GitLab repository.
If you find a bug in libsecret, please file an issue on the issue tracker. Please try to add reproducible steps and the relevant version of libsecret.
If you want to contribute functionality or bug fixes, please open a Merge Request (MR). For more info on how to do this, see GitLab's help pages on MR's.
If libsecret is not translated in your language or you believe that the current translation has errors, you can join one of the various translation teams in GNOME. Translators do not commit directly to Git, but are advised to use our separate translation infrastructure instead. More info can be found at the translation project wiki page.
Releases
The release tarballs use semantic versioning since 0.19.0, which basically means:
- The major version will be incremented if backward incompatible changes are added
- The minor version will be incremented if new functionality is added in a backward compatible manner
- The patch version will be incremented if only backward compatible bug fixes are added
Note that there is no stable/unstable indication in whether the minor version number is even or odd.