Coding style¶

We (mostly) follow the style guide from the the Django project. Unless otherwise specified, follow this guide. Please read this guide, use it, and feel free to point out if existing code does not comply with the style guide.

Examples¶

Max line length is 119 characters

Indentation is 4 spaces:

for protein in proteins:
   print(protein)

Comments start with a # and a single space:
```
# this is a comment
```
Docstrings use “””:
```
"""This is a docstring"""
```

Use lower case letters and underscores for variable and function names, upper case letters and underscores for constants, and InitialCaps for class names:

this_is_a_variable = True

THIS_IS_A_CONSTANT = True

def this_is_a_function():
   pass

class ThisIsAClass:
   __init__(self):
      pass

Class definitions are followed by 2 blank lines:

class ThisIsAClass:
   __init__(self):
      pass


class ...

Import statements are grouped in three categories(django, project, and other), separated by one blank line, and followed by 2 blank lines:
```
from django.conf import settings

from protein.models import Protein

import yaml


class ...
```

Keep your code clean¶

Before committing, review the changes you have made (using git diff or a GUI like SourceTree) and make sure the code you are committing is working, and relevant. Never commit lines of code that are commented out (comments are for, well, comments), or print statements that you used for debugging.