Installation¶
Django Pydenticon can be installed through one of the following methods:
- Using pip, which is the easiest and recommended way for production websites.
Requirements¶
Django Pydenticon depends on the following Python packages:
- Django web framework.
- Pydenticon library, which is used for generating the identicons.
Using pip¶
In order to install latest stable release of Django Pydenticon using pip, run the following command:
pip install django-pydenticon
In order to install the latest development version of Django Pydenticon from Github, use the following command:
pip install -e git+https://github.com/azaghal/django-pydenticon#egg=django_pydenticon
Warning
You will need to update the pip
installation in your virtual environment
if you get the following error while running the above command:
AttributeError: 'NoneType' object has no attribute 'skip_requirements_regex'
You can update pip
to latest version with:
pip install -U pip
After this you should proceed to configure your Django installation.
Configuring your Django installation¶
Once Django Pydenticon has been installed, you need to perform the following steps in order to make it available inside of your Django project:
Edit your project’s settings configuration file (
settings.py
), and update theINSTALLED_APPS
to include applicationdjango_pydenticon
.Edit your project’s URL configuration file (
urls.py
), and add the following line to top of the file:import django_pydenticon.urls
Edit your project’s URL configuration file (
urls.py
), and add the following line to theurlpatterns
setting:url(r'^identicon/', include(django_pydenticon.urls.get_patterns())),
Note
It is not mandatory to use identicon/
as prefix. You can use any prefix
as with any other Django application.
After this the Django Pydenticon application will be available under the
/identicon/
path (relative to your Django project’s base URL), or under any
custom prefix path you have selected for deploying the application.
Where to go next?¶
After Django Pydenticon has been installed, you should learn how to use the application, and may also be intersted to change one of default configuration options.
Warning
It is highly recommended to have a look at documentation covering privacy if you have not done so before. The chapter covers some common privacy issues when using personally-identifiable information for generating identicons (like e-mails or names).