Metadata-Version: 2.1
Name: stencil-template
Version: 4.2.3
Summary: A template engine light enough to embed in your project.
Author-email: Curtis Maloney <curtis@tinbrain.net>
License: MIT
Project-URL: Repository, https://github.com/funkybob/stencil/
Project-URL: Documentation, https://stencil-templates.readthedocs.io/en/latest/
Keywords: template
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/x-rst
License-File: LICENSE
Provides-Extra: test
Requires-Dist: ruff ; extra == 'test'
Requires-Dist: pytest ; extra == 'test'
Requires-Dist: coverage ; extra == 'test'

stencil
=======

A minimalist template engine for Python3

The goal of Stencil is to provide just enough of a template engine in a single file.

Currently weighs in at 550 LoC (414 according to sloccount).

Quick Start
-----------

1. Make a directory for our templates:

   .. code-block:: bash

      $ mkdir tmpl

2. Create a simple template:

   .. code-block:: html

      Good morning, {{ name }}!

3. Write a script to use it

   .. code-block:: python

      import stencil

      loader = stencil.TemplateLoader(['tmpl/'])

      t = loader['index.html']
      c = stencil.Context({'name': 'Ruprect'})

      print t.render(c)
      # Should output "Good morning, Ruprect!"


Python support
--------------

As of stencil v4, there is a new expression syntax that is not backward
compatible.

As of stencil v2.1, only Python 3.6+ is supported.
As of stencil v2, only Python 3.4+ is supported.

Stencil 1.2.3 is the last stable Python 2.7 version.

See the `documentation <https://stencil-templates.readthedocs.io/en/latest/>`_ to see more details.
