Skip to content

duvholt/memorizer

Repository files navigation

Memorizer

Build Status codecov

Memorizer is a webapp written in Python 3 using Flask and SQLAlchemy meant to be used for answering multiple choice questions. It was created specifically for answering older multiple choice exams.

Currently running on https://memorizer.io/

Warning for users who want to adopt this project:

This project has been used as playground for me (duvholt) to experiment with different implemenations. The whole project is built upon the reinvent-the-wheel principle. I have deliberately avoided to build the app on big frameworks (well expect for SQLAlchemy - because who would want to deal with that mess). A good example of this is the homebrewed templating framework used to dynamically update the site.

Features

  • Multiple choice answering
  • Support for several categories with subcategories (courses and exams)
  • Statistics about answered questions
  • Correct answer combo
  • Random question which will select an unanswered question if possible
  • Keyboard support
    • Left/right arrows (or a/d) for previous/next question
    • 1, 2, 3, 4 to select answer
    • Space (or q) to answer
    • r to load a random question

Installation

  • Requires pipenv to be installed
pipenv install # Install requirements
pipenv shell
./main.py db upgrade # Create/upgrade database tables
./main.py import questions/*.json # Import all questions (Warning: super slow if using SQLite)
./main.py runserver # Run webserver

Local config

To overwrite configuration in memorizer/config.py create an new file called memorizer/localconfig.py.

Example:

DEBUG = True
GOOGLE_ANALYTICS = 'UA-XXXXXXXX-Y'
SQLALCHEMY_DATABASE_URI = 'postgresql://username@localhost/memorizer'

Administrator

Deleting courses, exams and questions are only available to administrators. To make a user an administrator run the following command:

pipenv run ./main.py admin <username_here>

Big thanks to all the contributors!

About

A simple webapp for memorizing multiple choice answers

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published