https://github.com/wemake-services/jinja2-git

Jinja2 extension to handle git-specific things
https://github.com/wemake-services/jinja2-git

cookiecutter git jinja2 jinja2-extension jinja2-templates jinja2-templating-engine

Last synced: 22 days ago
JSON representation

Jinja2 extension to handle git-specific things

• Host: GitHub
• URL: https://github.com/wemake-services/jinja2-git
• Owner: wemake-services
• License: mit
• Created: 2017-12-24T12:17:12.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2024-10-28T08:28:24.000Z (2 months ago)
• Last Synced: 2024-10-30T00:49:06.720Z (2 months ago)
• Topics: cookiecutter, git, jinja2, jinja2-extension, jinja2-templates, jinja2-templating-engine
• Language: Python
• Homepage: https://pypi.org/project/jinja2-git/
• Size: 412 KB
• Stars: 15
• Watchers: 3
• Forks: 4
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Jinja2 extension to handle git-specific things

[![wemake.services](https://img.shields.io/badge/%20-wemake.services-green.svg?label=%20&logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAMAAAAoLQ9TAAAABGdBTUEAALGPC%2FxhBQAAAAFzUkdCAK7OHOkAAAAbUExURQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAP%2F%2F%2F5TvxDIAAAAIdFJOUwAjRA8xXANAL%2Bv0SAAAADNJREFUGNNjYCAIOJjRBdBFWMkVQeGzcHAwksJnAPPZGOGAASzPzAEHEGVsLExQwE7YswCb7AFZSF3bbAAAAABJRU5ErkJggg%3D%3D)](https://wemake.services)

[![test](https://github.com/wemake-services/jinja2-git/actions/workflows/test.yml/badge.svg?branch=master&event=push)](https://github.com/wemake-services/jinja2-git/actions/workflows/test.yml)

[![codecov](https://codecov.io/gh/wemake-services/jinja2-git/branch/master/graph/badge.svg)](https://codecov.io/gh/wemake-services/jinja2-git)

[![Python versions](https://img.shields.io/pypi/pyversions/jinja2-git.svg)](https://pypi.python.org/pypi/jinja2-git)

[![wemake-python-styleguide](https://img.shields.io/badge/style-wemake-000000.svg)](https://github.com/wemake-services/wemake-python-styleguide)

## Installation

```bash

$ pip install jinja2-git

```

## Reasoning

This plugin is used to render commit hash in `jinja2` templates. We are

using it to render our template version in `cookiecutter`:

- [wemake-django-template](https://github.com/wemake-services/wemake-django-template)

- [wemake-vue-template](https://github.com/wemake-services/wemake-vue-template)

## Usage

Add it as an extension for

[jinja2](http://jinja.pocoo.org/docs/2.10/extensions/) or

[cookiecutter](http://cookiecutter.readthedocs.io/en/latest/advanced/template_extensions.html).

And then inside a template:

```python

from jinja2 import Environment

env = Environment(extensions=['jinja2_git.GitExtension'])

template = env.from_string('Commit is: {% gitcommit %}')

# => Commit is: c644682f4899d7e98147ce3a61a11bb13c52b3a0

```

Or short version:

```python

from jinja2 import Environment

env = Environment(extensions=['jinja2_git.GitExtension'])

template = env.from_string('Commit is: {% gitcommit short=True %}')

# => Commit is: c644682

```

## License

[MIT](https://github.com/wemake-services/jinja2-git/blob/master/LICENSE)