Code has been added to clipboard!

The Python Comment: How to Leave One in Your Code

Reading time 2 min
Published Feb 7, 2020
Updated Feb 10, 2020

TL;DR – By leaving Python comments, you can make the code more readable and simplify collaboration.

The purpose of Python comments

Like most other coding languages, Python allows the developer to comment on their code. Comments are strings of text that you can read when viewing the source code. However, they are not executed when running the code. They are mainly used to explain how the code works.

There are two main reasons to use this functionality:

  • Comments allow you to understand your code when you revisit it after a while. This makes debugging and updating easier.
  • A clearly commented code is easier to share and collaborate on, as it eliminates the need of explaining your lines to the colleagues.

How to leave comments in Python

Leaving a comment in Python is simple – all you need to do is add a hash mark (#) in front of your comment:

Example
Here you see a code line.
#here you see a comment!

A Python comment doesn't have to occupy a separate line – you can simply add it at the end of your code line. No symbols after the hash mark will be executed:

Example
a simple code line #an inline comment

Python comment blocks

A Python multiline comment is also known as a comment block. Unlike some other programming languages (e.g., JavaScript), Python does not have special syntax for multiline comments. Developers simply leave a few single-line comments in a row:

Example
a code line
# a gorgeous multiline comment
# that spans over three lines
# because it needs its personal space
another code line

Another way to leave a Python comment block is by using a delimiter, which is three double quotemarks ("""):

Example
these are code lines
"""
this is a multiline string that belongs to no variable
because of that, Python will read it but not execute it
so it basically acts like a comment
"""
getting back to the code

However, this does not technically create a Python comment. Instead, you get a multiline string which cannot be executed because it's not assigned to any variable. The system reads the code but ignores it, so technically, it works like a Python multiline comment. Most developers don't recommend this practice for beginners, as it can potentially cause errors.

Python comment: useful tips

  • You can comment out Python code when testing or debugging. Add a hash mark in front of a line to disable it temporarily, and then run the code to see whether the bug still occurs. This way, you can easily find the exact section of the code that causes the issue.
  • There are tools (e.g., pdoc and pydoc) that allow you to generate documentation from the multiline docstrings in your code.
Append
Array
Class
Command Line Arguments
Comment
Enumerate
Functions
Groupby
If... else
Map
Not Equal
Print
Queue
Random
Range
Round
Set
Sorting Lists
Split
Time
Train_test_split
Variables
While Loop