ghassbomb / mcqambridge

MCQambridge is an automated MCQ past-paper practice application for Cambridge A-levels, IGCSE, & O-levels.

Home Page:https://ghassbomb.pythonanywhere.com

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Logo
MCQambridge

Main Page

MCQambridge is an automated MCQ past paper solving application for Cambridge A-levels & IGCSE. I created it to simplify the process of checking answers, calculating scores, and percentages. It was created using Python and the web development trio. You can access it here or you can host it yourself. (I would appreciate if you hosted it locally, since my pythonanywhere site has limited bandwith; it's a simple five-step process!)

Usage

To begin, you first select a paper. You can choose between every Cambridge paper released 2018 and onwards. Aside from the year, you can choose between: subject, a-level, month, level (core, or extended?), and variant. Once you've chosen a paper, press submit.

Paper Page

When solving the paper, you are presented with the screen shown above. You select one of four lettered options, corresponding to the choices on the MCQ paper. You will be shown immediately if you are correct or incorrect. You can zoom in or out of the PDF, and navigate between pages.

Results Page

Once you are done with a paper, you will be shown your results. You will get your overall score, percentage, and also a question-by-question breakdown of the parts you got wrong.

Statistics Page

At any time, you can access a statistics page that showcases all the papers you've attempted so far and the results you got in them. This makes it easy to track your progress; to answer questions like 'am I getting better in subject x'?

Getting Started

Prerequisites

This project requires Python 3 (any version of Python 3 that supports the requirements will do).

Installation & Usage

  1. Clone the repository with: git clone https://github.com/ghassbomb/mcqambridge.git
  2. Change into the project directory: cd mcqambridge
  3. Create a virtualenv environment (optional)
  4. Install the required dependencies using pip: pip install -r requirements.txt
  5. Start the Flask development server: python app.py
  6. Enjoy!

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are welcome! If you have any suggestions, improvements, or bug fixes, please create a pull request. For major changes, please open an issue to discuss the changes beforehand. You can also contact me at ghass.shahzad@gmail.com for any requests and such.

Please read our contribution guidelines, and thank you for being involved!

License

This project is licensed under the MIT license.

See LICENSE for more information.

Acknowledgements

Thanks to Abbas Fanhim for providing the inspiration.

About

MCQambridge is an automated MCQ past-paper practice application for Cambridge A-levels, IGCSE, & O-levels.

https://ghassbomb.pythonanywhere.com

License:MIT License


Languages

Language:HTML 43.9%Language:Python 31.3%Language:JavaScript 24.8%