Computer Science Flash Cards

This is a little website I've put together to allow me to easily make flash cards and quiz myself for memorization of:

  • general cs knowledge
    • vocabulary
    • definitions of processes
    • powers of 2
    • design patterns
  • code
    • data structures
    • algorithms
    • solving problems
    • bitwise operations

Will be able to use it on: - desktop - mobile (phone and tablet)

It uses:

  • Python 3
  • Flask
  • SQLite

Important Note

I dont recommend my flash card set.

The set included in this project (cards-jwasham.db) is not my full set, and is way too big already.

Thanks for asking for my list of 1,792 cards. But its too much. I even printed them out. Its 50 pages, front and back, in tiny text. It would take about 8 hours to just read them all.

If you look at my set, youll just get discouraged.

My set includes a lot of obscure info from books Ive read and machine learning knowledge.

Please make your own set, and while youre making them, only make cards for what you need to know. Otherwise, it gets out of hand.

Don't be like me.

How to run it on a server

  1. Clone project to a directory on your web server.
  2. Edit the config.txt file. Change the secret key, username and password. The username and password will be the login for your site. There is only one user - you.
  3. Follow this long tutorial to get Flask running. It was way more work than it should be: https://www.digitalocean.com/community/tutorials/how-to-serve-flask-applications-with-uwsgi-and-nginx-on-ubuntu-16-04
    • wsgy.py is the entry point. It calls flash_cards.py
    • This is my systemd file /etc/systemd/system/flash_cards.service: view
      • you can see the paths where I installed it, and the name of my virtualenv directory
    • when done with tutorial:
    sudo systemctl restart flash_cards
    sudo systemctl daemon-reload
    
  4. When you see a login page, you're good to go.
  5. Uncomment the commented block in flash_cards.py
  6. Restart Flask. You have to use sudo systemctl restart flash_cards.
  7. Hit the URL /initdb on your web server. You'll see a message that the database has been initialized.
  8. Comment that code again.
  9. Restart Flask.
  10. Go to / on your webserver.
  11. Log in.
  12. Click the "General" or "Code" button and make a card!
  13. When you're ready to start memorizing, click either "General" or "Code" in the top menu.

How to run with Docker

Provided by @Tinpee - tinpee.dev@gmail.com

Make sure you already installed docker

  1. Clone project to any where you want and go to source folder.
  2. Edit the config.txt file. Change the secret key, username and password. The username and password will be the login for your site. There is only one user - you.
  3. Build image: docker build . -t cs-flash-cards
  4. Run container: docker run -d -p 8000:8000 --name cs-flash-cards cs-flash-cards
  5. Go your browser and type http://localhost:8000
  6. To back up your cards db, run docker cp cs-flash-cards:/src/cards.db /path/to/save

Happy learning!

Description
Mini website for testing both general CS knowledge and enforce coding practice and common algorithm/data structure memorization.
Readme 487 KiB
Languages
HTML 53.6%
Python 35.1%
JavaScript 5%
CSS 5%
Dockerfile 0.8%
Other 0.5%