Multi user address book application
Project description
icemac.addressbook
Purpose: Store, search and export addresses and phone numbers using a web application.
Status: working prototype (preview of the real application)
Features
store data of persons including (postal address, e-mail address, home page address phone number)
assign keywords to persons
search for persons by keyword
export persons found by a search as XLS file
multi-client capability
user management (prepared)
really good test coverage (> 98 %)
Roles
Access to the address book is only granted after authentication. There are three roles to authorize a user:
visitor: visit all person’s data, search and export
editor: permissions of visitor + edit all person’s data
administrator: permissions of editor + create and change address books
Predefined users
As this version is a preview version there is no usermanagement yet. The following predefined users exist: (<username>:<password>)
admin:admin-ia (Role: administrator)
editor:editor-ia (Role: editor)
visitor: visitor-ia (Role: visitor)
Installation
Prerequisites
You only need Python 2.4 or 2.5.
Install
CAUTION: icemac.addressbook can’t be installed using easy_install, you have to follow these steps:
Download the source distribution (see Download).
Extract the downloaded file.
Run install.py using your desired python, e. g.:
$ python2.5 install.py
Neither you need any root privileges nor it installs anything outside its directory.
Run the tests
Run the unit tests and functional tests using:
$ bin/test
Run the application
The server runs on 127.0.0.1:8080. To change this edit deploy.ini.
To run in foreground start using:
$ bin/addressbook fg
To run as a demon process start using:
$ bin/addressbook start
To stop the demon process call:
$ bin/addressbook stop
The default URL is:
http://127.0.0.1:8080/++skin++AddressBook/
Update
Stop the application.
Create a backup of the ZODB using:
$ bin/backup
Do the steps described in Install.
Copy the backup directory (var/backups) to the new directory.
Restore the backup using:
$ bin/restore
Restart the application.
To do
The following features should be implemented over the next months:
user management
person data
store picture per person
add customizable free text fields
company as entity
import
vCard
XLS
SQLite (Apple’s Addressbook.app)
export
custom XLS export
LDAP export
translation of user interface into German
better search
full text search
combined search
wildcard search
Change log
0.2 (2009-01-02)
Features
Multiple postal addresses, e-mail addresses, phone numbers and home page addresses per person are now possible.
Added XLS export for all stored data (not only the default addresses).
Added new attribute kind to postal address. Split street into address prefix and street.
Overview page of all address books now shows number of entries in each address book.
Bug fixes
E-Mail adresses with hyphen in host name where not enterable due to a picky constraint.
After changing a keyword title, persons using this keyword where no longer found in the keyword search because the index was not updated.
Changed sort order on person edit form: phone number is now displayed before e-mail address. Changed XLS export accordingly.
0.1.2 (2008-11-23)
Added recipe to safely install lxml dependency.
0.1.1 (2008-11-10)
Initial public release.
0.1 (2008-11-08)
Created pypi homepage.
Download
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
