Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.
🔐 keyring-lib
Manage credentials using OS-specific keyrings: Secret Service
on Linux, Security Framework
on MacOS and Security Credentials
on Windows.
This library aims to be a High-level API for keyring, a cross-platform library to manage credentials, and can be seen as a convenient wrapper around it:
- Made the lib async using
tokio
. - Simplified cargo features:
tokio
by default,tokio-openssl
,async-io
andasync-io-openssl
available. - Added the cargo feature
serde
that enables serialization and deserialization of a keyring entry from and to aString
. - Changed the way the service name is declared: instead of declaring it everytime you declare a keyring entry, you just need to declare it once at the beginning of you program, using the function
keyring::set_global_service_name
. - Added new function
find_secret
that returns aResult<Option<String>>
. - Enabled logging using the log crate.
- Added keyring cache based on the linux keyutils keyring (only works on Linux machines).
See the full API documentation and some examples.
use ;
async
Development
The development environment is managed by Nix. Running nix-shell
will spawn a shell with everything you need to get started with the lib: cargo
, cargo-watch
, rust-bin
, rust-analyzer
…
# Start a Nix shell
$ nix-shell
# then build the lib
$ cargo build -p keyring-lib
Contributing
A bug tracker is available on SourceHut. [send an email]
A mailing list is available on SourceHut. [send an email] [subscribe] [unsubscribe]
If you want to report a bug, please send an email at ~soywod/pimalaya@todo.sr.ht.
If you want to propose a feature or fix a bug, please send a patch at ~soywod/pimalaya@lists.sr.ht. The simplest way to send a patch is to use git send-email, follow this guide to configure git properly.
If you just want to discuss about the project, feel free to join the Matrix workspace #pimalaya or contact me directly @soywod. You can also use the mailing list.
Sponsoring
Special thanks to the NLnet foundation and the European Commission that helped the project to receive financial support from:
- NGI Assure in 2022
- NGI Zero Entrust in 2023
If you appreciate the project, feel free to donate using one of the following providers: