Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Python
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
test_ums
.gitignore
README.rst
build.sh
build1.bat
build2.bat
requirements.txt

README.rst

User Management Service

A simple user management service (UMS) written in Python & Django with the following requirements:

  • user login via email and password
  • user registration via email, password & name and following redirection to a welcome page
  • activation email on successful registration (currently only in console)
  • user settings page where the user can change its password, subscribe/unsubscribe for a site newsletter and the current user status (active/inactive) is shown
  • user logout

Contraints:

  • email addresses have to be unique
  • password length at least 5 characters and should contain at least one number inside
  • supported in FF, Chrome and IE8
  • renders in mobile browser (tested on Android device)

1. Requirements

The UMS was tested on two environments:

  • Ubuntu 12.04 LTS with Python 2.7.3
  • Windows 7 with Python 2.7.2

Additionally it is required that the virtualenv library is installed in order to seperate the environment from the system enviroment and to use the build scripts.

The example UMS is using the following python packages (the build script will handle the installation):

  • django 1.4
  • django-registration 0.8

2. Installation & Setup

Clone the repository or extract the tarball. Open a terminal/command prompt in the directory the files where cloned to and type.

Linux:

./build.sh

Windows:

build1.bat
build2.bat

You can also execute the following steps manually.

Linux:

virtualenv test_ums_env
source test_ums_env/bin/activate
pip install -r requirements.txt
cd test_ums
python manage.py syncdb --noinput
python manage.py runserver 8080

Windows:

virtualenv test_ums_env
test_ums_env/Scripts/activate
pip install -r requirements.txt
cd test_ums
python manage.py syncdb --noinput
python manage.py runserver 8080

After that the application is available in your web browser via http://localhost:8080.

3. Implementation details

The example UMS is implemented with Django (a Python web framework) and is using django-registration (a reusable application for Django easing the registration process).

Django's authentification system up to version 1.4 is working with usernames instead of emails to login a user by default. In order to make it work to use email addresses instead a custom backend was created for django.contrib.auth and django-registration. These also include forms, which overwrite the default forms used by these two. The overwritten parts can be found in test_ums/custom/auth/ and test_ums/custom/registration/.

Except this a Django application called web (in test_ums/web/) is used to handle the settings and welcome pages and also provide some basic glue and workflow for the whole project.

Templates are hosted in test_ums/templates/ and static files are hosted in test_ums/static/ (currently only CSS files).

For simplification the user data is saved in an sqlite3 database within the django project directory.

Something went wrong with that request. Please try again.