Metadata-Version: 1.1
Name: pypandoc
Version: 0.8.4
Summary: Thin wrapper for pandoc.
Home-page: https://github.com/bebraw/pypandoc
Author: Juho Vepsäläinen
Author-email: bebraw@gmail.com
License: MIT
Description: pypandoc
        ========
        
        pypandoc provides a thin wrapper for
        `pandoc <http://johnmacfarlane.net/pandoc/>`__, a universal document
        converter.
        
        Usage
        -----
        
        The basic invocation looks like this:
        ``pypandoc.convert('input', 'output format')``. ``pypandoc`` tries to
        infer the type of the input automatically. If it's a file, it will load
        it. In case you pass a string, you can define the ``format`` using the
        parameter. The example below should clarify the usage:
        
        .. code:: python
        
            import pypandoc
        
            output = pypandoc.convert('somefile.md', 'rst')
        
            # alternatively you could just pass some string to it and define its format
            output = pypandoc.convert('#some title', 'rst', format='md')
        
        In addition to ``format``, it is possible to pass ``extra_args``. That
        makes it possible to access various pandoc options easily. Please refer
        to ``pandoc -h`` and the `official
        documentation <http://johnmacfarlane.net/pandoc/README.html>`__ for
        further details.
        
        See also `pyandoc <http://pypi.python.org/pypi/pyandoc/>`__ for an
        alternative implementation.
        
        Django Service Example
        ----------------------
        
        See ``services.py`` at the project root for implementation. Use it like
        this:
        
        .. code:: python
        
            from .services import PandocDocxService
        
            service = PandocDocxService()
            doc_file = service.generate(html='<html><body><h1>Heading 1</h1><p>testing testing 123</p></body></html>')
        
        Contributors
        ------------
        
        -  `Valentin Haenel <https://github.com/esc>`__ - String conversion fix
        -  `Daniel Sanchez <https://github.com/ErunamoJAZZ>`__ - Automatic
           parsing of input/output formats
        -  `Thomas G. <https://github.com/coldfix>`__ - Python 3 support
        -  `Ben Jao Ming <https://github.com/benjaoming>`__ - Fail gracefully if
           ``pandoc`` is missing
        -  `Ross Crawford-d'Heureuse <http://github.com/rosscdh>`__ - Encode
           input in UTF-8 and add Django example
        -  `Michael Chow <https://github.com/machow>`__ - Decode output in UTF-8
        -  `Janusz Skonieczny <https://github.com/wooyek>`__ - Support Windows
           newlines and allow encoding to be specified.
        -  `gabeos <https://github.com/gabeos>`__ - Fix help parsing
        -  `Marc Abramowitz <https://github.com/msabramo>`__ - Make ``setup.py``
           fail hard if ``pandoc`` is missing
        
        License
        -------
        
        ``pypandoc`` is available under MIT license. See LICENSE for more
        details.
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Topic :: Text Processing
Classifier: Topic :: Text Processing :: Filters
