🖥️ Python Tutorial — sys Module

Introduction 🌟

The sys module provides access to variables, functions, and objects that interact directly with the **Python interpreter**. It is essential for tasks involving command-line arguments, runtime control, environment details, I/O redirection, and system-specific information.

Note

💡 sys = “System-specific parameters & functions”
💡 Most useful for CLI tools, automation scripts, debugging, and interpreter control

1. Importing the sys Module 🧱

import_sys.py

import sys

✔ Now you can interact with Python internals

2. Command-Line Arguments — sys.argv 🎯

sys_argv.py

import sys

print(sys.argv)  # list of command-line arguments

✔ sys.argv[0] → script name
✔ sys.argv[1] → first argument passed

Example: terminal usage

Code Snippet

python app.py 10 20

Output:

Code Snippet

['app.py', '10', '20']

Note

💡 Used for building CLI apps & tools.

3. Exiting the Program — sys.exit() 🚪

sys_exit.py

print("Before exit")
sys.exit()
print("This will not run")

✔ Stops program execution immediately
✔ Can pass an exit code: sys.exit(1)

4. Python Version Info — sys.version 🐍

version_info.py

print(sys.version)
print(sys.version_info)

✔ Helpful for environment debugging

5. Path Management — sys.path 🛣️

sys_path.py

print(sys.path)

✔ Shows directories Python searches for modules
✔ You can modify sys.path to import from custom folders

add_path.py

sys.path.append("C:/my_modules")

Note

💡 Useful when working with custom packages

6. Standard Input, Output, Error Streams 🧵

Standard Output — sys.stdout

stdout_example.py

sys.stdout.write("Hello World\n")

Standard Error — sys.stderr

stderr_example.py

sys.stderr.write("This is an error message\n")

Standard Input — sys.stdin

stdin_example.py

data = sys.stdin.read()
print(data)

✔ Useful for automation, pipelines, batch processing

7. Get System Platform Info 🖥️

platform_info.py

print(sys.platform)

✔ Returns OS type (win32, linux, darwin)

8. Recursion Limit — sys.getrecursionlimit() 🔁

recursion_limit.py

print(sys.getrecursionlimit())
sys.setrecursionlimit(2000)

Note

⚠️ Increasing recursion limit too much may crash your program.

9. Get Interpreter Information 🐍

executable_path.py

print(sys.executable)  # Python interpreter path

sys_prefix.py

print(sys.prefix)  # Virtual environment/base path

10. Memory Size of an Object — sys.getsizeof() 🧠

sizeof_example.py

print(sys.getsizeof(1000))  # bytes

✔ Useful for optimization & memory profiling

11. Real-World Example — CLI Calculator 🎯

cli_calculator.py

import sys

if len(sys.argv) < 3:
    print("Usage: python calc.py num1 num2")
    sys.exit()

n1 = int(sys.argv[1])
n2 = int(sys.argv[2])

print("Sum:", n1 + n2)

✔ Demonstrates command-line argument handling

12. Real-World Example — Logging Errors to stderr 🚨

stderr_logging.py

import sys

try:
    x = 10 / 0
except Exception as e:
    sys.stderr.write(f"Error: {e}\n")

13. SYS Module Cheat Sheet 📘

FeatureFunction
Argumentssys.argv
Exit programsys.exit()
Python versionsys.version
Module search pathssys.path
Recursion limitsys.getrecursionlimit()
Object sizesys.getsizeof()
Interpreter pathsys.executable
OS platformsys.platform

Best Practices 💡

  • ✔ Use sys.argv for command-line apps
  • ✔ Modify sys.path cautiously
  • ✔ Send debug messages to stderr
  • ✔ Avoid increasing recursion limit unless necessary
  • ✔ Use sys.exit() for controlled program termination

Conclusion 🎉

>>“The sys module connects Python to the interpreter itself — enabling power, control, and flexibility for developers.” ✨

You now fully understand the sys module! Want the next topic? Try Pathlib, Shutil, Subprocess, or Argparse. Just tell me! 😊