JinjaX

Quickstart

Installation

Install the package using pip.

pip install jinjax

Usage

The first thing you must do in your app is to create a "catalog" of components. This is the object that manage the components and its global settings. Then, you add to the catalog the folder(s) with your components.

from jinjax import Catalog

catalog = Catalog()
catalog.add_folder("myapp/components")

You use the catalog to render a parent component from your views:

def myview():
  ...
  return catalog.render(
    "ComponentName",
    title="Lorem ipsum",
    message="Hello",
  )

Components

The components are .jinja files with snippets of template code (HTML or otherwise). They can also call other components.

Components names

The components must start with an uppercase. I recommend that you use PascalCase names, like Python classes.

For example, if the filename es PersonForm.jinja, the name of the component is PersonForm and can be used like <PersonForm> ... </PersonForm> or just <PersonForm />.

You can organize your components in subfolders, using a dot (.) to indicate a subfolder. For example, you would call a components/Person/Form.jinja components as <Person.Form> ... </Person.Form>

Components arguments

A component can only use data you pass it explicitly and global variables. To declare what arguments it takes, begin the file with a {#def ... #} Jinja comment. Some of these arguments might have a default value (making them optional):

{#def title, message='Hi' #}

<h1>{{ title }}</h1>
<div>{{ message }}. This is my component</div>

Jinja

JinjaX use Jinja internally to render the templates. You can add your own global variables and functions, filters, tests, and Jinja extensions when creating the catalog:

from jinjax import Catalog

catalog = Catalog(
    globals={ ... },
    filters={ ... },
    tests={ ... },
    extensions=[ ... ],
)

or afterwards.

catalog.jinja_env.globals.update({ ... })
catalog.jinja_env.filters.update({ ... })
catalog.jinja_env.tests.update({ ... })
catalog.jinja_env.extensions.extend([ ... ])

You can also reuse an existing Jinja Environment, for example, the one from Flask:

app = Flask(__name__)

# Here we add the flask Jinja globals, filters, etc. like `url_for()`
catalog = jinjax.Catalog(jinja_env=app.jinja_env)

The "do" extension is enabled by default, so you can write things like:

{% do attrs.set(class="btn", disabled=True) %}