UCL-COMP0233-2023-2024 / RSE-Classwork

3 stars 65 forks source link

Refactoring - Part 1 #42

Open dpshelio opened 10 months ago

dpshelio commented 10 months ago

For this exercise, we will look at how to rewrite (refactor) existing code in different ways, and what benefits each new structure offers.

We will work with some code that describes a group of acquaintances, as we saw in a previous exercise (issue #).

Stage 1: Remove global variables

Look at the initial version of the file, which defines a specific group using a dictionary and offers some functions for modifying and processing it.

You may notice that the dictionary is a global variable: all the functions refer to it but do not take it as a parameter. This situation can lead to difficulties (why?), so we will restructure the code to avoid it.

Rewrite the functions so that they take in the dictionary that they work on as an argument. For example, the function that computes the average age should now look like:

def average_age(group):
    all_ages = [person["age"] for person in group.values()]
    return sum(all_ages) / len(group)

Your task:

  1. Fork the friend group if you haven't already
  2. Checkout the week09 branch and go to the week09/refactoring directory.
  3. Change average_group as above, and the other functions of group.py in a similar way.
  4. Update the section at the end of the file (after if __name__ == "__main__") to create the sample dictionary there, and running of the functions that alter it.
  5. Run your file to make sure the asserts still pass.
  6. Commit your changes!
  7. Create a pull request from your branch to the original friend-group repository and use the text in the description to link your PR to this issue Answers UCL-COMP0233-23-24/RSE-Classwork#42
  8. Think of the benefits and drawbacks of this approach compared to the original version.
  9. If you have time, think of other changes you consider useful and try them.