The os module provides functions for interacting with the operating system — file paths, directories, environment variables, and processes — in a way that works across different platforms.

Syntax

import os
os.getcwd()
os.listdir(".")
os.environ.get("HOME")
os.path.join("a", "b")

Deep Dive Course

os abstracts over differences between operating systems, so the same Python code can list a directory, join file paths, or read environment variables whether it's running on Windows, macOS, or Linux — joining two path segments, for example, produces the correct separator for whichever OS the code is actually running on. os.environ gives dictionary-like access to environment variables, commonly used for configuration and secrets that shouldn't be hardcoded into source code, and functions like os.listdir, os.mkdir, and os.remove handle basic file-system operations.

1Understanding os Module

💡

Always build file paths with os.path.join(), or the newer pathlib.Path, instead of manually concatenating strings with slashes — hardcoding a forward slash breaks on Windows, and hardcoding a backslash breaks on Unix-like systems.

editor.html

import os
print(os.path.join("folder", "subfolder", "file.txt"))

localhost:3000

2Practical Example

Here is a real-world application of os Module showing how it is used in production Python code.

editor.html

import os
api_key = os.environ.get("API_KEY", "not set")
print(api_key)

localhost:3000

3Best Practices

Follow these guidelines when working with os Module:

1. Use os.path.join() or pathlib.Path instead of manually concatenating path strings with hardcoded slashes

2. Read configuration and secrets from os.environ instead of hardcoding them directly into source code

3. Prefer the newer pathlib module for new code doing significant path manipulation — it offers a more readable, object-oriented API over the same underlying functionality

⚠️

Tip: Always build file paths with os.path.join(), or the newer pathlib.Path, instead of manually concatenating strings with slashes — hardcoding a forward slash breaks on Windows, and hardcoding a backslash breaks on Unix-like systems.

editor.html

import os
print(os.path.join("folder", "subfolder", "file.txt"))

localhost:3000

Examples

Example 01Basic Usage

import os
print(os.path.join("folder", "subfolder", "file.txt"))

Example 02Advanced Example

import os
api_key = os.environ.get("API_KEY", "not set")
print(api_key)

Best Practices

Use os.path.join() or pathlib.Path instead of manually concatenating path strings with hardcoded slashes
Read configuration and secrets from os.environ instead of hardcoding them directly into source code
Prefer the newer pathlib module for new code doing significant path manipulation — it offers a more readable, object-oriented API over the same underlying functionality

Interview Question

Why is os.path.join() preferred over manually concatenating path segments with a hardcoded slash?▼

Hint: Think about running the same code on different operating systems.

Different operating systems use different path separators — Unix-like systems use a forward slash, while Windows uses a backslash. os.path.join() automatically inserts whichever separator is correct for the operating system the code is actually running on, so the same source code produces valid paths everywhere. Hardcoding a specific slash character works on one platform but silently produces incorrect paths on the other.

Exercises

MediumPractice using os Module in a real scenario.

View Solution

import os
print(os.path.join("folder", "subfolder", "file.txt"))

Frequently Asked Questions

Why is os.path.join() preferred over manually concatenating path segments with a hardcoded slash?▼

Related Functions

sys-moduleopen()with-statement