info/learnxinyminutes-docs
1
0
Fork 0
mirror of https://github.com/adambard/learnxinyminutes-docs.git synced 2025-08-05 14:27:51 +02:00
Code Issues Releases Wiki Activity

Merge pull request #693 from mickelus/master

Browse Source 
[python/en] naming conventions and underscores
This commit is contained in:
Levi Bostian
2014-08-06 09:54:41 -05:00
parent d1541f8534 a30c76789e
commit 1c2bc08e19
2 changed files with 22 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
python.html.markdown
View File

@@ -439,7 +439,10 @@ class Human(object):
# A class attribute. It is shared by all instances of this class # A class attribute. It is shared by all instances of this class
species = "H. sapiens" species = "H. sapiens"
# Basic initializer # Basic initializer, this is called when this class is instantiated.
# Note that the double leading and trailing underscores denote objects
# or attributes that are used by python but that live in user-controlled
# namespaces. You should not invent such names on your own.
def __init__(self, name): def __init__(self, name):
# Assign the argument to the instance's name attribute # Assign the argument to the instance's name attribute
self.name = name self.name = name
@@ -526,10 +529,12 @@ def double_numbers(iterable):
# Note xrange is a generator that does the same thing range does. # Note xrange is a generator that does the same thing range does.
# Creating a list 1-900000000 would take lot of time and space to be made. # Creating a list 1-900000000 would take lot of time and space to be made.
# xrange creates an xrange generator object instead of creating the entire list like range does. # xrange creates an xrange generator object instead of creating the entire list like range does.
_xrange = xrange(1, 900000000) # We use a trailing underscore in variable names when we want to use a name that
# would normally collide with a python keyword
xrange_ = xrange(1, 900000000)
# will double all numbers until a result >=30 found # will double all numbers until a result >=30 found
for i in double_numbers(_xrange): for i in double_numbers(xrange_):
print(i) print(i)
if i >= 30: if i >= 30:
break break
@@ -542,10 +547,10 @@ for i in double_numbers(_xrange):
from functools import wraps from functools import wraps
def beg(_say): def beg(target_function):
@wraps(_say) @wraps(target_function)
def wrapper(*args, **kwargs): def wrapper(*args, **kwargs):
msg, say_please = _say(*args, **kwargs) msg, say_please = target_function(*args, **kwargs)
if say_please: if say_please:
return "{} {}".format(msg, "Please! I am poor :(") return "{} {}".format(msg, "Please! I am poor :(")
return msg return msg

17
python3.html.markdown
View File

@@ -471,7 +471,10 @@ class Human(object):
# A class attribute. It is shared by all instances of this class # A class attribute. It is shared by all instances of this class
species = "H. sapiens" species = "H. sapiens"
# Basic initializer # Basic initializer, this is called when this class is instantiated.
# Note that the double leading and trailing underscores denote objects
# or attributes that are used by python but that live in user-controlled
# namespaces. You should not invent such names on your own.
def __init__(self, name): def __init__(self, name):
# Assign the argument to the instance's name attribute # Assign the argument to the instance's name attribute
self.name = name self.name = name
@@ -557,9 +560,11 @@ def double_numbers(iterable):
# double_numbers. # double_numbers.
# Note range is a generator too. Creating a list 1-900000000 would take lot of # Note range is a generator too. Creating a list 1-900000000 would take lot of
# time to be made # time to be made
_range = range(1, 900000000) # We use a trailing underscore in variable names when we want to use a name that
# would normally collide with a python keyword
range_ = range(1, 900000000)
# will double all numbers until a result >=30 found # will double all numbers until a result >=30 found
for i in double_numbers(_range): for i in double_numbers(range_):
print(i) print(i)
if i >= 30: if i >= 30:
break break
@@ -572,10 +577,10 @@ for i in double_numbers(_range):
from functools import wraps from functools import wraps
def beg(_say): def beg(target_function):
@wraps(_say) @wraps(target_function)
def wrapper(*args, **kwargs): def wrapper(*args, **kwargs):
msg, say_please = _say(*args, **kwargs) msg, say_please = target_function(*args, **kwargs)
if say_please: if say_please:
return "{} {}".format(msg, "Please! I am poor :(") return "{} {}".format(msg, "Please! I am poor :(")
return msg return msg