hypertag-lang 1.0.3

Modern language for HTML templates and markup generation with Python-like concise syntax, code reuse & modularity. Partial Django integration.

Introduction

If you are new to Hypertag, see the Quick Start for a brief introduction, or the complete Language Reference for details.

Hypertag is a modern language for front-end development that allows writing markup documents in a way similar to writing Python scripts, where indentation determines relationships between nested elements and removes the need for explicit closing tags. Hypertag provides:

• Advanced control of rendering process with native control blocks (if, for, while, try).
• High level of modularity thanks to Python-like imports.
• Unprecedented support for code reuse with native custom tags.
• Native DOM representation and DOM manipulation during rendering.
• Embedded expressions of any complexity.
• Standard Python operators to manipulate arbitrary Python objects.
• Custom pipeline operator (:) for chaining multiple functions as filters.
• Expression qualifiers (!?) for creation of alternative paths of calculation and easy handling of edge cases.
• Built-in tags for HTML5 generation and for general purposes.
• Integrated Python built-ins.
• Integrated Django filters.

Setup

Install:

pip install hypertag-lang               # watch out the name, it is "hypertag-lang"

Usage:

from hypertag import HyperHTML
html = HyperHTML().render(script)       # rendering of a Hypertag `script` to HTML

Why to use Hypertag

• Concise syntax: inspired by Python, the indentation-based syntax is a lot cleaner, more readable and maintainable than raw markup; it requires less typing, is less redundant, and lets you concentrate on coding rather than chasing unmatched opening-closing tags.
• Code reuse by means of functions/classes is the corner stone of programming, yet it is missing from HTML; this is fixed now with Hypertag: programmers can create reusable components in a form of custom tags (hypertags), defined either as Python functions (external tags) or directly in a document using Hypertag syntax (native tags); hypertags can be parameterized and may represent complex pieces of combined: content, style and layout - for a reuse across documents.
• Fine-grained control over rendering process is possible with a range of native control blocks (for, while, if-elif-else, try-else) constituting a core part of Hypertag syntax, unlike in templating languages, where control structures are artificially overlaid on top of another language (HTML).
• Modularity in Hypertag is modeled after Python's: every script may import tags and variables from other scripts, from Python modules, and from the dynamic context of script rendering; scripts and modules are arranged into packages; with these mechanisms in place, building libraries of reusable components is easy and fun.
• Applicability to different target languages. Hypertag is not just a templating system put on top of HTML. Hypertag is a full-featured standalone programming language tailored to the generation of documents of all kinds. By defining new tags, Hypertag can be adapted to produce an arbitrary document description language.

Acknowledgements

Hypertag was partially modeled on Python's syntax, and was inspired by indentation-based templating languages: Slim, Plim, Shpaml, Haml.