[389-devel] lib389 usage cheatsheet
Hi team,
recently, we had a discussion on a scrum meeting about lib389 and its new API.
If I understood right there was an opinion that lib389 DSLdapObjects API
is not very intuitive and it is much easier stick to python-ldap style
because it uses ldapmodify/ldapadd wording (or close enough to it).
And I partially agree with it (and I already have some thoughts how we can
improve it).
Many patches on the review show that the people don't change their code
to the new way.
I've given some thought to it and this is what I came up with:
1. I think it is okay to use instance.add_s and instance.modify_s
for simple operations.
2. If you'd like to make your life easier, you can use DSLdapObjects API
(and I'll help you with that)
3. We should stop using old lib389 API because we don't support it anymore
and it will be depricated in the future. We should use DSLdapObject
instead and we should improve it if we don't like something about it.
We have a lot of docstrings written in lib389 code and the code itself
is pretty readable, in my opinion. But I'd like to make the life easier
and I've started to write 'lib389 cheatsheet'. It has old way/new way
comparison blocks and I base it on the real-life code from your patches
adding some commentairies.
For now, it is here:
https://fedorapeople.org/~spichugi/html/cheatsheet.html
Thanks!
Simon