django-gitrevision 0.1.5

Requirements

• python >= 2.5

• django >= 1.2

• gitpython

Installation

Django Git Revision should be installed using pip:

pip install django-gitrevision

Setup and use

1. Add gitrevision to INSTALLED_APPS:

   INSTALLED_APPS += 'gitrevision',

2. If you want use git revision only in templates add gitrevision context processor in settings:

   TEMPLATE_CONTEXT_PROCESSORS += 'gitrevision.context_processors.gitrevision',

   And use GIT_REVISION var in templates:

   ...
   <link href="/test.css?{{ GIT_REVISION }}" rel="stylesheet" type="text/css" media="screen" />
   <script src="/test.js?{{ GIT_REVISION }}"></script>
   ...

3. Or if you want use git revision in views and templates, add gitrevision middleware in settings:

   MIDDLEWARE_CLASSES += 'gitrevision.middleware.GitRevision',

   Using in views:

   def superview( request ):
       git_revision = request.git_revision
       ...

   Using in templates (with requestcontext):

   ...
   <script src="/test.js?{{ request.git_revision }}"></script>
   ...

4. Maybe you be needed append GIT_PATH in django settings:

   GIT_PATH = <path_to_your_git_repository>

Bug tracker

If you have any suggestions, bug reports or annoyances please report them to the issue tracker at https://github.com/klen/django-gitrevision/issues

Contributing

Development of django-gitrevision happens at github: https://github.com/klen/django-gitrevision

Contributors

• klen (Kirill Klenov)

License

Licensed under a GNU lesser general public license.

Copyright

Copyright (c) 2011 Kirill Klenov (horneds@gmail.com)