OpenSystemsDevelopment / qpdf

ClosedFileInputSource is an input source that keeps the file closed
when not reading it.

This is the beginning of higher-level API support using helper
classes. The goal is to be able to add more helpers without continuing
to pollute QPDF's and QPDFObjectHandle's public interfaces.

Implement a TokenFilter class and refactor Pl_QPDFTokenizer to use a
TokenFilter class called ContentNormalizer. Pl_QPDFTokenizer is now a
general filter that passes data through a TokenFilter.

Additional testing is added in later commits to be supported by
additional changes in the library.

Rather than checking consistency of libqpdf.map, generate it.

The build now checks to make sure libqpdf.map has the right library
version number in it.

Also update maintainer documentation on binary compatibility testing.

Add new RandomDataProvider object and implement existing random number
generation in terms of that.  This enables end users to supply their
own random data providers.

Change object type Keyword to Operator, and place the order of the
object types in object_type_e in the same order as they are mentioned
in the PDF specification.

Note that this change only breaks backward compatibility with code
that has not yet been released.

These object types are to facilitate content stream parsing.

The upcoming 3.1 release contains non-compatible API changes, though
they only affect parts of the interface that are extremely unlikely to
have been used outside of qpdf itself.  The methods and data types
affected were used for communication between QPDFWriter and QPDF and
would have had no real use in end user code.

Implemented pipeline around sph sha calls using standard test vectors
for full-byte values.  Did not test or support partial byte values.

Changes from upstream are limited to change #include paths so that I
can place header files and included "c" files in a subdirectory.  I
didn't keep the unit tests from sphlib but instead verified them by
running them manually.  I will implement the same tests using the
Pl_SHA2 pipeline except that sphlib's sha2 implementation supports
partial bytes, which I will not exercise in qpdf or our tests.

InputSource, FileInputSource, and BufferInputSource are now top-level
classes instead of privately nested inside QPDF.