Rapid learning process for people with tight schedules. Implementation of flash cards in Python 3 and Django.
Although I've enjoyed working on this project and sharing it with the community, I decided that v1.2.4 was the final version. It has been a reliable companion on my journey, and - who knows - perhaps it also helped others to get through a demanding stage of life.
Please mind that dependencies and bugs won't be patched anymore. I'm sure you'll find a lot of great alternatives on GitHub if you search for the term "leitner method".
Improve your learning effectiveness using the Leitner system. It uses a simple algorithm that asks you for cards in the first areas more frequently. Correctly answered cards are moved to the next area. Incorrectly answered cards are moved back to the previous area ("defensive mode") or first area ("strict mode").
Organize your flash cards in categories and find faster what you're looking for. You can even share your categories with your classmates!
You don't have any clue what your flash card is talking about? No problem, just write short clues and display them if you need to.
Use these features on your mobile phone or tablet as well!
Create personalized user accounts for your friends with their own categories and cards.
If you intend to migrate your existing cards, just use the /api/v1/categories/ and /api/v1/cards/ endpoints.
docker pull joeig/memodrop:latest
docker run -d -P --name memodrop joeig/memodrop:latest
docker exec -ti memodrop python manage.py createsuperuser
docker port memodropThis commands are starting a standalone web service with a local SQlite database in development mode. This is the quickest way to get memodrop running.
In this case, the database file is part of the container volume. If you remove the container, obviously, your data will be removed as well. Also, this setup doesn't work well if you expect more than a few concurrent users. It should never run anywhere else than on localhost.
You should provide a custom settings file in memodrop/settings/production.py (template: production.py.dist) containing the configuration for an external DBMS like PostgreSQL or MySQL and your own secret key.
The following guide is using Django's development server again, so consider using Gunicorn, uWSGI or mod_wsgi (WSGI interface: memodrop.wsgi:application, memodrop/wsgi.py). The static assets should rather be served by a webserver like nginx rather than WSGI (use python manage.py collectstatic).
Enable your custom settings as following:
docker run -d -P --name memodrop \
-v /path/to/your/production.py:/usr/src/app/memodrop/settings/production.py:ro \
-e DJANGO_SETTINGS_MODULE=memodrop.settings.production \
joeig/memodrop:latest
docker exec -ti memodrop python manage.py createsuperuser
docker port memodrop- Install Python 3
- You may want to create a virtual environment now.
- Install the dependencies:
python setup.py install - Production preparation: Copy
memodrop/settings/production.py.disttomemodrop/settings/production.pyand adjust the values - Create a database or let Django do that for you (it will choose SQLite3 by default)
- Migrate the database:
python manage.py migrate [--settings memodrop.settings.production] - Create a super-user account:
python manage.py createsuperuser [--settings memodrop.settings.production] -
- Start the application with its WSGI interface
memodrop/wsgi.py - Alternative for developers: Start the standalone web service:
python manage.py runserver [--settings memodrop.settings.production]
- Start the application with its WSGI interface
You can do this with super-user permissions in Django's administration interface (/admin/).
The API needs a user-specific token to authorize requests. This is accomplished by dispatching an Authorization: Token <token> header with all API requests.
Tokens are user-specific and can be optained by perfoming a POST request containing the username and password to the authorization endpoint /api/v1/auth-token/. Example:
$ curl -X POST --data "username=<username>&password=<password>" "http://127.0.0.1:8000/api/v1/auth-token/"
{
"token": "091c4c1204422cb682cc9426d097d492a56a2013"
}
Basically, every task is executed synchronously. But under certain circumstances, you don't want to block user requests until time-consuming tasks have finished. If you are considering to run a setup with thousands of cards and users, you can enable asynchronous processing using the Q_CLUSTER setting in production.py.dist. After that, start the cluster workers using the following command: python manage.py qcluster [--settings memodrop.settings.production]
You should also read the official docs regarding Django Q.
The /admin/health/ route exposes a status endpoint which usually returns 200 OK if the application is healthy.
Setup the development environment:
python setup.py develop
pip install -e ".[dev]"There are some fixtures for different scenarios:
python manage.py loaddata demo_users # use demo credentials from categories/fixtures/demo_users.yaml
python manage.py loaddata demo_categories
python manage.py loaddata demo_share_contracts
python manage.py loaddata demo_cardsFeel free to write and run some unit tests after you've finished your work.
coverage run manage.py test .
coverage report
flake8Commit and tag your work (following the Semantic Versioning 2.0.0 guidelines):
bumpversion patch # use major, minor or patch
git push origin master --follow-tags