Install

Hoep is available on PyPI so installation is only a quick pip away.

$ pip install hoep

Unicode

Hoep only accepts and returns unicode objects in Python 2 and str objects in Python 3. This goes for custom renderers as well. All callbacks receive and must return unicode or str objects, respective to the Python version.

Basic Usage

Using Hoep is pretty straightforward. You can either use the render module function or the Hoep module class. The latter is more efficient if you are rendering multiple documents in a single go.

# -*- coding: utf-8 -*-

from __future__ import unicode_literals

import hoep as h


extensions = h.EXT_STRIKETHROUGH
render_flags = h.HTML_SMARTYPANTS


# Method form.
html = h.render('Some ~~bold~~ __"strong"__ text.', extensions, render_flags)


# Class form.
md = h.Hoep(extensions, render_flags)

html = md.render('Some ~~bold~~ __"strong"__ text.')

Custom renderer

By subclassing the Hoep class, you can create a custom renderer overriding various callbacks.

# -*- coding: utf-8 -*-

from __future__ import unicode_literals

import hoep as h


class MyRenderer(h.Hoep):
    def __init__(self, extensions = 0, render_flags = 0):
        # If you override the `__init__` function, you must call
        # the parent class's or bad things will happen.
        super(MyRenderer, self).__init__(extensions, render_flags)

        self.replace = '[redacted]'


    def strikethrough(self, text):
        return self.replace


md = MyRenderer(h.EXT_STRIKETHROUGH)

html = md.render('Some ~~bold~~ __"strong"__ text.')

Support

If you run into any issues or have any questions, either open an issue or hop in #mynt on irc.freenode.net.