govuk-frontend-jinja


Namegovuk-frontend-jinja JSON
Version 3.9.0 PyPI version JSON
download
home_pageNone
SummaryGOV.UK Frontend Jinja Macros
upload_time2025-10-14 14:37:45
maintainerNone
docs_urlNone
authorAndy Mantell
requires_python>=3.10
licenseNone
keywords component design system frontend govuk-frontend govuk jinja macros
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # GOV.UK Frontend Jinja Macros

![PyPI - Version](https://img.shields.io/pypi/v/govuk-frontend-jinja)
![PyPI - Downloads](https://img.shields.io/pypi/dm/govuk-frontend-jinja)
![PyPI - License](https://img.shields.io/pypi/l/govuk-frontend-jinja)
![Static Badge](https://img.shields.io/badge/GOV.UK%20Frontend-v5.13.0-blue)
[![Python package](https://github.com/LandRegistry/govuk-frontend-jinja/actions/workflows/python-package.yml/badge.svg)](https://github.com/LandRegistry/govuk-frontend-jinja/actions/workflows/python-package.yml)

**GOV.UK Frontend Jinja is a [community tool](https://design-system.service.gov.uk/community/resources-and-tools/) of the [GOV.UK Design System](https://design-system.service.gov.uk/). The Design System team is not responsible for it and cannot support you with using it. Contact the [maintainers](#contributors) directly if you need [help](#support) or you want to request a feature.**

This repository provides a complete set of [Jinja](https://jinja.palletsprojects.com/) macros that are kept up-to-date and 100% compliant with the original [GOV.UK Frontend](https://github.com/alphagov/govuk-frontend) Nunjucks macros. Porting is intentionally manual rather than automated to make updates simpler than maintaining an automated conversion routine. A [comprehensive test suite](https://github.com/matthew-shaw/govuk-frontend-diff) ensures compliance against the latest, and every subsequent, GOV.UK Frontend release.

If you are looking to build a fully featured Flask app that integrates with [GOV.UK Frontend Jinja](https://github.com/LandRegistry/govuk-frontend-jinja) and [GOV.UK Frontend WTForms](https://github.com/LandRegistry/govuk-frontend-wtf) please use the [GOV.UK Frontend Flask](https://github.com/LandRegistry/govuk-frontend-flask) template repository to [generate your app](https://github.com/LandRegistry/govuk-frontend-flask/generate).

## Compatibility

The following table shows the version of GOV.UK Frontend Jinja that you should use for your targeted version of GOV.UK Frontend:

| GOV.UK Frontend Jinja Version                                                    | Target GOV.UK Frontend Version                                            |
| -------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| [3.9.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/3.9.0) | [5.13.0](https://github.com/alphagov/govuk-frontend/releases/tag/v5.13.0) |
| [3.8.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/3.8.0) | [5.12.0](https://github.com/alphagov/govuk-frontend/releases/tag/v5.12.0) |
| [3.7.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/3.7.0) | [5.11.1](https://github.com/alphagov/govuk-frontend/releases/tag/v5.11.1) |
| [3.6.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/3.6.0) | [5.10.0](https://github.com/alphagov/govuk-frontend/releases/tag/v5.10.0) |
| [3.5.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/3.5.0) | [5.9.0](https://github.com/alphagov/govuk-frontend/releases/tag/v5.9.0)   |
| [3.4.1](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/3.4.1) | [5.8.0](https://github.com/alphagov/govuk-frontend/releases/tag/v5.8.0)   |
| [3.4.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/3.4.0) | [5.7.1](https://github.com/alphagov/govuk-frontend/releases/tag/v5.7.1)   |
| [3.3.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/3.3.0) | [5.6.0](https://github.com/alphagov/govuk-frontend/releases/tag/v5.6.0)   |
| [3.2.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/3.2.0) | [5.5.0](https://github.com/alphagov/govuk-frontend/releases/tag/v5.5.0)   |
| [3.1.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/3.1.0) | [5.4.0](https://github.com/alphagov/govuk-frontend/releases/tag/v5.4.0)   |
| [3.0.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/3.0.0) | [5.1.0](https://github.com/alphagov/govuk-frontend/releases/tag/v5.1.0)   |
| [2.8.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/2.8.0) | [4.8.0](https://github.com/alphagov/govuk-frontend/releases/tag/v4.8.0)   |
| [2.7.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/2.7.0) | [4.7.0](https://github.com/alphagov/govuk-frontend/releases/tag/v4.7.0)   |
| [2.6.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/2.6.0) | [4.6.0](https://github.com/alphagov/govuk-frontend/releases/tag/v4.6.0)   |
| [2.5.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/2.5.0) | [4.5.0](https://github.com/alphagov/govuk-frontend/releases/tag/v4.5.0)   |
| [2.4.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/2.4.0) | [4.4.1](https://github.com/alphagov/govuk-frontend/releases/tag/v4.4.1)   |
| [2.3.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/2.3.0) | [4.2.0](https://github.com/alphagov/govuk-frontend/releases/tag/v4.2.0)   |
| [2.2.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/2.2.0) | [4.1.0](https://github.com/alphagov/govuk-frontend/releases/tag/v4.1.0)   |
| [2.1.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/2.1.0) | [4.0.1](https://github.com/alphagov/govuk-frontend/releases/tag/v4.0.1)   |
| [2.0.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/2.0.0) | [4.0.0](https://github.com/alphagov/govuk-frontend/releases/tag/v4.0.0)   |
| [1.6.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/1.6.0) | [3.15.0](https://github.com/alphagov/govuk-frontend/releases/tag/v3.15.0) |
| [1.5.1](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/1.5.1) | [3.14.0](https://github.com/alphagov/govuk-frontend/releases/tag/v3.14.0) |
| [1.4.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/1.4.0) | [3.13.0](https://github.com/alphagov/govuk-frontend/releases/tag/v3.13.0) |
| [1.3.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/1.3.0) | [3.12.0](https://github.com/alphagov/govuk-frontend/releases/tag/v3.12.0) |
| [1.2.1](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/1.2.1) | [3.11.0](https://github.com/alphagov/govuk-frontend/releases/tag/v3.11.0) |
| [1.1.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/1.1.0) | [3.10.2](https://github.com/alphagov/govuk-frontend/releases/tag/v3.10.2) |
| [1.0.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/1.0.0) | [3.8.1](https://github.com/alphagov/govuk-frontend/releases/tag/v3.8.1)   |
| [0.2.1](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/0.2.1) | [3.7.0](https://github.com/alphagov/govuk-frontend/releases/tag/v3.7.0)   |

Any other versions of GOV.UK Frontend not shown above _may_ still be compatible, but have not been specifically tested and verified.

## How to use

After running `pip install govuk-frontend-jinja`, ensure that you tell Jinja where to load the templates from using the `PackageLoader` as follows:

```python
from flask import Flask
from jinja2 import ChoiceLoader, PackageLoader, PrefixLoader

app = Flask(__name__)

app.jinja_loader = ChoiceLoader(
    [
        PackageLoader("app"),
        PrefixLoader({"govuk_frontend_jinja": PackageLoader("govuk_frontend_jinja")}),
    ]
)
```

### Calling a Macro in your template

To use a component in your project templates you must import and call the component macro and pass the relevant options, for example:

```html
{%- from 'govuk_frontend_jinja/components/button/macro.html' import govukButton
-%} {{ govukButton({ 'text': "Save and continue" }) }}
```

The options available to each component macro can be found in the original [GOV.UK Design System Components](https://design-system.service.gov.uk/components/) documentation. Since this project is a like-for-like port, the only difference between the Nunjucks examples and their Jinja equivalents is having to quote key names, e.g. `'text'` instead of `text`.

## Running the tests

The tests are run in a GitHub actions pipeline but if you want to run them locally you will need to install [govuk-frontend-diff](https://github.com/matthew-shaw/govuk-frontend-diff).

There is a test server at `tests/utils/app.py` which you will need to run using the following command:

```bash
(cd tests/utils && python -m flask run --port 3000)
```

You can then run the tests using `govuk-frontend-diff` as follows:

```bash
./govuk-frontend-diff http://localhost:3000 --govuk-frontend-version=v4.8.0
```

This is all wrapped up in `./test.sh` for simplified running (Requires Docker).

## Versioning

We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/LandRegistry/govuk-frontend-jinja/tags).

## How to contribute

We welcome contribution from the community. If you want to contribute to this project, please review the [code of conduct](CODE_OF_CONDUCT.md) and [contribution guidelines](CONTRIBUTING.md).

### Update methodology

How to update this package following a new release of GOV.UK Frontend:

1. On `govuk-frontend`, compare the last compatible tag and the latest tag, e.g. <https://github.com/alphagov/govuk-frontend/compare/v4.3.1...v4.4.0>
2. If there are any changes to templates in `package/govuk/components/<component>/template.njk` read the diff and apply the same changes to the Jinja equivalent templates in `govuk_frontend_jinja/templates/components/<component>/macro.html`
3. Take into account any idiosyncrasies between how Nunjucks and Jinja would interpret that template. E.g. `None` checking nested attributes, checking array items lengths or logic operators such as `is`, `not` and `in`.
4. Run the tests [as described above](#running-the-tests)
5. Resolve any failing tests by comparing the expected HTML output with the actual HTML reported by the test tool
6. Add a new row to the [compatibility table](#compatibility) above to show which version of GOV.UK Frontend the next release of this package will be targeting.
7. Once all tests are passing follow the [contribution guidelines](CONTRIBUTING.md) to raise a pull request.
8. After the pull request has been merged, [create a new release](https://github.com/LandRegistry/govuk-frontend-jinja/releases/new) and tag following SemVer conventions.
9. [GitHub Actions](https://github.com/LandRegistry/govuk-frontend-jinja/actions/workflows/python-publish.yml) will run on the new tag to build the package and publish it to PyPI. Verify that the package has been updated with the latest release tag by checking [the project page](https://pypi.org/project/govuk-frontend-jinja/)

## Contributors

- [Matt Shaw](https://github.com/matthew-shaw) (Primary maintainer)
- [Andy Mantell](https://github.com/andymantell) (Original author)

See the full list of [contributors on GitHub](https://github.com/LandRegistry/govuk-frontend-jinja/graphs/contributors)

## Support

This software is provided _"as-is"_ without warranty. Support is provided on a _"best endeavours"_ basis by the maintainers and open source community.

If you are a civil servant you can sign up to the [UK Government Digital Slack](https://ukgovernmentdigital.slack.com/signup) workspace to contact the maintainers listed [above](#contributors) and the community of people using this project in the [#govuk-design-system](https://ukgovernmentdigital.slack.com/archives/C6DMEH5R6) channel.

Otherwise, please see the [contribution guidelines](CONTRIBUTING.md) for how to raise a bug report or feature request.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "govuk-frontend-jinja",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": "Matt Shaw <matthew.shaw@landregistry.gov.uk>",
    "keywords": "component, design system, frontend, govuk-frontend, govuk, jinja, macros",
    "author": "Andy Mantell",
    "author_email": "Matt Shaw <matthew.shaw@landregistry.gov.uk>",
    "download_url": "https://files.pythonhosted.org/packages/df/a6/7b0708798c5edbbbe2575f6a3a0bf97683887757db80779a91396d83dfef/govuk_frontend_jinja-3.9.0.tar.gz",
    "platform": null,
    "description": "# GOV.UK Frontend Jinja Macros\n\n![PyPI - Version](https://img.shields.io/pypi/v/govuk-frontend-jinja)\n![PyPI - Downloads](https://img.shields.io/pypi/dm/govuk-frontend-jinja)\n![PyPI - License](https://img.shields.io/pypi/l/govuk-frontend-jinja)\n![Static Badge](https://img.shields.io/badge/GOV.UK%20Frontend-v5.13.0-blue)\n[![Python package](https://github.com/LandRegistry/govuk-frontend-jinja/actions/workflows/python-package.yml/badge.svg)](https://github.com/LandRegistry/govuk-frontend-jinja/actions/workflows/python-package.yml)\n\n**GOV.UK Frontend Jinja is a [community tool](https://design-system.service.gov.uk/community/resources-and-tools/) of the [GOV.UK Design System](https://design-system.service.gov.uk/). The Design System team is not responsible for it and cannot support you with using it. Contact the [maintainers](#contributors) directly if you need [help](#support) or you want to request a feature.**\n\nThis repository provides a complete set of [Jinja](https://jinja.palletsprojects.com/) macros that are kept up-to-date and 100% compliant with the original [GOV.UK Frontend](https://github.com/alphagov/govuk-frontend) Nunjucks macros. Porting is intentionally manual rather than automated to make updates simpler than maintaining an automated conversion routine. A [comprehensive test suite](https://github.com/matthew-shaw/govuk-frontend-diff) ensures compliance against the latest, and every subsequent, GOV.UK Frontend release.\n\nIf you are looking to build a fully featured Flask app that integrates with [GOV.UK Frontend Jinja](https://github.com/LandRegistry/govuk-frontend-jinja) and [GOV.UK Frontend WTForms](https://github.com/LandRegistry/govuk-frontend-wtf) please use the [GOV.UK Frontend Flask](https://github.com/LandRegistry/govuk-frontend-flask) template repository to [generate your app](https://github.com/LandRegistry/govuk-frontend-flask/generate).\n\n## Compatibility\n\nThe following table shows the version of GOV.UK Frontend Jinja that you should use for your targeted version of GOV.UK Frontend:\n\n| GOV.UK Frontend Jinja Version                                                    | Target GOV.UK Frontend Version                                            |\n| -------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |\n| [3.9.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/3.9.0) | [5.13.0](https://github.com/alphagov/govuk-frontend/releases/tag/v5.13.0) |\n| [3.8.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/3.8.0) | [5.12.0](https://github.com/alphagov/govuk-frontend/releases/tag/v5.12.0) |\n| [3.7.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/3.7.0) | [5.11.1](https://github.com/alphagov/govuk-frontend/releases/tag/v5.11.1) |\n| [3.6.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/3.6.0) | [5.10.0](https://github.com/alphagov/govuk-frontend/releases/tag/v5.10.0) |\n| [3.5.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/3.5.0) | [5.9.0](https://github.com/alphagov/govuk-frontend/releases/tag/v5.9.0)   |\n| [3.4.1](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/3.4.1) | [5.8.0](https://github.com/alphagov/govuk-frontend/releases/tag/v5.8.0)   |\n| [3.4.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/3.4.0) | [5.7.1](https://github.com/alphagov/govuk-frontend/releases/tag/v5.7.1)   |\n| [3.3.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/3.3.0) | [5.6.0](https://github.com/alphagov/govuk-frontend/releases/tag/v5.6.0)   |\n| [3.2.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/3.2.0) | [5.5.0](https://github.com/alphagov/govuk-frontend/releases/tag/v5.5.0)   |\n| [3.1.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/3.1.0) | [5.4.0](https://github.com/alphagov/govuk-frontend/releases/tag/v5.4.0)   |\n| [3.0.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/3.0.0) | [5.1.0](https://github.com/alphagov/govuk-frontend/releases/tag/v5.1.0)   |\n| [2.8.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/2.8.0) | [4.8.0](https://github.com/alphagov/govuk-frontend/releases/tag/v4.8.0)   |\n| [2.7.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/2.7.0) | [4.7.0](https://github.com/alphagov/govuk-frontend/releases/tag/v4.7.0)   |\n| [2.6.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/2.6.0) | [4.6.0](https://github.com/alphagov/govuk-frontend/releases/tag/v4.6.0)   |\n| [2.5.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/2.5.0) | [4.5.0](https://github.com/alphagov/govuk-frontend/releases/tag/v4.5.0)   |\n| [2.4.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/2.4.0) | [4.4.1](https://github.com/alphagov/govuk-frontend/releases/tag/v4.4.1)   |\n| [2.3.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/2.3.0) | [4.2.0](https://github.com/alphagov/govuk-frontend/releases/tag/v4.2.0)   |\n| [2.2.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/2.2.0) | [4.1.0](https://github.com/alphagov/govuk-frontend/releases/tag/v4.1.0)   |\n| [2.1.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/2.1.0) | [4.0.1](https://github.com/alphagov/govuk-frontend/releases/tag/v4.0.1)   |\n| [2.0.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/2.0.0) | [4.0.0](https://github.com/alphagov/govuk-frontend/releases/tag/v4.0.0)   |\n| [1.6.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/1.6.0) | [3.15.0](https://github.com/alphagov/govuk-frontend/releases/tag/v3.15.0) |\n| [1.5.1](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/1.5.1) | [3.14.0](https://github.com/alphagov/govuk-frontend/releases/tag/v3.14.0) |\n| [1.4.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/1.4.0) | [3.13.0](https://github.com/alphagov/govuk-frontend/releases/tag/v3.13.0) |\n| [1.3.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/1.3.0) | [3.12.0](https://github.com/alphagov/govuk-frontend/releases/tag/v3.12.0) |\n| [1.2.1](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/1.2.1) | [3.11.0](https://github.com/alphagov/govuk-frontend/releases/tag/v3.11.0) |\n| [1.1.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/1.1.0) | [3.10.2](https://github.com/alphagov/govuk-frontend/releases/tag/v3.10.2) |\n| [1.0.0](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/1.0.0) | [3.8.1](https://github.com/alphagov/govuk-frontend/releases/tag/v3.8.1)   |\n| [0.2.1](https://github.com/LandRegistry/govuk-frontend-jinja/releases/tag/0.2.1) | [3.7.0](https://github.com/alphagov/govuk-frontend/releases/tag/v3.7.0)   |\n\nAny other versions of GOV.UK Frontend not shown above _may_ still be compatible, but have not been specifically tested and verified.\n\n## How to use\n\nAfter running `pip install govuk-frontend-jinja`, ensure that you tell Jinja where to load the templates from using the `PackageLoader` as follows:\n\n```python\nfrom flask import Flask\nfrom jinja2 import ChoiceLoader, PackageLoader, PrefixLoader\n\napp = Flask(__name__)\n\napp.jinja_loader = ChoiceLoader(\n    [\n        PackageLoader(\"app\"),\n        PrefixLoader({\"govuk_frontend_jinja\": PackageLoader(\"govuk_frontend_jinja\")}),\n    ]\n)\n```\n\n### Calling a Macro in your template\n\nTo use a component in your project templates you must import and call the component macro and pass the relevant options, for example:\n\n```html\n{%- from 'govuk_frontend_jinja/components/button/macro.html' import govukButton\n-%} {{ govukButton({ 'text': \"Save and continue\" }) }}\n```\n\nThe options available to each component macro can be found in the original [GOV.UK Design System Components](https://design-system.service.gov.uk/components/) documentation. Since this project is a like-for-like port, the only difference between the Nunjucks examples and their Jinja equivalents is having to quote key names, e.g. `'text'` instead of `text`.\n\n## Running the tests\n\nThe tests are run in a GitHub actions pipeline but if you want to run them locally you will need to install [govuk-frontend-diff](https://github.com/matthew-shaw/govuk-frontend-diff).\n\nThere is a test server at `tests/utils/app.py` which you will need to run using the following command:\n\n```bash\n(cd tests/utils && python -m flask run --port 3000)\n```\n\nYou can then run the tests using `govuk-frontend-diff` as follows:\n\n```bash\n./govuk-frontend-diff http://localhost:3000 --govuk-frontend-version=v4.8.0\n```\n\nThis is all wrapped up in `./test.sh` for simplified running (Requires Docker).\n\n## Versioning\n\nWe use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/LandRegistry/govuk-frontend-jinja/tags).\n\n## How to contribute\n\nWe welcome contribution from the community. If you want to contribute to this project, please review the [code of conduct](CODE_OF_CONDUCT.md) and [contribution guidelines](CONTRIBUTING.md).\n\n### Update methodology\n\nHow to update this package following a new release of GOV.UK Frontend:\n\n1. On `govuk-frontend`, compare the last compatible tag and the latest tag, e.g. <https://github.com/alphagov/govuk-frontend/compare/v4.3.1...v4.4.0>\n2. If there are any changes to templates in `package/govuk/components/<component>/template.njk` read the diff and apply the same changes to the Jinja equivalent templates in `govuk_frontend_jinja/templates/components/<component>/macro.html`\n3. Take into account any idiosyncrasies between how Nunjucks and Jinja would interpret that template. E.g. `None` checking nested attributes, checking array items lengths or logic operators such as `is`, `not` and `in`.\n4. Run the tests [as described above](#running-the-tests)\n5. Resolve any failing tests by comparing the expected HTML output with the actual HTML reported by the test tool\n6. Add a new row to the [compatibility table](#compatibility) above to show which version of GOV.UK Frontend the next release of this package will be targeting.\n7. Once all tests are passing follow the [contribution guidelines](CONTRIBUTING.md) to raise a pull request.\n8. After the pull request has been merged, [create a new release](https://github.com/LandRegistry/govuk-frontend-jinja/releases/new) and tag following SemVer conventions.\n9. [GitHub Actions](https://github.com/LandRegistry/govuk-frontend-jinja/actions/workflows/python-publish.yml) will run on the new tag to build the package and publish it to PyPI. Verify that the package has been updated with the latest release tag by checking [the project page](https://pypi.org/project/govuk-frontend-jinja/)\n\n## Contributors\n\n- [Matt Shaw](https://github.com/matthew-shaw) (Primary maintainer)\n- [Andy Mantell](https://github.com/andymantell) (Original author)\n\nSee the full list of [contributors on GitHub](https://github.com/LandRegistry/govuk-frontend-jinja/graphs/contributors)\n\n## Support\n\nThis software is provided _\"as-is\"_ without warranty. Support is provided on a _\"best endeavours\"_ basis by the maintainers and open source community.\n\nIf you are a civil servant you can sign up to the [UK Government Digital Slack](https://ukgovernmentdigital.slack.com/signup) workspace to contact the maintainers listed [above](#contributors) and the community of people using this project in the [#govuk-design-system](https://ukgovernmentdigital.slack.com/archives/C6DMEH5R6) channel.\n\nOtherwise, please see the [contribution guidelines](CONTRIBUTING.md) for how to raise a bug report or feature request.\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "GOV.UK Frontend Jinja Macros",
    "version": "3.9.0",
    "project_urls": {
        "Changelog": "https://github.com/LandRegistry/govuk-frontend-jinja/blob/main/CHANGELOG.md",
        "Homepage": "https://github.com/LandRegistry/govuk-frontend-jinja",
        "Issues": "https://github.com/LandRegistry/govuk-frontend-jinja/issues"
    },
    "split_keywords": [
        "component",
        " design system",
        " frontend",
        " govuk-frontend",
        " govuk",
        " jinja",
        " macros"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "04e2544e44710b743c40575c14d6ffe85ba55c81731dc64d131dba2125364d0e",
                "md5": "af831a27a64bdf943f68359ea8a6aa4a",
                "sha256": "f561a792967cbf337c17b9cd511e50339eba3ce5b949d683db4aa5dfbd773d72"
            },
            "downloads": -1,
            "filename": "govuk_frontend_jinja-3.9.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "af831a27a64bdf943f68359ea8a6aa4a",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 49968,
            "upload_time": "2025-10-14T14:37:44",
            "upload_time_iso_8601": "2025-10-14T14:37:44.260392Z",
            "url": "https://files.pythonhosted.org/packages/04/e2/544e44710b743c40575c14d6ffe85ba55c81731dc64d131dba2125364d0e/govuk_frontend_jinja-3.9.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "dfa67b0708798c5edbbbe2575f6a3a0bf97683887757db80779a91396d83dfef",
                "md5": "a0780dd7fa6bf68752a6fc515a0a893b",
                "sha256": "7b70b505e70a88ab5dd3fad9176ec1dec36f97122b317a6758ad8fcbee173227"
            },
            "downloads": -1,
            "filename": "govuk_frontend_jinja-3.9.0.tar.gz",
            "has_sig": false,
            "md5_digest": "a0780dd7fa6bf68752a6fc515a0a893b",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 36459,
            "upload_time": "2025-10-14T14:37:45",
            "upload_time_iso_8601": "2025-10-14T14:37:45.604157Z",
            "url": "https://files.pythonhosted.org/packages/df/a6/7b0708798c5edbbbe2575f6a3a0bf97683887757db80779a91396d83dfef/govuk_frontend_jinja-3.9.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-10-14 14:37:45",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "LandRegistry",
    "github_project": "govuk-frontend-jinja",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "govuk-frontend-jinja"
}
        
Elapsed time: 1.93682s