Python for Kids: Making a Word Count Tool

Table of Contents

  1. Introduction
  2. Prerequisites
  3. Setting up Python
  4. Creating the Word Count Tool
  5. Running the Word Count Tool
  6. Conclusion

Introduction

In this tutorial, we will learn how to create a simple Word Count Tool using Python. This tool will take a text file as input and count the number of words in it. It is a great exercise for beginners to practice basic file handling and string manipulation in Python.

By the end of this tutorial, you will be able to write a Python script that can accept a text file, count the number of words in it, and display the result.

Prerequisites

Before you start this tutorial, you should have a basic understanding of Python programming concepts such as variables, functions, and conditionals. It would also be helpful if you are familiar with file handling in Python.

Setting up Python

To get started, you need to have Python installed on your computer. You can download the latest version of Python from the official website (https://www.python.org/downloads/). Choose the appropriate version for your operating system and follow the installation instructions.

To verify that Python is installed correctly, open a terminal or command prompt and type python --version. You should see the version number of Python displayed.

Creating the Word Count Tool

  1. Open your favorite code editor and create a new Python file named word_count_tool.py.

  2. Begin by defining a function named count_words. This function will take a filename as input and return the number of words in the file. Here’s the initial code: 
     def count_words(filename):
     try:
         with open(filename, 'r') as file:
             text = file.read()
             word_count = len(text.split())
             return word_count
     except FileNotFoundError:
         print("File not found!")

  3. Let’s quickly go through the code. First, we use a try block to handle any potential errors that may occur. Within the try block, we use the with open(filename, 'r') as file statement to open the specified file in read mode. We then read the entire contents of the file into the text variable using file.read().

  4. We then split the text into words using the split() method, which returns a list of words. We find the number of words by using the len() function on the resulting list.

Now, let’s handle the case where the file is not found. In the except block, we simply print a helpful error message.

  1. Next, we need to define the main function to interact with the user. Add the following code after the count_words function: 
     def main():
     filename = input("Enter the filename: ")
     word_count = count_words(filename)
     print(f"The file '{filename}' contains {word_count} words.")
	
 if __name__ == "__main__":
     main()

    Here, we define the main() function that prompts the user to enter the filename. We then call the count_words() function with the filename as an argument and store the result in the word_count variable. Finally, we display the result to the user using f-strings.

The if __name__ == "__main__": line ensures that the main() function is only executed when the script is run directly, and not when it is imported as a module.

Congratulations! You have successfully created the Word Count Tool. Now, let’s see how to run it.

Running the Word Count Tool

  1. Open a terminal or command prompt and navigate to the directory where you saved the word_count_tool.py file.

  2. To run the script, type python word_count_tool.py and press Enter.

  3. The script will prompt you to enter the filename. Make sure to provide the full path of the text file you want to count the words for. For example, if the file is located in the same directory as the script, you can simply enter the file name.

  4. After entering the filename, press Enter. The script will process the file, count the words, and display the result.

  5. If the file is not found, an error message will be displayed.

You can now use the Word Count Tool to count the words in any text file.

Conclusion

In this tutorial, we learned how to create a simple Word Count Tool using Python. We covered the basics of file handling, string manipulation, and function definition. By following the step-by-step instructions, you should now be able to create and run the Word Count Tool on your own.

Remember to practice and explore different functionalities of Python to enhance your programming skills. Use this tool as a starting point and try adding more features like counting characters or lines in a text file.

Keep coding and have fun!

Published:

Related Articles