C2.1 · Organize programs and files logically

Ontario Grade 11 Computer Science

Computer Environments and Systems

A practical approach to keeping a computer science project clear and easy to work with

What you will learn

• Explain what it means to organize a program and its files logically.
• Group related files and use clear, consistent names.
• Describe how a simple Python 3 program can use a function stored in another file.
• Check whether a project’s organization makes its contents easy to locate and understand.

1. Start with purpose and relationships

• Identify the project’s purpose before arranging its files.
• Keep related materials together and distinguish unrelated work.
• Choose names that help a reader recognize a file’s purpose.
• Use folders when they clarify groups of project materials.

2. Make the structure understandable

• Use names that distinguish files meaningfully.
• Let grouping and names work together to show purpose.
• Keep the structure appropriate to the project’s size.
• Review the arrangement from another reader’s point of view.

3. Connect organization to a small program

• A file’s name and contents should have a recognizable purpose.
• In Python 3, import can connect a program file to another Python file.
• For the example input 4, the displayed result is 12.
• Use multiple files when the grouping makes the program easier to understand.

4. Review and improve the arrangement

• Review names, grouping, and the relationship between program files.
• Use a trace to explain what happens across the example’s files.
• Revise unclear organization so another person can locate project parts.

Trace of the two-file Python example

Worked example

Plan a small project’s files

1. Identify the project materials
   The project has program code and instructions. Keep both with the project so a classmate can find the materials needed to understand it.
2. Name files by purpose
   Use names such as main.py for the program’s interaction and instructions.txt for the brief directions. These are proposed descriptive names, not mandatory names.
3. Check the result
   A reader should be able to identify the program and its instructions from the names. If the project later gains another related program file, keep it with this project and name it for its role.

Worked example

Connect two Python 3 files

# club_cost.py
def cost_for_members(members):
    return members * 3

# main.py
from club_cost import cost_for_members
members = int(input("Members: "))
total = cost_for_members(members)
print("Total:", total)

1. Give each file a role
   Place the calculation in club_cost.py and the interaction in main.py. In this Python 3 example, the main file imports a function from the other file.
2. Trace the input
   The input is the integer 4. The function receives 4 as members and returns members multiplied by 3, so its result is 12.
3. Derive the displayed result
   The main file stores the returned value in total and prints it with a label. The resulting output line is Total: 12. This result follows by tracing the code; it was not produced by executing it.

Worked example

Improve unclear project names

1. Match each file to its purpose
   Rename the files using the known roles: member_input.py for the member-count interaction, meeting_cost.py for the cost calculation, and instructions.txt for the usage directions. Keep a name such as notes.txt only if its purpose is clear; otherwise revise it or remove it if it is not needed.
2. Keep related project materials together
   The programs and instructions belong with this project. A project folder with a descriptive name makes them easier to distinguish from unrelated work.
3. Test the names with a reader
   Ask someone to identify the cost calculation and instructions from the names alone. If the names do not help them find those files, make the names more specific.

Common mistakes and how to avoid them

Lesson summary

• Logical organization makes program files and related materials easier to locate and understand.
• Group files by project and purpose; choose clear, consistent names.
• Use multiple files when the separation clarifies the parts of the program.
• Review the arrangement from the perspective of someone who did not create it.

Check your understanding

Key terms

File

A named item stored on a computer, such as a program or a set of instructions.

Folder

A place used to group files and, when appropriate, other folders.

Import

In Python, a way for one program file to use a named item from another file.

Trace

A step-by-step account of how input and program instructions lead to a value or output.

Continue through ICS3U

View the complete ICS3U Ontario Grade 11 Computer Science curriculum and lessons

• C1.4 · Relate programming operations to hardware components
• C2.2 · Plan protection against malware and data loss
• C1.1 · Match internal computer components to user needs
• C1.2 · Interpret processor, memory, and storage specifications
• C1.3 · Select peripherals for a user task
• C2.3 · Back up and archive user files

About this lesson and its review

Published by DoAssignment. This reviewed lesson follows Ontario Grade 11 Computer Science (ICS3U), expectation C2.1. It is a study resource, not an official curriculum publication.

Before publication, content is checked for structure, mathematical or chemical notation, calculations, course boundaries, and readability. Errors can still occur, so corrections are welcomed.

Official curriculum reference

Report a correction or ask a question