Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fsinfuhh/Bitpoll
A web application for scheduling meetings and general polling.
https://github.com/fsinfuhh/Bitpoll
django polling python3
Last synced: about 2 months ago
JSON representation
A web application for scheduling meetings and general polling.
- Host: GitHub
- URL: https://github.com/fsinfuhh/Bitpoll
- Owner: fsinfuhh
- License: gpl-3.0
- Created: 2017-07-11T15:42:36.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-10-30T15:47:03.000Z (about 2 months ago)
- Last Synced: 2024-10-30T16:27:07.543Z (about 2 months ago)
- Topics: django, polling, python3
- Language: Python
- Homepage:
- Size: 7.44 MB
- Stars: 248
- Watchers: 16
- Forks: 38
- Open Issues: 65
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Bitpoll
Bitpoll is a software to conduct polls about Dates, Times or general Questions.
This is a new version of the Dudel from opatut () used on , rewritten using the Django framework as a backend.
## Using Docker
The docker image is built automatically from the current master branch.
You can use the following commands to set up the docker container:
Create a directory for static and config files:
```bash
mkdir -p run/{log,static,config}
```
Get the example settings file and adapt it according to your needs:
```bash
wget https://raw.githubusercontent.com/fsinfuhh/Bitpoll/master/bitpoll/settings_local.sample.py -O run/config/settings.py
```
It is important to change at least the database settings, secret key, and allowed hosts.
Start the docker container:
```bash
docker run -a stdout -a stderr --rm --name bitpoll -p 3008:3008 -p 3009:3009 --volume ./run/static:/opt/static --volume ./run/config:/opt/config ghcr.io/fsinfuhh/bitpoll
```
The container is reachable on port 3009.
If you use an external web server, you can use uwsgi traffic on port 3008 and serve the static
assets from `run/static` at `/static/`.
## Manual Install
Get the code:
```bash
git clone https://github.com/fsinfuhh/Bitpoll
```
Generate a Python virtualenv and install dependencies:
```bash
virtualenv -p $(which python3) .pyenv
source .pyenv/bin/activate
pip install -r requirements.txt
```
Copy `bitpoll/settings_local.sample.py` to `bitpoll/settings_local.py` and customize the local settings.
Initialise Database:
```bash
./manage.py migrate
```
Run Testserver:
```bash
./manage.py runserver
```
## Production
In production Senty is used for error reporting.
django-auth-ldap is used vor login via ldap
uwsgi to serve the app
Install Dependencies for Production:
```bash
sudo apt install g++ make python3-psycopg2 python3-ldap3 gettext gcc python3-dev libldap2-dev libsasl2-dev
```
Install Python Dependencies
```bash
pip install -r requirements-production.txt
```
Configure examples are in `settings_local.py`
our used uwsgi config can be found at
For Production systems it is nessesarry to run
```bash
./manage.py compilemessages
./manage.py collectstatic
```
## Management of Dependencies
We use pip-tools to manage the dependencies.
After modification or the requirements*.in files or for updates of packages run
```bash
pip-compile --upgrade --output-file requirements.txt requirements.in
pip-compile --upgrade --output-file requirements-production.txt requirements-production.in requirements.in
```
to sync your enviroment with the requirements.txt just run
```bash
pip-sync
```
this will install/deinstall dependencies so that the virtualenv is matching the requirements file