This is a console/text based personal information manager, i.e. a contact manager, written in standard C (C99)
There are 4 branches which each use a different method of storing the contacts
master uses cvector_void to store both contacts and attributes.
vector_template uses cvector_contact and cvector_attribute generated using the template-like macros in CVector.
linked_list uses an intrusive doubly linked list and helper functions and macros based closely on list.h from the Linux kernel.
sqlite uses a sqlite3 database with a single contacts table. It also uses cvector_attribute for attributes while manipulating a contact. Because they're arbitrary, attributes are stored as a single text column in the table, '\n' delimited naturally since that's how they're read from the user, and there's a function to go from that format to a vector of attributes and vice versa.
I wrote this for the following reasons:
-
To contrast with my really old C PIM project available here.
-
As a platform for reaquainting myself with designing and writing new code.
-
As a reason to improve my C helper libraries and create more. Also to have a something to practice using said libraries. It's hard to design a library/API without actually using it. It also serves as a "real-life" test suite. I think real use is the best kind of testing.
-
To increase my Vim knowledge (ok all programming does this)
You can use the included Makefile:
cd build
make
...
./cpim2
Or you can regenerate it or generate your own build system/project with premake5:
premake5 gmake
cd build
make
...
./cpim2
The instructions for using it are (hopefully) pretty self-explanatory, just a menu of actions to take, adding, searching, editing etc.
