Python: Build a Simple Command-Line Calculator

Python Command-Line Calculator Tutorial

This tutorial will guide you through building a simple command-line calculator using Python. We’ll focus on clear, concise code and explanations, perfect for beginners.

Introduction

We’ll create a program that takes two numbers and an operation (+, -, , /) as input from the user and performs the calculation. Let’s start with the very basic structure.

Example 1: Basic Addition

This example will only handle addition. We’ll build a simple function to perform the addition.


def add(x, y):
  """This function adds two numbers."""
  result = x + y
  return result

# Get input from the user
num1 = float(input("Enter first number: "))
num2 = float(input("Enter second number: "))

# Calculate the sum
sum_result = add(num1, num2)

# Print the result
print("The sum is:", sum_result)

Let’s break down what this code does:

def add(x, y):: This defines a function named `add` that takes two arguments, `x` and `y`.
result = x + y: This line adds the values of `x` and `y` and stores the result in the variable `result`.
return result: This line returns the calculated `result` from the function.
num1 = float(input("Enter first number: ")): This prompts the user to enter the first number. The input() function returns a string, so we convert it to a floating-point number using float().
num2 = float(input("Enter second number: ")): This does the same as above for the second number.
sum_result = add(num1, num2): This calls the `add` function with `num1` and `num2` as arguments and stores the returned result in the variable `sum_result`.
print("The sum is:", sum_result): This prints the final result to the console.

Common Mistake: Forgetting to convert the input from a string to a number using `float()` or `int()`. This will cause a TypeError. If you try to add a string to a number directly, Python won’t know what to do.


# Example Usage:
# Enter first number: 10
# Enter second number: 5
# The sum is: 15.0

Output:


Enter first number: 10
Enter second number: 5
The sum is: 15.0

Example 2: Adding Multiple Operations

Now, let’s expand this to handle addition, subtraction, multiplication, and division. We’ll use an `if/elif/else` structure to determine the operation to perform.


def calculate(x, y, operation):
  """This function performs a calculation based on the given operation."""
  if operation == '+':
    return x + y
  elif operation == '-':
    return x - y
  elif operation == '':
    return x  y
  elif operation == '/':
    if y == 0:
      return "Error: Division by zero!"
    else:
      return x / y
  else:
    return "Invalid operation"

# Get input from the user
num1 = float(input("Enter first number: "))
num2 = float(input("Enter second number: "))
operation = input("Enter operation (+, -, , /): ")

# Calculate the result
result = calculate(num1, num2, operation)

# Print the result
print("Result:", result)

Key changes and explanations:

We created a `calculate` function that takes three arguments: `x`, `y`, and `operation`.
Inside the function, we use if/elif/else statements to check the value of `operation` and perform the corresponding calculation.
We included a check for division by zero to prevent the program from crashing.
We added an `else` block to handle invalid operations.


# Example Usage:
# Enter first number: 10
# Enter second number: 5
# Enter operation (+, -, , /): +
# Result: 15.0
#
# Enter first number: 10
# Enter second number: 5
# Enter operation (+, -, , /): -
# Result: 5.0
#
# Enter first number: 10
# Enter second number: 5
# Enter operation (+, -, , /): 
# Result: 50.0
#
# Enter first number: 10
# Enter second number: 5
# Enter operation (+, -, , /): /
# Result: 2.0
#
# Enter first number: 10
# Enter second number: 0
# Enter operation (+, -, , /): /
# Result: Error: Division by zero!
#
# Enter first number: 10
# Enter second number: 5
# Enter operation (+, -, , /): ^
# Result: Invalid operation

Output:


Enter first number: 10
Enter second number: 5
Enter operation (+, -, , /): +
Result: 15.0

Example 3: User-Friendly Interface

Let’s improve the user interface slightly. We’ll present the options to the user and handle potential errors more gracefully.


def calculate(x, y, operation):
  """This function performs a calculation based on the given operation."""
  if operation == '+':
    return x + y
  elif operation == '-':
    return x - y
  elif operation == '':
    return x  y
  elif operation == '/':
    if y == 0:
      return "Error: Division by zero!"
    else:
      return x / y
  else:
    return "Invalid operation"

while True:
  try:
    num1 = float(input("Enter first number: "))
    num2 = float(input("Enter second number: "))
    operation = input("Enter operation (+, -, , /) or 'q' to quit: ")
    
    if operation == 'q':
      break
    
    result = calculate(num1, num2, operation)
    print("Result:", result)
  
  except ValueError:
    print("Invalid input. Please enter numbers or a valid operation.")
  except Exception as e:
    print(f"An error occurred: {e}")

Changes:

We added a while True loop to allow the user to perform multiple calculations until they choose to quit.
We added a check for the input ‘q’ to exit the program.
We used a try/except block to handle potential ValueError (if the user enters non-numeric input) and other exceptions. This makes the program more robust.


# Example Usage:
# Enter first number: 5
# Enter second number: 3
# Enter operation (+, -, , /): +
# Result: 8.0
#
# Enter first number: 10
# Enter second number: 2
# Enter operation (+, -, , /): -
# Result: 8.0
#
# Enter first number: 7
# Enter second number: 0
# Enter operation (+, -, , /): /
# Result: Error: Division by zero!
#
# Enter first number: abc
# Invalid input. Please enter numbers or a valid operation.
#
# Enter first number: 8
# Enter second number: 4
# Enter operation (+, -, , /): 
# Result: 32.0
#
# Enter first number: 12
# Enter second number: 6
# Enter operation (+, -, , /): q
#

Output:


Enter first number: 5
Enter second number: 3
Enter operation (+, -, , /): +
Result: 8.0