This is an archived version of the course. Please find the latest version of the course on the main webpage.

Chapter 3: Refactor your robot!

Creating a RobotFactory class

face Josiah Wang

It will be even better to just turn this set of robot initialiser functions into a coherent class whose one job is to create a new robot. We can call the class RobotFactory (or RobotInitialiser if you prefer).

You can start by defining the RobotFactory class and turning all the functions into methods (remember to add self as the first parameter to each of these methods).

Initialising RobotFactory

Then, add a constructor __init__(). I noticed that to initialise a robot, we need a list of potential robot names. Rather than passing this around all the time, let us just make the list of robot names as an attribute! The RobotFactory can then just have access to these whenever it needs them!

Similarly, you could have other attributes like prev_id and grid_size. This will free you from having to pass these values each time you invoke the methods.

Remember to add self when you use each of these attribute in your methods (e.g. self.grid_size)

Updating the methods

The next thing you could do is to rename your methods to be more concise. For example, I renamed initialise_robot() to create_robot(), generate_robot_name() to generate_name() (because we already know that this is a factory to create Robots), generate_random_position() to generate_position() (because we know that we are generating an initial position for the new robot), etc. If you think that you only want users to use a single public method create_robot() and not the others, you can put an underscore in front of each to indicate that they are only meant for internal use (e.g. _generate_name(), _generate_id()).

Create multiple robots in one go

I also realised that I can actually just have a create_robots() method (note plural) to create multiple robots in one go, rather than having the main program create robots one by one. This can help abstract out the for loop in the main program, bringing that responsibility to RobotFactory instead. You can allow users to define how many robots to create with a count input argument.

Create a new RobotFactory instance

Once you are done, update main.py to import the class (from robot_init import RobotFactory), and update your code to create a new RobotFactory instance and call the create_robots() method.

When you are done, remember to commit your latest changes to your repo.