Add a way to get the path to pandoc

This might be usefull for users of pypandoc which want to use the
included pandoc directly.

Author: jankatins

pypandoc/__init__.py

@@ -12,7 +12,7 @@
 __author__ = u'Juho Vepsäläinen'
 __version__ = '1.1.0'
 __license__ = 'MIT'
-__all__ = ['convert', 'get_pandoc_formats', 'get_pandoc_version']
+__all__ = ['convert', 'get_pandoc_formats', 'get_pandoc_version', 'get_pandoc_path']
 
 
 def convert(source, to, format=None, extra_args=(), encoding='utf-8',
@@ -253,6 +253,26 @@ def get_pandoc_version():
     return __version
 
 
+def get_pandoc_path():
+    """Gets the Pandoc path if Pandoc is installed.
+
+    It will return a path to pandoc which is used by pypandoc.
+
+    This might be a full path or, if pandoc is on PATH, simple `pandoc`. It's garanteed
+    to be callable (i.e. we could get version information from `pandoc --version`).
+    If `PYPANDOC_PANDOC` is set and valid, it will return that value. If the environment
+    variable is not set, either the full path to the included pandoc or the pandoc in
+    `PATH` (whatever is the higher version) will be returned.
+
+    If a cached path is found, it will return the cached path and stop probing Pandoc
+    (unless :func:`clean_pandocpath_cache()` is called).
+
+    :raises OSError: if pandoc is not found
+    """
+    _ensure_pandoc_path()
+    return __pandoc_path
+
+
 def _ensure_pandoc_path():
     global __pandoc_path
 

tests.py

@@ -260,6 +260,10 @@ def test_pdf_conversion(self):
         finally:
             os.remove(name)
 
+    def test_get_pandoc_path(self):
+        result = pypandoc.get_pandoc_path()
+        assert "pandoc" in result
+
     def assertEqualExceptForNewlineEnd(self, expected, received):
         # output written to a file does not seem to have os.linesep
         # handle everything here by replacing the os linesep by a simple \n