{"id":21070886,"url":"https://github.com/gitkodev/exam-paper-generator","last_synced_at":"2025-03-14T02:42:58.048Z","repository":{"id":221163964,"uuid":"752950707","full_name":"gitkoDev/exam-paper-generator","owner":"gitkoDev","description":":closed_book: Lightweight tool to automate exam papers creation","archived":false,"fork":false,"pushed_at":"2024-02-11T10:29:27.000Z","size":14925,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-16T07:41:38.500Z","etag":null,"topics":["docx-generator","education","go"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gitkoDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-05T07:06:32.000Z","updated_at":"2024-02-11T11:15:54.000Z","dependencies_parsed_at":"2024-02-11T03:25:47.052Z","dependency_job_id":"6bd520d8-78d6-424a-a2c2-e7020abdd862","html_url":"https://github.com/gitkoDev/exam-paper-generator","commit_stats":null,"previous_names":["gitkodev/dgfls_exam_app","gitkodev/test-paper-generator","gitkodev/exam-paper-generator"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitkoDev%2Fexam-paper-generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitkoDev%2Fexam-paper-generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitkoDev%2Fexam-paper-generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitkoDev%2Fexam-paper-generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitkoDev","download_url":"https://codeload.github.com/gitkoDev/exam-paper-generator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243513982,"owners_count":20303048,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docx-generator","education","go"],"created_at":"2024-11-19T18:48:46.514Z","updated_at":"2025-03-14T02:42:58.027Z","avatar_url":"https://github.com/gitkoDev.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ESL Exam Paper Generator\n\n\u003e Tools used:\n\n![Go](https://img.shields.io/badge/go-%2300ADD8.svg?style=for-the-badge\u0026logo=go\u0026logoColor=white)\n\u003ca href=\"https://github.com/fumiama/go-docx\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Go-Docx-blue\"/\u003e\n\u003c/a\u003e\n\n\n\n\nExam 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.\n\nThis tool utilizes [go-docx](https://github.com/fumiama/go-docx) library to create a well-stuctured output in **docx** format.\n\n# How it works\n\nThe process to use the tool is pretty simple:\n\n1. Place your questions separated by new lines into the `put-your-questions-here.txt`  file. \n2. If the file is not present, it will be recreated at runtime, so refer to **step 3**.\n3. Run the executive `test-paper-generator` file in `bin` the folder.\n4. Enter the amount of required test papers and questions in each paper.\n5. Get your output in the resulting `questions.docx`  file.\n\n## Input example\n\n```\nWhat kind of physical and mental preparation do you think is necessary for running a marathon?\nWhat are the benefits and drawbacks of modern art?\nWhat do you think we should do to start treating animals better?\nWhat topics do you think are best suited for podcasting?\nWhat do you think people like most about yoga?\nWhat age group do you think uses TikTok the most and why?\nWhy do you think some people love Karaoke?\nWould you recommend your favourite movie to others? Why or why not?\nDo you think watching sports can bring people from different cultures together?\nHow has technology changed the way schools operate compared to the past?\nIf you could implement a new subject or course in schools, what would it be and why?\n```\n\n\n## Output example\n\n\u003cimg src=\"./raw/output-example.jpg\" alt=\"output example\" width=\"500px\"/\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitkodev%2Fexam-paper-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitkodev%2Fexam-paper-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitkodev%2Fexam-paper-generator/lists"}