Turtle Racing Game

This repository contains a simple turtle racing game implemented in Python using the turtle module. Players can choose the number of turtles to race, and the turtles will move forward a random distance until one of them crosses the finish line. The winner is announced at the end of the race.

Features

User input to select the number of racers (2 to 10).
Randomly moving turtles using the turtle and random modules.
Dynamic creation and positioning of turtles.
Display of the winner at the end of the race.

Requirements

Python 3.x
turtle module (usually included with Python standard library)

How to Run

Clone the repository:

git clone https://github.com/TheToriqul/Turtle-Racing.git
cd Turtle-Racing

Run the Python script:
```
python app.py
```
Follow the on-screen instructions to enter the number of players (between 2 and 10).
Watch the turtles race and see which one wins!

Code Explanation

Constants

WIDTH, HEIGHT = 700, 600
COLORS = ['red', 'green', 'blue', 'orange', 'yellow', 'black', 'purple', 'pink', 'brown', 'cyan']

WIDTH and HEIGHT define the dimensions of the turtle racing window.
COLORS is a list of colors that the turtles can have.

Function Definitions

`get_number_of_racers()`

def get_number_of_racers():
    racers = 0
    while True:
        racers = input("Enter the number of players (2 - 10): ")
        if racers.isdigit():
            racers = int(racers)
        else:
            print("Please enter a numeric number between 2 and 10. Try again!")
            continue

        if 2 <= racers <= 10:
            return racers
        else:
            print("Please enter a numeric number between 2 and 10. Try again!")
            continue

Prompts the user to enter the number of racers.
Ensures the input is a numeric value between 2 and 10.

`race(colors)`

def race(colors):
    turtles = create_turtles(colors)

    while True:
        for racer in turtles:
            distance = random.randrange(1, 20)
            racer.forward(distance)

            x, y = racer.pos()
            if y >= HEIGHT // 2 - 10:
                return colors[turtles.index(racer)]

Starts the race and moves each turtle forward by a random distance.
Checks if any turtle has crossed the finish line and returns the color of the winning turtle.

`create_turtles(colors)`

def create_turtles(colors):
    turtles = []
    spacing = WIDTH // (len(colors) + 1)
    for i, color in enumerate(colors):
        racer = turtle.Turtle()
        racer.color(color)
        racer.shape('turtle')
        racer.left(90)
        racer.penup()
        racer.setpos(-WIDTH//2 + (i + 1) * spacing, -HEIGHT//2 + 20)
        racer.pendown()
        turtles.append(racer)

    return turtles

Creates and positions the turtles at the start line based on the number of racers.

`init_turtle()`

def init_turtle():
    screen = turtle.Screen()
    screen.setup(WIDTH, HEIGHT)
    screen.title('Turtle Racing!')

Initializes the turtle screen with the specified width and height.
Sets the title of the window to "Turtle Racing!"

Main Execution

racers = get_number_of_racers()
init_turtle()

random.shuffle(COLORS)
colors = COLORS[:racers]

winner = race(colors)
print("The winner is the turtle with color:", winner)
time.sleep(5)

Gets the number of racers from the user.
Initializes the turtle screen.
Shuffles the list of colors and selects a subset based on the number of racers.
Starts the race and prints the color of the winning turtle.
Pauses for 5 seconds before closing the window.

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any changes.

Acknowledgements

The turtle module documentation: https://docs.python.org/3/library/turtle.html
Python's random module documentation: https://docs.python.org/3/library/random.html

Enjoy racing your turtles! 🐢🚀

TheToriqul/turtle-racing