Declaring Variables and Naming Conventions

🧭 Context Introduction

Variables are the building blocks of any Python program. Think of them as labeled containers that store data—numbers, text, lists, or more complex objects. For engineers coming from infrastructure or operations backgrounds, understanding how Python handles variables is essential for writing automation scripts, configuration management tools, or monitoring solutions. This guide covers the fundamentals of declaring variables and the naming conventions that keep your code clean, readable, and maintainable.

⚙️ What Is a Variable in Python?

A variable is a name that refers to a value stored in memory. Unlike some other languages, Python does not require you to declare the type of a variable explicitly—it is inferred automatically when you assign a value.

Key characteristics:

• Variables are created the moment you assign a value to them.
• Python is dynamically typed, meaning the same variable can hold different types of data over its lifetime.
• Variable names are case-sensitive (e.g., myVar and myvar are different variables).

🛠️ Declaring Variables: Basic Syntax

Declaring a variable in Python is straightforward. Use the assignment operator = to bind a name to a value.

Basic examples:

• name = "server01" creates a variable called name holding the string "server01".
• cpu_cores = 8 creates a variable called cpu_cores holding the integer 8.
• memory_gb = 16.0 creates a variable called memory_gb holding the float 16.0.
• is_active = True creates a variable called is_active holding the boolean True.

Multiple assignments in one line:

• x, y, z = 10, 20, 30 assigns 10 to x, 20 to y, and 30 to z in a single line.

Assigning the same value to multiple variables:

• a = b = c = 0 assigns 0 to all three variables a, b, and c.

📊 Naming Conventions: Best Practices

Python has a style guide called PEP 8 that recommends specific naming conventions. Following these conventions makes your code more readable and consistent, especially when collaborating with other engineers.

General rules for variable names:

• Names must start with a letter (a–z, A–Z) or an underscore (_).
• The rest of the name can contain letters, digits (0–9), and underscores.
• Names cannot contain spaces or special characters like @, $, %.
• Names are case-sensitive.
• Avoid using Python reserved keywords (e.g., if, for, while, class, import) as variable names.

Recommended naming styles:

🕵️ Common Mistakes and How to Avoid Them

Mistake 1: Using reserved keywords as variable names

• ❌ class = "web-server" (invalid — class is a reserved keyword)
• ✅ server_class = "web-server" (valid)

Mistake 2: Starting a variable name with a number

• ❌ 1st_server = "web01" (invalid)
• ✅ first_server = "web01" or server_1 = "web01" (valid)

Mistake 3: Using spaces in variable names

• ❌ server name = "web01" (invalid)
• ✅ server_name = "web01" (valid)

Mistake 4: Confusing variable reassignment with type changes

• port = 8080 (port is an integer)
• port = "8080" (port is now a string — valid but can cause bugs if you expect an integer)

🧪 Practical Examples for Engineers

Example 1: Storing server configuration

• hostname = "prod-db-01"
• ip_address = "10.0.1.50"
• port = 5432
• is_primary = True

Example 2: Tracking resource metrics

• cpu_percent = 75.3
• memory_used_mb = 4096
• disk_usage_gb = 250
• network_rx_bytes = 1024000

Example 3: Using constants for configuration

• MAX_CONNECTIONS = 100
• DEFAULT_TIMEOUT_SECONDS = 30
• LOG_FILE_PATH = "/var/log/app.log"

✅ Summary Checklist for Variable Declaration

• [ ] Use snake_case for regular variable names.
• [ ] Use UPPER_CASE for constants.
• [ ] Start names with a letter or underscore, never a digit.
• [ ] Avoid reserved keywords.
• [ ] Keep names descriptive but concise (e.g., cpu_usage instead of cu).
• [ ] Be consistent with naming across your entire codebase.

📚 Next Steps

Now that you understand how to declare variables and follow naming conventions, the next topic in this series will cover Python Data Types — exploring strings, numbers, booleans, and how Python determines types automatically. This knowledge will help you write more precise and reliable automation scripts.

Variables store values in memory so engineers can reuse data throughout their code.

🟢 Example 1: Declaring a simple variable with a value

This example shows how to assign a number to a variable name.

engineer_count = 5
print(engineer_count)

📤 Output: 5

🔵 Example 2: Declaring multiple variables on separate lines

This example demonstrates declaring two different variables independently.

team_name = "Platform"
team_size = 12
print(team_name)
print(team_size)

📤 Output: Platform
📤 Output: 12

🟡 Example 3: Using snake_case naming convention

This example shows the standard naming style for variables in Python.

max_temperature_celsius = 85
sensor_reading_voltage = 3.3
print(max_temperature_celsius)
print(sensor_reading_voltage)

📤 Output: 85
📤 Output: 3.3

🟠 Example 4: Variable names with underscores for readability

This example demonstrates how underscores improve clarity in long variable names.

production_server_count = 10
staging_server_count = 3
total_servers = production_server_count + staging_server_count
print(total_servers)

📤 Output: 13

🔴 Example 5: Reassigning a variable to a new value

This example shows that variables can hold different values over time.

build_status = "pending"
print(build_status)
build_status = "completed"
print(build_status)

📤 Output: pending
📤 Output: completed

🟣 Example 6: Declaring variables with different data types

This example shows that variables can store strings, integers, and floats.

project_name = "Deploy Pipeline"
version_number = 2
deployment_time_seconds = 45.7
print(project_name)
print(version_number)
print(deployment_time_seconds)

📤 Output: Deploy Pipeline
📤 Output: 2
📤 Output: 45.7

⚪ Example 7: Invalid variable names that cause errors

This example shows what happens when engineers use illegal variable names.

# 1st_attempt = 100  # This would cause an error — starts with a number
first_attempt = 100
print(first_attempt)

📤 Output: 100

Comparison Table

🧭 Context Introduction

Variables are the building blocks of any Python program. Think of them as labeled containers that store data—numbers, text, lists, or more complex objects. For engineers coming from infrastructure or operations backgrounds, understanding how Python handles variables is essential for writing automation scripts, configuration management tools, or monitoring solutions. This guide covers the fundamentals of declaring variables and the naming conventions that keep your code clean, readable, and maintainable.

⚙️ What Is a Variable in Python?

A variable is a name that refers to a value stored in memory. Unlike some other languages, Python does not require you to declare the type of a variable explicitly—it is inferred automatically when you assign a value.

Key characteristics:

• Variables are created the moment you assign a value to them.
• Python is dynamically typed, meaning the same variable can hold different types of data over its lifetime.
• Variable names are case-sensitive (e.g., myVar and myvar are different variables).

🛠️ Declaring Variables: Basic Syntax

Declaring a variable in Python is straightforward. Use the assignment operator = to bind a name to a value.

Basic examples:

• name = "server01" creates a variable called name holding the string "server01".
• cpu_cores = 8 creates a variable called cpu_cores holding the integer 8.
• memory_gb = 16.0 creates a variable called memory_gb holding the float 16.0.
• is_active = True creates a variable called is_active holding the boolean True.

Multiple assignments in one line:

• x, y, z = 10, 20, 30 assigns 10 to x, 20 to y, and 30 to z in a single line.

Assigning the same value to multiple variables:

• a = b = c = 0 assigns 0 to all three variables a, b, and c.

📊 Naming Conventions: Best Practices

Python has a style guide called PEP 8 that recommends specific naming conventions. Following these conventions makes your code more readable and consistent, especially when collaborating with other engineers.

General rules for variable names:

• Names must start with a letter (a–z, A–Z) or an underscore (_).
• The rest of the name can contain letters, digits (0–9), and underscores.
• Names cannot contain spaces or special characters like @, $, %.
• Names are case-sensitive.
• Avoid using Python reserved keywords (e.g., if, for, while, class, import) as variable names.

Recommended naming styles:

🕵️ Common Mistakes and How to Avoid Them

Mistake 1: Using reserved keywords as variable names

• ❌ class = "web-server" (invalid — class is a reserved keyword)
• ✅ server_class = "web-server" (valid)

Mistake 2: Starting a variable name with a number

• ❌ 1st_server = "web01" (invalid)
• ✅ first_server = "web01" or server_1 = "web01" (valid)

Mistake 3: Using spaces in variable names

• ❌ server name = "web01" (invalid)
• ✅ server_name = "web01" (valid)

Mistake 4: Confusing variable reassignment with type changes

• port = 8080 (port is an integer)
• port = "8080" (port is now a string — valid but can cause bugs if you expect an integer)

🧪 Practical Examples for Engineers

Example 1: Storing server configuration

• hostname = "prod-db-01"
• ip_address = "10.0.1.50"
• port = 5432
• is_primary = True

Example 2: Tracking resource metrics

• cpu_percent = 75.3
• memory_used_mb = 4096
• disk_usage_gb = 250
• network_rx_bytes = 1024000

Example 3: Using constants for configuration

• MAX_CONNECTIONS = 100
• DEFAULT_TIMEOUT_SECONDS = 30
• LOG_FILE_PATH = "/var/log/app.log"

✅ Summary Checklist for Variable Declaration

• [ ] Use snake_case for regular variable names.
• [ ] Use UPPER_CASE for constants.
• [ ] Start names with a letter or underscore, never a digit.
• [ ] Avoid reserved keywords.
• [ ] Keep names descriptive but concise (e.g., cpu_usage instead of cu).
• [ ] Be consistent with naming across your entire codebase.

📚 Next Steps

Now that you understand how to declare variables and follow naming conventions, the next topic in this series will cover Python Data Types — exploring strings, numbers, booleans, and how Python determines types automatically. This knowledge will help you write more precise and reliable automation scripts.

Variables store values in memory so engineers can reuse data throughout their code.

🟢 Example 1: Declaring a simple variable with a value

This example shows how to assign a number to a variable name.

engineer_count = 5
print(engineer_count)

📤 Output: 5

🔵 Example 2: Declaring multiple variables on separate lines

This example demonstrates declaring two different variables independently.

team_name = "Platform"
team_size = 12
print(team_name)
print(team_size)

📤 Output: Platform
📤 Output: 12

🟡 Example 3: Using snake_case naming convention

This example shows the standard naming style for variables in Python.

max_temperature_celsius = 85
sensor_reading_voltage = 3.3
print(max_temperature_celsius)
print(sensor_reading_voltage)

📤 Output: 85
📤 Output: 3.3

🟠 Example 4: Variable names with underscores for readability

This example demonstrates how underscores improve clarity in long variable names.

production_server_count = 10
staging_server_count = 3
total_servers = production_server_count + staging_server_count
print(total_servers)

📤 Output: 13

🔴 Example 5: Reassigning a variable to a new value

This example shows that variables can hold different values over time.

build_status = "pending"
print(build_status)
build_status = "completed"
print(build_status)

📤 Output: pending
📤 Output: completed

🟣 Example 6: Declaring variables with different data types

This example shows that variables can store strings, integers, and floats.

project_name = "Deploy Pipeline"
version_number = 2
deployment_time_seconds = 45.7
print(project_name)
print(version_number)
print(deployment_time_seconds)

📤 Output: Deploy Pipeline
📤 Output: 2
📤 Output: 45.7

⚪ Example 7: Invalid variable names that cause errors

This example shows what happens when engineers use illegal variable names.

# 1st_attempt = 100  # This would cause an error — starts with a number
first_attempt = 100
print(first_attempt)

📤 Output: 100

Comparison Table