.gitignore

@@ -1,7 +1,14 @@
 build/
 _build/
 *~
-getdns.so
+*.pyc
+*.so
 *.save
 doc/_build/
 doc/_build/*
+TAGS
+dist
+MANIFEST
+.pypirc
+\#*
+etc/

ChangeLog

@@ -0,0 +1,35 @@
+Changes in version 0.3.1 (10 April 2015)
+
+* implemented asynchronous queries, bound to Context()
+  objects, and introduced Context.run() method.  See
+  getdns.readthedocs.org
+
+* queries now return a Result() object, with attributes.
+  See getdns.readthedocs.org
+
+* removed leading GETDNS_ in all constants
+  (i.e. getdns.GETDNS_RRTYPE_AAAA is now getdns.RRTYPE_AAAA)
+
+* added getdns.get_errorstr_by_id() method, making it easier
+  to provide user-friendly error messages
+
+* prettied up printing of canonical names in Result object
+
+* str and repr printing has been added to both Context and
+  Result objects
+
+* dead code removed
+
+* replaced instances of getdns_strerror() with
+  getdns_get_errorstr_by_id()
+
+* fixed incorrect error return from Result construction
+
+* moved __version__ attribute from Context to top-level
+  getdns module
+
+* made exception handling within the module more consistent
+
+* added documentation describing getdns.error
+
+* broke out query types

Dockerfile

@@ -0,0 +1,46 @@
+FROM  ubuntu:16.04
+MAINTAINER Melinda Shore <melinda.shore@nomountain.net>
+
+RUN set -ex \
+    && apt-get update \
+    && apt-get install -y curl \
+    && apt-get install -y git \
+    && apt-get install -y wget \
+    && apt-get install -y libssl-dev \
+    && curl -fOSL "https://unbound.net/downloads/unbound-1.6.3.tar.gz" \
+    && mkdir -p /usr/src/unbound \
+    && tar -xzC /usr/src/unbound --strip-components=1 -f unbound-1.6.3.tar.gz \
+    && rm unbound-1.6.3.tar.gz \
+    && apt-get -y install libidn11-dev \
+    && apt-get -y install python-dev \
+    && apt-get -y install make \
+    && apt-get install -y automake autoconf libtool \
+    && apt-get install -y shtool \
+    && cd /usr/src/unbound \
+    && ./configure \
+    && make \
+    && make install \
+    && ldconfig \
+    && cd /usr/src \
+    && git clone https://github.com/getdnsapi/getdns.git \
+    && cd /usr/src/getdns \
+    && git checkout release/1.1.1 \
+    && git submodule update --init \
+    && libtoolize -ci \
+    && autoreconf -fi \
+    && ./configure \
+    && make \
+    && make install \
+    && ldconfig \
+    && mkdir -p /etc/unbound \
+    && cd /etc/unbound \
+    && wget http://www.nomountain.net/getdns-root.key \
+    && cd /usr/src \
+    && git clone https://github.com/getdnsapi/getdns-python-bindings.git \
+    && cd /usr/src/getdns-python-bindings \
+    && git checkout develop \
+    && python setup.py build \
+    && python setup.py install 
+
+
+CMD ["/usr/bin/python"]

MANIFEST.in

@@ -0,0 +1,4 @@
+# file GENERATED by distutils, do NOT edit
+include *.c
+include *.h
+recursive-include examples *.py

README.md

@@ -3,26 +3,25 @@ getdns-python-bindings
 
 Python bindings for getdns
 
+* Date: 2016-03-29
+* Github: https://github.com/getdnsapi/getdns-python-bindings
+* Current version: v1.0.0b1
+
 External dependencies
 =====================
 
-Built and tested against Python 2.7.  You will need to install
+Built and tested against Python 2.7 and Python 3.4.  You will need to install
 the Python headers and libraries - this is usually a package
 called "python-dev"
 
-Currently building against the getdns 0.1.3 release.
+Currently building against the getdns v1.0.0b release.
 getdns external dependencies include:
 
-* [libldns from NLnet Labs](https://www.nlnetlabs.nl/projects/ldns/) version 1.6.11 or later (ldns requires ope
-nssl headers and libraries)
 * [libunbound from NLnet Labs](http://www.nlnetlabs.nl/projects/unbound/) version 1.4.16 or later
-* [libexpat](http://expat.sourceforge.net/) for libunbound.
 * [libidn from the FSF](http://www.gnu.org/software/libidn/) version 1.
-* [libevent](http://libevent.org) version 2.0.21 stable, sometimes called libevent2 (only needed if you plan to
- use it for asynchronous handling)
-
-Note that getdns **MUST** be built with the --with-libevent flag to
-configure.
+* [libssl and libcrypto from the OpenSSL project](https://www.openssl.org/) version 0.9.7 or later.
+  (Note: version 1.0.1 or later is required for TLS support, 
+   version 1.0.2 or later is required for TLS hostname authentication)
 
 Building
 ========
@@ -34,7 +33,7 @@ python setup.py build
 
 During the development process and before the module is installed, I
 find it convenient to have a symlink in the current directory pointing
-to the library in the build directory:
+to the library in the build directory.  For example:
 
 ```
 getdns.so -> build/lib.linux-i686-2.7/getdns.so
@@ -49,6 +48,18 @@ people who are using the bindings should go ahead and install.
 python setup.py install
 ````
 
+We recently added Python 3 support.  To build, just invoke
+the Python 3 interpreter rather the Python 2 interpreter (on
+most systems this will be "python3").  
+
+```
+python3 setup.py build
+```
+You will need the
+Python 3 development environment ("python3-dev" or
+"python3-devel", most often).
+
+
 Documentation
 =============
 
@@ -60,18 +71,47 @@ source tree in doc/_build/html.  It is also available online at [readthedocs.org
 Changes from the earlier release
 ================================
 
-We've introduced a Context object with attributes and methods, with
-queries being Context methods.  Attributes can be assigned and read
-directly without using the getdns setters and getters.  For example,
+* A number of performance improvements.
 
-```python
-import getdns.context
-my_context = getdns.Context()
-my_context.timeout = 1000
-print my_context.timeout
-```
+* Installable via PyPi.
+
+* Removed libevent dependency
+
+* For consistency with Python 3, the Python 2 bindings now return
+Context() attributes as longs
+
+* TSIG support
+
+* GETDNS_AUTHENTICATION_HOSTNAME is replaced by
+GETDNS_AUTHENTICATION_REQUIRED (but remains available as an alias).
+Upstreams can now be configured with either a hostname or a SPKI
+pinset for TLS authentication (or both). If the
+GETDNS_AUTHENTICATION_REQUIRED option is used at least one piece of
+authentication information must be configured for each upstream, and
+all the configured authentication information for an upstream must
+validate.
+
+Older changes
+=============
+
+In addition to adding Python 3 support, we've changed the callback
+argument to the asynchronous methods to accept a callable by name,
+rather than as a literal string.
+
+We're also now supporting a new transport_list attribute, an
+ordered (by preference) list of transport options, including
+TCP, UDP, TLS, and STARTTLS.
+
+There are also a number of bugfixes, including cleaning up
+after unbound zombies (this has been fixed in unbound as well
+but the code is not yet included in a distribution) and
+correct handling of strings encoded as getdns bindatas.
+
+Examples have been updated to work with both Python 2.x and
+Python 3.
 
-Please see the documentation for details on attributes and methods.
+Please see the documentation for details on new attributes 
+extensions, and methods.
 
 Examples
 ========