docs/notes/python-code-style.rst
=====
Style
=====
.. contents:: Table of Contents
:backlinks: none
Naming
------
Class
^^^^^
Bad
.. code-block:: python
class fooClass: ...
class foo_class: ...
Good
.. code-block:: python
class FooClass: ...
Function
^^^^^^^^
Bad
.. code-block:: python
def CapCamelCase(*a): ...
def mixCamelCase(*a): ...
Good
.. code-block:: python
def func_separated_by_underscores(*a): ...
Variable
^^^^^^^^
Bad
.. code-block:: python
FooVar = "CapWords"
fooVar = "mixedCase"
Foo_Var = "CapWords_With_Underscore"
Good
.. code-block:: python
# local variable
var = "lowercase"
# internal use
_var = "_single_leading_underscore"
# avoid conflicts with Python keyword
var_ = "single_trailing_underscore_"
# a class attribute (private use in class)
__var = " __double_leading_underscore"
# "magic" objects or attributes, ex: __init__
__name__
# throwaway variable, ex: _, v = (1, 2)
_ = "throwaway"