https://github.com/gitkodev/exam-paper-generator

:closed_book: Lightweight tool to automate exam papers creation
https://github.com/gitkodev/exam-paper-generator

docx-generator education go

Last synced: about 8 hours ago
JSON representation

:closed_book: Lightweight tool to automate exam papers creation

• Host: GitHub
• URL: https://github.com/gitkodev/exam-paper-generator
• Owner: gitkoDev
• Created: 2024-02-05T07:06:32.000Z (10 months ago)
• Default Branch: main
• Last Pushed: 2024-02-11T10:29:27.000Z (9 months ago)
• Last Synced: 2024-02-12T03:25:57.576Z (9 months ago)
• Topics: docx-generator, education, go
• Language: Go
• Homepage:
• Size: 14.2 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# ESL Exam Paper Generator

> Tools used:

![Go](https://img.shields.io/badge/go-%2300ADD8.svg?style=for-the-badge&logo=go&logoColor=white)







Exam paper generator is a tool to help you generate random exam papers with the questions you provide. This program can come in handy for ESL teachers looking to automate their exam/test preparation. It's also aimed at prevention of students copying each other's answers to the same questions. Unique paper = unique answers.

This tool utilizes [go-docx](https://github.com/fumiama/go-docx) library to create a well-stuctured output in **docx** format.

# How it works

The process to use the tool is pretty simple:

1. Place your questions separated by new lines into the `put-your-questions-here.txt`  file. 

2. If the file is not present, it will be recreated at runtime, so refer to **step 3**.

3. Run the executive `test-paper-generator` file in `bin` the folder.

4. Enter the amount of required test papers and questions in each paper.

5. Get your output in the resulting `questions.docx`  file.

## Input example

```

What kind of physical and mental preparation do you think is necessary for running a marathon?

What are the benefits and drawbacks of modern art?

What do you think we should do to start treating animals better?

What topics do you think are best suited for podcasting?

What do you think people like most about yoga?

What age group do you think uses TikTok the most and why?

Why do you think some people love Karaoke?

Would you recommend your favourite movie to others? Why or why not?

Do you think watching sports can bring people from different cultures together?

How has technology changed the way schools operate compared to the past?

If you could implement a new subject or course in schools, what would it be and why?

```

## Output example