jinjarope 0.5.0

Jinja2 utilities, loaders & fsspec integration.

jinjarope

Read the documentation!

How to install

pip

The latest released version is available at the Python package index.

pip install jinjarope

Quick guide

Jinjarope contains a range of Jinja2 loaders (including fsspec-based ones) as well as a jinja2.Environment subclass with added functionality.

For debugging purposes, an FsSpec filesystem implementation for jinja2 loaders is also included.

FsSpecFileSystemLoader

This loader can be used like a FileSystemLoader, but also works on any fsspec-supported remote path. Using the dir:: prefix, any folder can be set as root.

# protocol path
loader = jinjarope.FsSpecFileSystemLoader("dir::github://phil65:jinjarope@main/tests/testresources")
env = jinjarope.Environment(loader=loader)
env.get_template("testfile.jinja").render()

# protocol and storage options
loader = jinjarope.FsSpecFileSystemLoader("github", org="phil65", repo="jinjarope")
env = jinjarope.Environment(loader=loader)
env.get_template("README.md").render()

# fsspec filesystem
fs = fsspec.filesystem("github", org="phil65", repo="jinjarope")
loader = jinjarope.FsSpecFileSystemLoader(fs)
env = jinjarope.Environment(loader=loader)
env.get_template("README.md").render()

FsSpecProtocolPathLoader

This loader accepts any FsSpec protocol path to be used directly. A complete protocol URL to the template file is required.

loader = jinjarope.FsSpecProtocolPathLoader()
env = jinjarope.Environment(loader=loader)
env.get_template("github://phil65:jinjarope@main/tests/testresources/testfile.jinja").render()

NestedDictLoader

[example]
template = "{{ something }}"

content = tomllib.load(toml_file)
loader = jinjarope.NestedDictLoader(content)
env = jinjarope.Environment(loader=loader)
env.get_template("example/template")

General loader information

jinjarope also contains subclasses for all default jinja2 loaders. These loaders have implementations for some magic methods (__eq__, __hash__, __repr__, , __getitem__).

loader = jinjarope.FileSystemLoader(...)
template_source = loader["path/to/template.jinja"]

The loaders can also get ORed to return a ChoiceLoader.

choice_loader = jinjarope.FileSystemLoader(..) | jinjarope.PackageLoader(...)

Prefix loaders can get created using pathlib-style string concatenations

prefix_loader = "path_prefix" / jinjarope.FileSystemLoader(...)

Additional filters

• pformat: pprint.pformat
• repr: repr
• rstrip: str.rstrip
• lstrip: str.lstrip
• removesuffix: str.removesuffix
• removeprefix: str.removeprefix
• add: Optionally add a prefix / suffix to a value if value is truth-y
• issubclass: issubclass
• isinstance: isinstance
• import_module: importlib.import_module
• hasattr: hasattr
• evaluate: Evaluate text as python code and return last statement
• partial: functools.partial
• dump_json: json.dumps
• load_json: json.loads
• load_toml: tomllib.loads
• load_file: Accepts a path or a fsspec protocol URL and returns content as str
• path_join: os.path.join
• format_js_map: format_js_map (format a dictionary as JavaScript map)
• format_css_rule: format_css_rule (format a dictionary of shape {".a": {"b": "c"}} as CSS rule)
• check_output: subprocess.check_output (as str)
• getenv: os.getenv