Your First Useful Python Program

Introduction

A first program is more useful when it solves one complete problem. A study-time calculator is small enough to understand but still teaches input, numeric conversion, conditions, functions and output. The important habit is to separate what enters the program, how it is processed and what the user receives.

How the topic works

Use variables to store input, a function to perform the calculation and validation to reject impossible values. Keep the calculation independent from keyboard input so it can later be tested. Errors should explain what the user can do next rather than exposing a raw traceback for an expected mistake.

Practical workflow

1. Create a virtual environment and a project folder containing README and source files.
2. Ask for weekly minutes and study days, then convert both values safely.
3. Validate that minutes are positive and days are between one and seven.
4. Pass valid numbers into a function that returns minutes per study day.
5. Test boundary values and document how to run the program.

Tools and technologies

• Python 3
• venv for an isolated environment
• VS Code or another text editor

Example

If the goal is 300 minutes across five days, the function returns 60 minutes per day. If the user enters zero days or text where a number is expected, the program prints a clear correction message and exits without a traceback.

Common mistakes

• Putting input, calculation and printing in one long block
• Catching every exception without explaining the real problem
• Testing only the easiest valid number

Security and best practice

Do not use eval to convert input. Keep dependencies minimal, avoid collecting personal data and never commit environment folders or secrets to source control.

Portfolio task

Key takeaways

• Small functions make behaviour easier to test.
• Expected bad input deserves a clear message.
• A complete tiny project teaches more than disconnected syntax.

Curriculum connection

• Day 032: Variables, types and f-strings
• Day 034: Functions and return design
• Explore the complete Coding learning path