[Authentication] Small API issues
Michael Leupold
lemma at confuego.org
Wed Jul 15 02:09:50 PDT 2009
These are some small API issues that I'd like to see corrected:
(@Stef: do you rather want text or diffs?)
1. Signals:
- org.freedesktop.Secrets.Collection.CreatedItem => ItemCreated
- org.freedesktop.Secrets.Collection.DeletedItem => ItemDeleted
seems to be a more common way to name a signals (thanks to Kevin Krammer for
coming up with those)
- org.freedesktop.Secrets.Item.changed => ItemChanged
just "changed" seems to be ambiguous.
2. Methods:
- org.freedesktop.Secrets.Session.CompleteAuthenticate - second argument
should be OUT
- org.freedesktop.Secrets.Session.Negotiate should get an argument OUT bool
successful
- how about org.freedesktop.Secrets.Session.SupportedAlgorithms(OUT
Array<String> algorithms) to faciliate negotiation?
3. Object paths:
- Object paths could be shorter. I'd advocate /<apiname> (eg. /Secrets/...)
effectively stripping the /org/freedesktop prefix.
- I'd add that item identifiers on the object path MUST be unique identifiers
that MUST be persistent. That way we could guarantee that synchronization will
work.
- For the very same purpose I'd also add a unique identifier (UUID) property
to Collection as renaming them is possible and they thus can't be identified
using their label. I'd prefer if collections had this uuid as their object
path as well.
4. Errors:
- add org.freedesktop.Secrets.Error.NoSession for methods calls which require
a session but have none
Regards,
Michael
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part.
Url : http://lists.freedesktop.org/archives/authentication/attachments/20090715/ca08daba/attachment.pgp
More information about the Authentication
mailing list