Convert all publisher examples to unit tests and use literalinclude to
have sphinx automatically inline the test file contents. Replace
mavendeploy test with more complete version from the code and include
some tests from files that were identical to the inline example.
Enable yaml syntax highlighting for existing examples for consistent
display of docstrings across the publishers module.
In turn fix any python 3 compatibility issues highlighted by the
additional tests executing previously unexercised code paths.
Change-Id: Ic0fd39dee0121c0c22a932fd455dccc5344893b2