Skip to main content

Travis Coveralls Requires License Version Supported Python version Supported Django version Package format Python wheel support Package status

django-project-version is a Django reusable app to show your project version

Installation

  • Obtain your copy of source code from the git repository: $ git clone https://github.com/DCOD-OpenSource/django-project-version.git. Or download the latest release from https://github.com/DCOD-OpenSource/django-project-version/tags/.

  • Run $ python ./setup.py install from the repository source tree or unpacked archive. Or use pip: $ pip install django-project-version.

Configuration

  • Add "djversion" to settings.INSTALLED_APPS.

# settings.py

INSTALLED_APPS += [
    "djversion",
]

Settings

DJVERSION_VERSION

Contains project version. Defaults to None.

DJVERSION_UPDATED

Contains project update date or datetime. Defaults to None.

DJVERSION_FORMAT_STRING

Contains version and updated format string. Defaults to "{version} ({updated})".

DJVERSION_GIT_REPO_PATH

Contains path to git repository from where version info can get. Defaults to None.

DJVERSION_GIT_USE_TAG

Indicate usage of git repository current tag as project version. Defaults to False.

DJVERSION_GIT_USE_COMMIT

Indicate usage of git repository last commit hash as project version. Defaults to False.

Usage

If you want always have "VERSION" variable in templates context, just add "djversion.context_processors.version" to settings.TEMPLATE_CONTEXT_PROCESSORS

# settings.py

TEMPLATE_CONTEXT_PROCESSORS += [
    "djversion.context_processors.version",
]

Or you can use project_version templatetag which can be loaded from djversion_tags.

{# footer.html #}

{% load djversion_tags %}

{% project_version as VERSION %}
{{ VERSION }}

Also simple management command print-version which prints project version to stdout is available. Just run: $ python ./manage.py print-version from project folder.

Advanced features

If you want to have REST-style view with your project version:

  • Install django-project-version with additional dependencies: $ pip install django-project-version[rest].

  • Extend you settings.INSTALLED_APPS by adding "rest_framework".

# settings.py

INSTALLED_APPS += [
    "rest_framework",
]
  • Add "djversion" to your URLs definitions:

# urls.py

from django.conf.urls import url


urlpatterns += [
    url(r"^version/", include("djversion.urls")),
]

Or to use information from the project git repository as project version:

  • Install django-project-version with additional dependencies: $ pip install django-project-version[git].

  • Configure git related settings.

Licensing

django-project-version uses the MIT license. Please check the MIT-LICENSE file for more details.

Contacts

Project Website: https://github.com/DCOD-OpenSource/django-project-version/

Author: DCOD <contact@d-cod.com>

For other authors list see AUTHORS file.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-project-version-0.11.2.zip (21.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

django_project_version-0.11.2-py3-none-any.whl (12.7 kB view details)

Uploaded Python 3

File details

Details for the file django-project-version-0.11.2.zip.

File metadata

  • Download URL: django-project-version-0.11.2.zip
  • Upload date:
  • Size: 21.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.1.3 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.8.2

File hashes

Hashes for django-project-version-0.11.2.zip
Algorithm Hash digest
SHA256 cb4efec848905430c99ef90bf525cf8743ec0c31842942f13265dd0477cdee6a
MD5 a9ac2a2f4f3483e6bfff067221843a79
BLAKE2b-256 328757e99fd2c748465d5d2b15be1e304e9cbaac45397b9c70670cf6b638b56b

See more details on using hashes here.

File details

Details for the file django_project_version-0.11.2-py3-none-any.whl.

File metadata

  • Download URL: django_project_version-0.11.2-py3-none-any.whl
  • Upload date:
  • Size: 12.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.1.3 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.8.2

File hashes

Hashes for django_project_version-0.11.2-py3-none-any.whl
Algorithm Hash digest
SHA256 eb0468915c7d58278f38fe108b42c916313bb4f5802266610edb4431cfd8c03a
MD5 7322d11ae0b0e1f0c08368dea4a0f0a9
BLAKE2b-256 5ebe81d3fa9ca4a09139d4430c6d5072f6748a5d1dd6f6e6fe9c3a7b0d90f922

See more details on using hashes here.

Release history Release notifications | RSS feed

0.19.0

2 files

0.18.1

2 files

0.18.0

2 files

0.17.0

2 files

0.16.0

2 files

0.15.1

2 files

0.15.0

2 files

0.14.9

2 files

0.14.8

2 files

0.14.7

2 files

0.14.6

2 files

0.14.5

2 files

0.14.4

2 files

0.14.3

2 files

0.14.2

2 files

0.14.1

2 files

0.14.0

2 files

0.13.0

2 files

0.12.2

2 files

0.12.1

2 files

0.12.0

2 files

This release

0.11.2 This release

2 files

0.11.1

2 files

0.11.0

2 files

0.10.12

2 files

0.10.11

2 files

0.10.10

2 files

0.10.9

2 files

0.10.8

2 files

0.10.7

2 files

0.10.6

2 files

0.10.5

2 files

0.10.4

2 files

0.10.3

2 files

0.10.2

2 files

0.10.1

2 files

0.10.0

2 files

0.9.4

2 files

0.9.3

2 files

0.9.2

2 files

0.9.1

2 files

0.9.0

2 files

0.8.2

2 files

0.8.1

2 files

0.8.0

2 files

0.7.3

2 files

0.7.2

2 files

0.7.1

2 files

0.7.0

2 files

0.6.4

2 files

0.6.3

2 files

0.6.2

2 files

0.6.1

2 files

0.6.0

2 files

0.5.0

2 files

0.4.1

2 files

0.4.0

2 files

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

0.2.4

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.1

2 files

0.1.0

1 file

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page