# pystache > Mustache for Python - **URL**: https://www.freshcrate.ai/projects/pystache - **Author**: pypi - **Category**: Frameworks - **Latest version**: `0.6.8` (2026-04-21) - **License**: non-standard - **Source**: https://github.com/PennyDreadfulMTG/pystache/blob/master/CHANGELOG.rst - **Homepage**: https://pypi.org/project/pystache/ - **Language**: Python - **GitHub**: 19 stars, 5 forks - **Registry**: pypi (`pystache`) - **Tags**: `pypi` ## Description Pystache ======== |ci| |conda| |coverage| |bandit| |release| |pre| |cov| |pylint| |tag| |license| |python| This updated fork of Pystache is currently tested on Python 3.8+ and in Conda, on Linux, Macos, and Windows. |logo| `Pystache `__ is a Python implementation of `Mustache `__. Mustache is a framework-agnostic, logic-free templating system inspired by `ctemplate `__ and et. Like ctemplate, Mustache "emphasizes separating logic from presentation: it is impossible to embed application logic in this template language." The `mustache(5) `__ man page provides a good introduction to Mustache's syntax. For a more complete (and more current) description of Mustache's behavior, see the official `Mustache spec `__. Pystache is `semantically versioned `__ and older versions can still be found on `PyPI `__. This version of Pystache now passes all tests in `version 1.1.3 `__ of the spec. Requirements ============ Pystache is tested with: - Python 3.8 - Python 3.9 - Python 3.10 - Python 3.11 - Python 3.12 - Python 3.13 - Conda (py38 and py310) JSON support is needed only for the command-line interface and to run the spec tests; PyYAML can still be used (see the Develop section). Official support for Python 2 has ended with Pystache version 0.6.0. .. note:: This project uses setuptools_scm_ to generate and maintain the version file, which only gets included in the sdist/wheel packages. In a fresh clone, running any of the tox_ commands should generate the current version file. .. _setuptools_scm: https://github.com/pypa/setuptools_scm .. _tox: https://github.com/tox-dev/tox Quick Start =========== Be sure to get the latest release from either Pypi or Github. Install It ---------- From Pypi:: $ pip install pystache Or Github:: $ pip install -U pystache -f https://github.com/PennyDreadfulMTG/pystache/releases/ And test it:: $ pystache-test To install and test from source (e.g. from GitHub), see the Develop section. Use It ------ Open a python console:: >>> import pystache >>> print(pystache.render('Hi {{person}}!', {'person': 'Mom'})) Hi Mom! You can also create dedicated view classes to hold your view logic. Here's your view class (in ../pystache/tests/examples/readme.py): :: class SayHello(object): def to(self): return "Pizza" Instantiating like so: :: >>> from pystache.tests.examples.readme import SayHello >>> hello = SayHello() Then your template, say_hello.mustache (by default in the same directory as your class definition): :: Hello, {{to}}! Pull it together: :: >>> renderer = pystache.Renderer() >>> print(renderer.render(hello)) Hello, Pizza! For greater control over rendering (e.g. to specify a custom template directory), use the ``Renderer`` class like above. One can pass attributes to the Renderer class constructor or set them on a Renderer instance. To customize template loading on a per-view basis, subclass ``TemplateSpec``. See the docstrings of the `Renderer `__ class and `TemplateSpec `__ class for more information. You can also pre-parse a template: :: >>> parsed = pystache.parse(u"Hey {{#who}}{{.}}!{{/who}}") >>> print(parsed) ['Hey ', _SectionNode(key='who', index_begin=12, index_end=18, parsed=[_EscapeNode(key='.'), '!'])] And then: :: >>> print(renderer.render(parsed, {'who': 'Pops'})) Hey Pops! >>> print(renderer.render(parsed, {'who': 'you'})) Hey you! Unicode ------- This section describes how Pystache handles unicode, strings, and encodings. Internally, Pystache uses `only unicode strings`_ (``str`` in Python 3). For input, Pystache accepts byte strings (``bytes`` in Python 3). For output, Pystache's template rendering methods return only unicode. .. _only unicode strings: https://docs.python.org/howto/unicode.html#tips-for-writing-unicode-aware-programs Pystache's ``Renderer`` class supports a number of attributes to control how Pystache converts byte strings to unicode on input. These include the ``file_encoding``, ``string_encoding``, and ``decode_errors`` attributes. The ``file_encoding`` attribute is the encoding the renderer uses to convert to unicode any files read from the file system. Similarly, ``string_encoding`` is the encoding the renderer uses to convert any other byte strings encountered during the rendering process into unicode (e.g. context values that are encoded byte strings). The ``decode_errors`` attribute is what the renderer passes as the ``errors`` argumen ## Recent releases | Version | Date | Urgency | Changes | | --- | --- | --- | --- | | `0.6.8` | 2026-04-21 | Low | Imported from PyPI (0.6.8) | | `v0.6.8` | 2025-03-18 | Low | ## What's Changed * pystache has been stable and out of beta a long time, update config to reflect by @bakert in https://github.com/PennyDreadfulMTG/pystache/pull/36 * feat: Supply ParsingError with additional information by @mykola-mokhnach-parloa in https://github.com/PennyDreadfulMTG/pystache/pull/37 ## New Contributors * @mykola-mokhnach-parloa made their first contribution in https://github.com/PennyDreadfulMTG/pystache/pull/37 **Full Changelog**: https://github.com/PennyDreadfulMT | | `v0.6.8` | 2025-03-18 | Low | ## What's Changed * pystache has been stable and out of beta a long time, update config to reflect by @bakert in https://github.com/PennyDreadfulMTG/pystache/pull/36 * feat: Supply ParsingError with additional information by @mykola-mokhnach-parloa in https://github.com/PennyDreadfulMTG/pystache/pull/37 ## New Contributors * @mykola-mokhnach-parloa made their first contribution in https://github.com/PennyDreadfulMTG/pystache/pull/37 **Full Changelog**: https://github.com/PennyDreadfulMT | | `v0.6.8` | 2025-03-18 | Low | ## What's Changed * pystache has been stable and out of beta a long time, update config to reflect by @bakert in https://github.com/PennyDreadfulMTG/pystache/pull/36 * feat: Supply ParsingError with additional information by @mykola-mokhnach-parloa in https://github.com/PennyDreadfulMTG/pystache/pull/37 ## New Contributors * @mykola-mokhnach-parloa made their first contribution in https://github.com/PennyDreadfulMTG/pystache/pull/37 **Full Changelog**: https://github.com/PennyDreadfulMT | | `v0.6.8` | 2025-03-18 | Low | ## What's Changed * pystache has been stable and out of beta a long time, update config to reflect by @bakert in https://github.com/PennyDreadfulMTG/pystache/pull/36 * feat: Supply ParsingError with additional information by @mykola-mokhnach-parloa in https://github.com/PennyDreadfulMTG/pystache/pull/37 ## New Contributors * @mykola-mokhnach-parloa made their first contribution in https://github.com/PennyDreadfulMTG/pystache/pull/37 **Full Changelog**: https://github.com/PennyDreadfulMT | | `v0.6.8` | 2025-03-18 | Low | ## What's Changed * pystache has been stable and out of beta a long time, update config to reflect by @bakert in https://github.com/PennyDreadfulMTG/pystache/pull/36 * feat: Supply ParsingError with additional information by @mykola-mokhnach-parloa in https://github.com/PennyDreadfulMTG/pystache/pull/37 ## New Contributors * @mykola-mokhnach-parloa made their first contribution in https://github.com/PennyDreadfulMTG/pystache/pull/37 **Full Changelog**: https://github.com/PennyDreadfulMT | | `v0.6.8` | 2025-03-18 | Low | ## What's Changed * pystache has been stable and out of beta a long time, update config to reflect by @bakert in https://github.com/PennyDreadfulMTG/pystache/pull/36 * feat: Supply ParsingError with additional information by @mykola-mokhnach-parloa in https://github.com/PennyDreadfulMTG/pystache/pull/37 ## New Contributors * @mykola-mokhnach-parloa made their first contribution in https://github.com/PennyDreadfulMTG/pystache/pull/37 **Full Changelog**: https://github.com/PennyDreadfulMT | | `v0.6.8` | 2025-03-18 | Low | ## What's Changed * pystache has been stable and out of beta a long time, update config to reflect by @bakert in https://github.com/PennyDreadfulMTG/pystache/pull/36 * feat: Supply ParsingError with additional information by @mykola-mokhnach-parloa in https://github.com/PennyDreadfulMTG/pystache/pull/37 ## New Contributors * @mykola-mokhnach-parloa made their first contribution in https://github.com/PennyDreadfulMTG/pystache/pull/37 **Full Changelog**: https://github.com/PennyDreadfulMT | | `v0.6.8` | 2025-03-18 | Low | ## What's Changed * pystache has been stable and out of beta a long time, update config to reflect by @bakert in https://github.com/PennyDreadfulMTG/pystache/pull/36 * feat: Supply ParsingError with additional information by @mykola-mokhnach-parloa in https://github.com/PennyDreadfulMTG/pystache/pull/37 ## New Contributors * @mykola-mokhnach-parloa made their first contribution in https://github.com/PennyDreadfulMTG/pystache/pull/37 **Full Changelog**: https://github.com/PennyDreadfulMT | | `v0.6.8` | 2025-03-18 | Low | ## What's Changed * pystache has been stable and out of beta a long time, update config to reflect by @bakert in https://github.com/PennyDreadfulMTG/pystache/pull/36 * feat: Supply ParsingError with additional information by @mykola-mokhnach-parloa in https://github.com/PennyDreadfulMTG/pystache/pull/37 ## New Contributors * @mykola-mokhnach-parloa made their first contribution in https://github.com/PennyDreadfulMTG/pystache/pull/37 **Full Changelog**: https://github.com/PennyDreadfulMT | ## Citation - HTML: https://www.freshcrate.ai/projects/pystache - Markdown: https://www.freshcrate.ai/projects/pystache.md - Dependencies JSON: https://www.freshcrate.ai/api/projects/pystache/deps _Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._