Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stcarrez/ada-libsecret
Ada Binding for the libsecret library
https://github.com/stcarrez/ada-libsecret
binding keyring kwallet libsecret
Last synced: 2 months ago
JSON representation
Ada Binding for the libsecret library
- Host: GitHub
- URL: https://github.com/stcarrez/ada-libsecret
- Owner: stcarrez
- License: apache-2.0
- Created: 2017-06-23T19:00:14.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-02-17T07:56:39.000Z (5 months ago)
- Last Synced: 2024-02-17T08:35:17.757Z (5 months ago)
- Topics: binding, keyring, kwallet, libsecret
- Language: Ada
- Size: 122 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Lists
- awesome-ada - ada-libsecret - Ada Binding for the libsecret library. (Libraries / Cryptography)
- awesome-ada - ada-libsecret - Ada Binding for the libsecret library. (Libraries / Cryptography)
README
# Ada Libsecret Library
[](https://porion.vacs.fr/porion/projects/view/ada-libsecret/summary)
[](https://porion.vacs.fr/porion/projects/view/ada-libsecret/xunits)
[](https://porion.vacs.fr/porion/projects/view/ada-libsecret/summary)
The [libsecret](https://wiki.gnome.org/Projects/Libsecret) is a library for storing
and retrieving passwords and others secrets. The library uses the
[Secret Service API](https://standards.freedesktop.org/secret-service/) provided
by Gnome Keyring or KDE Wallet. This library provides an Ada binding
to the [Secret Service API](https://standards.freedesktop.org/secret-service/).
# Pre-Requisites
On Ubuntu, you may have to install the following packages:
```
sudo apt-get install libsecret-1-dev libglib2.0-dev
```
# Building
```
alr with secretada
```
The unit tests are built and executed with:
```
make test
```
And the samples are built using:
```
gprbuild -p -Psamples
```
# Using the library
First, add a with clause for the *secret* GNAT project, in your GNAT project file add this line:
```
with "secretada";
```
You can store a secret by using the following code extract:
```
with Secret.Services;
with Secret.Attributes;
with Secret.Values;
...
Service : Secret.Services.Service_Type;
List : Secret.Attributes.Map;
Value : Secret.Values.Secret_Type;
...
Service.Initialize;
List.Insert ("secret identification key", "secret identification value");
Value := Secret.Values.Create ("the-secret-to-store");
Service.Store (List, "The secret label (for the keyring manager)", Value);
```
And you will retrieve it with:
```
Value := Service.Lookup (List);
if not Value.Is_Null then
Ada.Text_IO.Put_Line (Value.Get_Value);
end if;
```
# Running the samples
The samples provide a simple *secret-tool* program that allows to create,
retrieve or delete a secret from the secret service API.
You can add a secret using:
```
bin/secret-tool set my-secret
```
and retrieve it later with:
```
bin/secret-tool get
```
# Documentation and References
* [Secret Service API](https://specifications.freedesktop.org/secret-service/index.html)
* [Libsecret Library Reference Manual](https://gnome.pages.gitlab.gnome.org/libsecret/)
* [Ada wrapper for Secret Service](https://github.com/stcarrez/ada-libsecret/wiki/Secret)