{"id":23683992,"url":"https://github.com/januschung/math-worksheet-generator","last_synced_at":"2025-04-04T19:11:53.127Z","repository":{"id":37968572,"uuid":"296986095","full_name":"januschung/math-worksheet-generator","owner":"januschung","description":"Create basic addition, subtraction, multiplication and division practice questions with the answer sheet","archived":false,"fork":false,"pushed_at":"2023-07-26T19:30:17.000Z","size":196,"stargazers_count":514,"open_issues_count":4,"forks_count":92,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-03-28T18:14:03.825Z","etag":null,"topics":["addition","children","division","education","hacktoberfest","homeschooling","learning","learning-exercise","math","math-worksheet-generator","mathematics","maths","multiplication","subtraction","teacher-preparation","teaching-materials","teaching-tool","worksheet","worksheet-answers"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/januschung.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2020-09-20T02:17:40.000Z","updated_at":"2025-03-21T17:01:23.000Z","dependencies_parsed_at":"2023-10-21T11:56:47.038Z","dependency_job_id":null,"html_url":"https://github.com/januschung/math-worksheet-generator","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/januschung%2Fmath-worksheet-generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/januschung%2Fmath-worksheet-generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/januschung%2Fmath-worksheet-generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/januschung%2Fmath-worksheet-generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/januschung","download_url":"https://codeload.github.com/januschung/math-worksheet-generator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247234922,"owners_count":20905854,"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":["addition","children","division","education","hacktoberfest","homeschooling","learning","learning-exercise","math","math-worksheet-generator","mathematics","maths","multiplication","subtraction","teacher-preparation","teaching-materials","teaching-tool","worksheet","worksheet-answers"],"created_at":"2024-12-29T20:31:43.972Z","updated_at":"2025-04-04T19:11:53.110Z","avatar_url":"https://github.com/januschung.png","language":"Python","readme":"# Math Worksheet Generator\n\n![sample worksheet](sample.png)\n![sample answer sheet](sample-answer.png)\n\n## Background\nMy best friend tests his 5 year old basic math questions from store-bought material which is good for one time use (his son memorizes the answers) …. but he wants to give him more practice.\n\nTwo solutions:\n1. keep buying more one time usage materials (less beer budget); or\n2. make question sets with the number pairs and calculate the answer for each question manually (less beer time)\n\nNot ideal.\n\nThat's the reason for me to look into an automate way to get the job done.\n\n## Benefit of the Math Worksheet Generator\nWith the Math Worksheet Generator, you can create a PDF with unique questions, as needed, in a fraction of second.\n\nThere are five choices:\n1. Addition\n2. Subtraction\n3. Multiplication\n4. Division\n5. Mixed\n\n## Requirements\n[python3.11](https://www.python.org/downloads/)\n\nInstall required package with the following command:\n```\npip install -r requirements.txt\n```\n\n## How to Use\n1. Generate the worksheet in pdf format with the following command:\n```\npython3 run.py --type [+|-|x|/|mix] --digits [1|2|3] [-q|--question_count] [int] --output [custom-name.pdf]\n```\n2. Print out the generated file `worksheet.pdf`\n\nFor addition only worksheet:\n```\npython3 run.py --type +\n```\nFor calculation up to 3 digits range:\n```\npython3 run.py --digits 3\n```\nFor generating different number of question, eg. 100 (default is 80):\n```\npython3 run.py -q 100\n```\nor\n```\npython3 run.py --question_count 100\n```\nFor custom output filename (default is worksheet.pdf):\n```\npython3 run.py --output custom-name.pdf\n```\n\n## Sample\n[sample worksheet](sample-worksheet.pdf)\n\n## Code Overview\nEverything is written in python in `run.py`. You can play with the font and grid size with the variables under the `# Basic settings` section.\n\n## Contributing\nI appreciate all suggestions or PRs which will help kids learn math better. Feel free to fork the project and create a pull request with your idea.\n\n## TODO\n1. Add date/name/score section to the front page\n\n## Special Thanks\nMy long time friend San for the inspiration of this project and lovely sons Tim and Hin. Thanks [thedanimal](https://github.com/thedanimal) for reviewing this README and adding new features.\n\nAlso, thank you for the love and support form the [Reddit Python community](https://www.reddit.com/r/Python/comments/ja5y2m/made_this_tool_with_python_and_my_son_now_hates_me/). You guys are amazing and are helping me to make this project better.\n\n## Successful Story\nThanks [k1m0ch1](https://github.com/k1m0ch1) for sharing this heartwarming story:\n\u003e...I made this card for my kid, and then the teacher asks me if I can make some for the kids, well its generated anyway and very helpful, and the next day he asks me to make for a whole class, and next day he wants me to make for a whole school, and a weeks later other schools want me to help to make for a whole school.    \n    more than 1000 generated file, with a custom filename for every kid and sent to the email\n    I'm doing it for free, while you made this free, love it \u003c3\n\n## Links\nThank you for your coverage. \n\n[PyCoder's Weekly Issue #442](https://pycoders.com/issues/442)\n\n[PyCoder's Weekly Twitter](https://twitter.com/pycoders/status/1316379986417381376)\n\n[Real Python Facebook](https://www.facebook.com/LearnRealPython/posts/1688239528018053?__tn__=-R)\n\n[Github Trends Telegram](https://t.me/githubtrending/9007)\n\n[Python Trending Twitter](https://twitter.com/pythontrending/status/1316659466935373826)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjanuschung%2Fmath-worksheet-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjanuschung%2Fmath-worksheet-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjanuschung%2Fmath-worksheet-generator/lists"}