Collatz Chains

Introduction

If you are a student completing this project as part of a class at Allegheny College, please check the Proactive Programmers Discord server for the assignment's due date. You can learn more about this assignment by reading the Computing Averages project description on the Proactive Programmers web site. Please note that the content provided in the README file for this GitHub repository is an overview of the project and thus does not include the details concerning all the steps needed to successfully complete the every project deliverable. Finally, it is important to point out that your repository for this project was created from the GitHub repository template called collatz-creation-starter. You can check this repository for any updates to this project's documentation or source code.

Seeking Assistance

Even though the course instructor will have covered all of the concepts central to this project before you start to work on it, please note that not every detail needed to successfully complete the assignment will have been covered during prior classroom sessions. This is by design as an important skill that you must practice as a proactive programmer is to search for and then understand and ultimately apply the technical content found in additional resources.

Emerging proactive programmers who have questions about this project are invited to ask them in either the GitHub discussions forum or the Proactive Programmers Discord server. Before you ask your question, please read the advice concerning how to best participate in the Proactive Programmers community. If you find a mistake in this project, please describe it and propose a solution by creating an issue in the GitHub Issue Tracker.

Project Overview

After cloning this repository to your computer, please take the following steps:

• Make sure that you have already installed and know how to use all of the programming tools that are mentioned in the description of the Proactive Skills.
• Follow the instructions on the Proactive Programmers web site for this project to take all of the needed steps and to complete all of the required deliverables.
• Use the cd command to change into the directory for this repository.
• Install the dependencies for the project by typing poetry install.
• Run the program by typing the following command:
  • Run the program with few inputs: poetry run collatzcreator --minimum 1 --maximum 10 --display
  • Run the program with many inputs: poetry run collatzcreator --minimum 1 --maximum 1000
  • Run the program in Project Euler configuration: poetry run collatzcreator --minimum 1 --maximum 1000000 --display
  • Please note that the program will not work unless you add the required source code
  • You should also try to run the program with only the --help flag so that you can learn more about the command-line arguments that it should completely implement.
• Please confirm that the program is producing the expected output by looking in the appropriate section of the project description on the Proactive Programmers web site and, moreover, talking with the course instructor.
• If you have already installed the GatorGrade program that runs the automated grading checks provided by GatorGrader you can, from the repository's base directory, run the automated grading checks by typing gatorgrade --config config/gatorgrade.yml.
• You may also review the output from running GatorGrader in GitHub Actions.
• Don't forget to provide all of the required responses to the technical writing prompts in the writing/reflection.md file.
• Please make sure that you completely delete the TODO markers and their labels from all of the provided source code. This means that instead of only deleting the TODO marker from the code you should delete the TODO marker and the entire prompt and then add your own comments to demonstrate that you understand all of the source code in this project.
• Please make sure that you also completely delete the TODO markers and their labels from every line of the writing/reflection.md file. This means that you should not simply delete the TODO marker but instead delete the entire prompt so that your reflection is a document that contains polished technical writing that is suitable for publication on your professional web site.
• Refer to the Project Euler site for more details!