Software Engineering Principles in Python
Adam Spannbauer
Machine Learning Engineer at Eastman
# Square the number x
"""Square the number x
:param x: number to square
:return: x squared
>>> square(2)
4
"""
# This is a valid comment
x = 2
y = 3 # This is also a valid comment
# You can't see me unless you look at the source code
# Hi future collaborators!!
Commenting 'what'
# Define people as 5
people = 5
# Multiply people by 3
people * 3
Commenting 'why'
# There will be 5 people attending the party
people = 5
# We need 3 pieces of pizza per person
people * 3
def function(x):
"""High level description of function
Additional details on function
def function(x):
"""High level description of function
Additional details on function
:param x: description of parameter x
:return: description of return value
Example webpage generated from a docstring in the Flask package.
def function(x):
"""High level description of function
Additional details on function
:param x: description of parameter x
:return: description of return value
>>> # Example function usage
Expected output of example function usage
"""
# function code
def square(x):
"""Square the number x
:param x: number to square
:return: x squared
>>> square(2)
4
"""
# `x * x` is faster than `x ** 2`
# reference: https://stackoverflow.com/a/29055266/5731525
return x * x
help(square)
square(x)
Square the number x
:param x: number to square
:return: x squared
>>> square(2)
4
Software Engineering Principles in Python