Libre alternative to Doodle
Project description
What is jawanndenn?
jawanndenn is a simple web application to schedule meetings and run polls, a libre alternative to Doodle. It is written in Python and JavaScript using
Materialize Material Design CSS/JS
jawanndenn is libre software developed by Sebastian Pipping. The server code is licensed under the GNU Affero GPL license version 3 or later whereas the client code is licensed under the GNU GPL license version 3 or later.
Please report bugs and let me know if you like it.
Installation
To install the latest release without cloning the Git repository:
# pip install jawanndenn
To install from a Git clone:
# python setup.py install --user
Deployment with Apache mod_wsgi
To use jawanndenn with mod_wsgi, there is file jawanndenn/app.wsgi For how to integrate jawanndenn/app.wsgi with the Apache configuration, please check the the related documentation of bottle.
Feel free to file a support ticket or drop me a mail, if you cannot get it to work.
Run with docker
You can build a docker image using docker-compose build and run it with docker-compose up.
Serialized data is saved to ~/.jawanndenn-docker/ outside the container (only if the server shuts down). The app is served on localhost:8080.
Command line usage
When installed, invocation is as simple as
# jawanndenn
During development, you may want to run jawanndenn from the Git clone using
# PYTHONPATH=. python jawanndenn/main.py --debug
Currently supported arguments are:
# jawanndenn --help usage: jawanndenn [-h] [--debug] [--host HOST] [--port PORT] [--url-prefix PATH] [--database-pickle FILE] [--server BACKEND] [--max-polls COUNT] [--max-votes-per-poll COUNT] [--dumpdata] [--first-poll NUMBER] [--first-poll-option NUMBER] [--first-ballot NUMBER] [--first-vote NUMBER] optional arguments: -h, --help show this help message and exit --debug Enable debug mode (default: disabled) --host HOST Hostname or IP address to listen at (default: 127.0.0.1) --port PORT Port to listen at (default: 8080) --url-prefix PATH Path to prepend to URLs (default: "") --database-pickle FILE File to write the database to (default: ~/jawanndenn.pickle) --server BACKEND bottle backend to use (default: tornado); as of this writing bottle supports: auto, bjoern, diesel, eventlet, gae, gevent, gunicorn, meinheld, paste, twisted, waitress, wsgiref. For the most current list, please check the documentation of bottle. limit configuration: --max-polls COUNT Maximum number of polls total (default: 1000) --max-votes-per-poll COUNT Maximum number of votes per poll (default: 40) data export arguments: --dumpdata Dump a JSON export of the database to standard output, then quit. --first-poll NUMBER Lowest primary key to use for poll objects (default: 1) --first-poll-option NUMBER Lowest primary key to use for poll option objects (default: 1) --first-ballot NUMBER Lowest primary key to use for ballot objects (default: 1) --first-vote NUMBER Lowest primary key to use for vote objects (default: 1)
Goals
Libre software to host yourself, unlike Doodle
More simple, sexy and/or fun than libre alternatives, in alphabetic order:
(Foodle (discontinued; on GitHub, ex. DFN scheduler, ex. DFN Terminplaner+))
Framadata (Sources, ex. OpenSondage, ex. STUdS)
Keep things simple, usable, maintainable
Support invocation from the command line, e.g. for spontaneous polls in a LAN
Have security in mind
Please check out the list of upcoming features.
Non-goals
Use of heavy frameworks: building blocks only
Read availability from calendars
Thanks
Special thanks to Arne Maier (@KordonDev) for reporting an XSS vulnerability, responsibly.
Project details
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.
Source Distribution
Built Distribution
Hashes for jawanndenn-1.6.3-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 70946698693c5212f0b670ba614aeab5966bf70683a0274997671a28c19ce72d |
|
MD5 | a886f6020f3b335345ad171add30b588 |
|
BLAKE2b-256 | d3467fa5f3e99666c1f717bae39746a2c8f38a5f98c3317e5af68907a121eb93 |