Why Naming rules and conventions in Python? - Purpose & Use Cases

The Big Idea

What if your code could tell its story clearly without you explaining every line?

The Scenario

Imagine you are writing a story with many characters, but you call some 'hero', others 'h', and some 'x1'. Later, you try to remember who did what, but the names confuse you and your friends reading the story.

The Problem

Without clear naming rules, your code becomes a jumble. You spend extra time guessing what variables mean, make mistakes by mixing them up, and fixing bugs takes forever.

The Solution

Using naming rules and conventions is like giving every character a clear, meaningful name. It helps you and others understand the story quickly, avoid confusion, and write code that is easy to read and fix.

Before vs After

✗ Before

x = 10
y = 20
z = x + y
print(z)

✓ After

first_number = 10
second_number = 20
sum_result = first_number + second_number
print(sum_result)

What It Enables

Clear naming lets you write code that feels like a well-told story, easy to follow and share with others.

Real Life Example

When building a shopping app, naming variables like total_price and item_count helps everyone understand what the code does without guessing.

Key Takeaways

Naming rules prevent confusion and mistakes.

Good names make code easier to read and maintain.

Consistent conventions help teams work together smoothly.

Practice

1. Which of the following is a valid variable name in Python?

easy

A. my-variable

B. 2ndVariable

C. my_variable

D. my variable

Solution

1. Step 1: Check the first character of each name

   Python variable names must start with a letter or underscore, not a number or special character.

2. Step 2: Identify invalid characters

   Names cannot contain spaces or hyphens. Only letters, digits, and underscores are allowed.

3. Final Answer:

   my_variable -> Option C

4. Quick Check:

   Valid variable name = my_variable [OK]

Hint: Variable names start with letter/underscore, no spaces or hyphens [OK]

Common Mistakes:

• Starting variable name with a number
• Using hyphens instead of underscores
• Including spaces in variable names

2. Which of these is the correct way to name a class in Python?

easy

A. MyClass

B. my_class

C. myclass

D. myClass

Solution

1. Step 1: Recall class naming convention

   Class names in Python use CapitalizedWords style (PascalCase), starting with uppercase letters.

2. Step 2: Compare options to convention

   Only 'MyClass' follows CapitalizedWords style correctly.

3. Final Answer:

   MyClass -> Option A

4. Quick Check:

   Class name style = CapitalizedWords [OK]

Hint: Class names use CapitalizedWords (PascalCase) [OK]

Common Mistakes:

• Using lowercase or underscores for class names
• Starting class names with lowercase letters
• Mixing camelCase with underscores

3. What will be the output of this code?

_count = 5
Count = 10
print(_count + Count)

medium

A. NameError

B. 15

C. SyntaxError

D. 510

Solution

1. Step 1: Understand variable names and case sensitivity

   Python variable names are case-sensitive, so '_count' and 'Count' are different variables.

2. Step 2: Calculate the sum of the two variables

   _count = 5 and Count = 10, so 5 + 10 = 15.

3. Final Answer:

   15 -> Option B

4. Quick Check:

   5 + 10 = 15 [OK]

Hint: Variable names are case-sensitive; add values accordingly [OK]

Common Mistakes:

• Ignoring case sensitivity and treating variables as same
• Expecting concatenation instead of addition
• Assuming syntax or name errors

4. Find the error in this variable name:

user-name = 'Alice'

medium

A. Variable names cannot contain hyphens

B. Variable names cannot start with a letter

C. Variable names cannot contain underscores

D. Variable names cannot be lowercase

Solution

1. Step 1: Identify invalid characters in variable names

   Hyphens are not allowed in Python variable names because they are interpreted as minus signs.

2. Step 2: Confirm other options are incorrect

   Variable names can start with letters, contain underscores, and be lowercase.

3. Final Answer:

   Variable names cannot contain hyphens -> Option A

4. Quick Check:

   Hyphens not allowed in names [OK]

Hint: No hyphens in variable names; use underscores instead [OK]

Common Mistakes:

• Using hyphens instead of underscores
• Thinking variable names can't start with letters
• Confusing underscores with invalid characters

5. You want to create a dictionary where keys are variable names and values are their types. Which naming style is best for the keys?

variables = { 'UserName': str, 'user_age': int, '2ndUser': str }

Which keys follow Python naming rules and conventions?

hard

A. 'user_age' only

B. All keys are valid

C. 'UserName' only

D. 'UserName' and 'user_age' only

Solution

1. Step 1: Check each key for naming rules

   'UserName' starts with a letter and uses CapitalizedWords (good for class names). 'user_age' uses lowercase with underscore (good for variables). '2ndUser' starts with a number, which is invalid.

2. Step 2: Identify keys following naming conventions

   'UserName' and 'user_age' follow naming rules; '2ndUser' does not.

3. Final Answer:

   'UserName' and 'user_age' only -> Option D

4. Quick Check:

   Keys must start with letter; numbers not allowed [OK]

Hint: Keys must start with letter; numbers not allowed [OK]

Common Mistakes:

• Allowing keys starting with numbers
• Ignoring naming conventions for readability
• Assuming all strings are valid variable names