This Pyramid app handles membership for C3S SCE (Cultural Commons Collecting Society SCE mit beschränkter Haftung).
The app that once started as a form to gain new members has grown to a membership administration system catering to the needs of a growing European cooperative (C3S SCE).
Some features:
- Internationalisation (i18n)
- Membership information is persisted in a database.
- GnuPG encrypted mail with details submitted is sent to C3S staff.
- Once the email is verified, form submission data is used to populate a pdf with form fields (using fdf and pdftk) and the resulting PDF is ready for download.
- Membership certificates (pdflatex)
- Membership dues (pdflatex)
There is plenty of documentation under /docs, both in this repository and in the running app (if you have sphinx to compile the docs to HTML):
cd docs
make html
A compiled version of the documentation is available at: https://yes.c3s.cc/docs/
Install development dependencies:
$ sudo apt-get install python-pip python-dev python2.7-dev \
python-virtualenv libxml2-dev libxslt1-dev build-essential \
pdftk zlib1g-dev chromium
Clone the repo and cd into the c3sMembership folder.
For selenium tests to work, Determine your chromium --version
and download the chromedriver with the fitting version number from https://sites.google.com/chromium.org/driver/downloads. E.g. for chromium 90 enter:
$ wget https://chromedriver.storage.googleapis.com/90.0.4430.24/chromedriver_linux64.zip
$ unzip chromedriver_linux64.zip
$ rm chromedriver_linux64.zip
Make sure chromedriver can be found in your path, e.g.:
$ echo $PATH
$ mv chromedriver ~/bin # or 'sudo mv chromedriver /usr/bin' for system-wide availability
Fonts: The .odt files for the membership application in pdftk require the font Signika which can be downloaded from: https://www.google.com/fonts/specimen/Signika
Our membership software is bilingual, currently English and German. So make sure you have the German locale installed:
$ sudo apt-get install -y locales
$ sudo sed -i 's/^# *\(de_DE.UTF-8\)/\1/' /etc/locale.gen
$ sudo locale-gen
Install LaTeX pdf compilation dependencies:
$ sudo apt-get install texlive-latex-base texlive-latex-recommended \
texlive-latex-extra texlive-fonts-recommended texlive-fonts-extra \
texlive-pictures texlive-lang-german texlive-luatex
Setup the virtual environment:
$ python -m venv env
Activate the virtual environment and update pip and setuptools:
$ source env/bin/activate
$ pip install --upgrade pip setuptools
$ pip install -r requirements.txt
If your experience problems with the distribute
package like ImportError: No module named _markerlib
, try easy_install distribute
.
Install c3sMembership:
$ pip install -e .
Install documentation compilation dependencies:
$ sudo apt-get install graphviz default-jdk-headless
$ mkdir utils
$ wget 'http://downloads.sourceforge.net/project/plantuml/plantuml.jar' \
-O utils/plantuml.jar
$ pip install sphinx sphinxcontrib-plantuml
Copy .env.example
to .env
and adjust the MEMBERSHIP_*
values as needed (default ones are examples or for local development) :
$ cp .env.example .env
Note
The variables in .env
can also be set via envvars. Envvars have precedence over .env
.
Note
If you change the MEMBERSHIP_NOTIFICATION_SENDER_GPGID
, the public gpg key has to be available in ./keys/*GPGID.asc
.
Create an initial database:
$ initialize_c3sMembership_db development.ini
Run:
$ source env/bin/activate
$ pserve development.ini --reload
The app will rebuild templates and reload code whenever there are changes by using --reload.
Run:
$ source env/bin/activate
$ pserve production.ini start
Make sure to activate the virtual environment:
$ source env/bin/activate
$ pytest
Migrate database if database model changed (changed models.py?):
$ source env/bin/activate
$ # Backup database
$ cp c3sMembership.db c3sMembership.db.$(date "+%Y-%m-%d_%H-%M-%S")
$ # Upgrade database
$ alembic upgrade head
See https://yes.c3s.cc/docs/development/changes_branches_releases.html#the-production-branch