Thanks so much for your interest in Lumen Learning! We appreciate you taking the time to review this code and give us feedback on how it could be improved. Please do not spend any longer than half an hour reviewing this project.

What do I need to do?

There are two steps to completing this review. Please create an email and send it to james@lumenlearning.com which includes your work on the two steps.

The first step is to look through the code in this repository, especially in astronauts.py where all of the major logic is located. Note any lines of code you believe either deserve special praise as being very clear or which you believe should be improved in any fashion - either to make the meaning more clear or fix any bugs which you have found.

Please collect your notes in the form of:

{file name} {line number} {your comment}

For instance:

file name	line number	comment
astronautsTests.py	1	Thanks for writing us some great unit tests!

Also, please remember that you are communicating with a colleague when making these notes.

The second step is to write up answers for the following questions:

• Please describe your experience providing or receiving code reviews like this. If you've never done a review like this before, that's completely okay - just let us know!
• Did you run the code locally?
• Would any other explanation be helpful in understanding the code and what it was meant to accomplish?

What is this code supposed to do?

This program takes a number of astronauts in a list. Each astronaut is a dictionary object in the form of:

• String name the astronaut's full name
• Datetime applicationDate: the date when the astronaut applied to be on a ship
• List of String preferredShip; a list of the names of each ship in the order that the astronaut would like to be stationed on them. Every preferredShip is guaranteed to include all available spaceships and the strings are only spaceship names.

Then there are spaceships, in the form of:

• String name: the spaceship's name
• Datetime expeditionDate: the day when the spaceship will launch
• Number capacity: always a positive integer, the number of astronauts a spaceship can hold
• List of astronaut objects: originally an empty list, the function assignToSpaceships will add assigned astronauts to this list.

Every astronaut is to be assigned to the spaceship based on when their application was received. Every astronaut should be given their highest preferred spaceship which has not yet run out of capacity. If the astronaut's first choice spaceship is full, then they should be placed on their second choice spaceship, and so on until they have been placed on a spaceship.

There will never be more astronauts to be assigned than there is combined capacity of spaceships.

It is just fine for a spaceship to only have one - or even zero - astronauts assigned to it.

Once assignment is completed, each astronaut should receive a message in the following form:

Congratulations {astronaut name}. You have been assigned to journey into the heart of the universe on the Spaceship {spaceship name}. Please be prepared to start your journey on { expedition date formatted as month/day/year }.

Those will be printed out to the console for now.

If I wanted to run the code locally, how would I do that?

1. Install Python 3. Here is a (highly comprehensive article)[https://realpython.com/installing-python/] that walks you through that process if you don't have Python installed.
2. Download the files to your computer, either through git or via the "Download Zip" link that you see when you click the Green "Code" button on the (project homepage)[https://github.com/lumenlearning/astronauts-py].
3. To run the program itself, run python astronauts.py.
4. To run tests, run python astronautTests.py

Feel free to email us if you have any questions!