Documentation
Python में Software Engineering Principles
Adam Spannbauer
Machine Learning Engineer at Eastman
Python में Documentation
- टिप्पणियाँ
# Square the number x
- डॉकस्ट्रिंग्स
"""Square the number x
:param x: number to square
:return: x squared
>>> square(2)
4
"""
Comments
# 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!!
Effective comments
'what' पर टिप्पणी
# Define people as 5
people = 5
# Multiply people by 3
people * 3
'why' पर टिप्पणी
# There will be 5 people attending the party
people = 5
# We need 3 pieces of pizza per person
people * 3
Docstrings
def function(x):
"""High level description of function
Additional details on function
Docstrings
def function(x):
"""High level description of function
Additional details on function
:param x: description of parameter x
:return: description of return value
Docstrings
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
उदाहरण docstring
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
उदाहरण docstring आउटपुट
help(square)
square(x)
Square the number x
:param x: number to square
:return: x squared
>>> square(2)
4
अभ्यास करते हैं
Python में Software Engineering Principles
