[getdns-api] Python bindings plans

[Saúl Ibarra Corretgé]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi all,

Sorry for breaking the thread, I wasn't subscribed before this message
was sent :-/

> 
> Hi, folks:
> 
> I'm reworking the Python bindings with an eye towards an initial 
> release in about three weeks.  This code will be the basis for the
> mature release.  There will be a fairly fundamental reworking of
> the interfaces, but we'll be keeping the current interface
> available through one or two releases to give people a chance to
> transition.
> 
> The two major changes are intended to make the interfaces more
> Pythonic.  They are:
> 
> 1) the introduction of a new Context object, with queries being
> methods associated with that object (note that this is consistent
> with the design of the Node.js bindings) 2) context attributes are
> going to be treated as Python attributes, so that rather than (for
> example) using
> 
> c = getdns.context_create() getdns.context_set_resolution_type(c, 
> getdns.GETDNS_RESOLUTION_RECURSING)
> 
> you'd use
> 
> c = getdns.Context() c.resolution_type =
> getdns.GETDNS_RESOLUTION_RECURSING
> 
> Basically, the setters and the getter are going away.  The results 
> dict is going to stay the same but over time we may be adding some
> convenience methods for access.
> 
> While I don't love having async support in the bindings, that will
> be included as well.
> 
> Comments and suggestions are very welcome.
> 

Thanks for taking the time to ask the community for feedback. I'm
actually very interested in the Python getdns bindings, which I's like
to use to replace c-ares with, for the following reasons:

- - c-ares development is kind-of stalled
- - individual queries cannot be cancelled (all queries of a given
channel can, however)
- - lack of DNSSEC support

So, having written c-ares bindings for Python [0] and then used them
with several asynchronous i/o frameworks such as asyncio [1], here is
a braindump of what would be nice to have IMHO:

- - Use CFFI[2] instead of creating a C module. This is somewhat
controversial, but I think it would be a very nice thing to do now
that it's still early in the process. The Python C API is specific to
CPython, and the emulation layer in PyPy is not great, so basically
only CPython would be supported. With CFFI, both CPython and PyPy
would be supported, and IIRC there is a CFFI backend for Jython in
development, so Jython would eventually be supported.

- - Good async support. I see you don't like this one much, care to
elaborate? I think it's essential, as everyone seems to have drank the
async kool-aid these days ;-) The getdns C API provides great support
for async frameworks, I think that should be exposed in such a way
that it makes it easy to integrate with something like plain select
and asyncio. FWIW, here is how I did it for c-ares [3]. The getdns C
API looks more flexible, so python-getdns could do it nicer.

- - More "Pythonic" API. This has already been addressed with the
proposal of a Context object, which looks great! It would be nice to
see that extended to a Transaction object, foe example, which would be
returned by the async functions. The user could attach arbitrary data
to it, or call Transaction.cancel() to cancel it.

I understand writing emails is easier than actually working on the
code, I hope once the new design is released I can contribute with
code as well :-)

Keep up the good work!


Kind regards,

[0]: https://github.com/saghul/pycares
[1]: https://github.com/saghul/aiodns
[2]:https://cffi.readthedocs.org
[3]:https://github.com/saghul/pycares/tree/master/examples

- -- 
Saúl Ibarra Corretgé
bettercallsaghul.com

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1
Comment: Using GnuPG with Icedove - http://www.enigmail.net/

iQIcBAEBAgAGBQJTsb3vAAoJEEEOVVOum8BZHTMQALgm9PyjnF2j+tCt0+T+mPr4
kRIxd7ImVvWL+5oSj6a6Ff12E7RfNYAElXySZvKn6wemfPKinDOHYdrDHPFG7nRl
sZ9AKClN1v1FJ1O7+dtAxXazq4fZ4nxy0ZMJWqBBWdJ1aDWno0WNEzE11SvoftBz
/kBFDsIvKKmEuKNf2UQeuXjJK+s9hnrGkgY3tdDZVh8XE9QvHZiIzlSuHVANj9Gk
mhMpqK64Qyg1WIAnRt4shLTqmAotBwvStRn7EuIeS+JLm6X/fkaOGrXliuxpbGiy
gIKH+Sp8zib10e1pNPtvnSSXTGkBme6k8MBRd5P43UtMV49fbNx/IfVcMFd5Tncc
xtDePvdHzxAaKgWYVynVZ/ZiFIHSXws6/ybfF7erFA/jzIpvMkz6W92oDZepeBBF
w4dgyuBMcJ91Ltnqgt7Pc60AnCAWRrmCdnk61sS9Qnyli0xhV75VMc4f7jn9LNgA
dra+Gc4XrY4799pZI2tk0SXSwjA7dykmCWe14IHQNM9EXGVCm8jN1kLScAdsR8kz
bpZgCxA7z9xQWn96Tbix9ugLDeSHVth6U1u0OeBHI8ic2vS4ypDzeI27gZ9jKNed
/PjrwAkKq8H6fflcbkLG4bb9lRB0VvsLLcbazvQghv6cXcGDUrMqoVQxgxQAgqrJ
UxykS9+Cc0OtHjbiA2kS
=cC4q
-----END PGP SIGNATURE-----