Skip to content

Introduction

Jump to bottom
Vinicius Reif Biavatti edited this page Jul 25, 2022 · 1 revision

This Python style guide was made focusing in the essential to create a clean and maintainable code. I really encourage the usage of any style guide, since this guarantees that your code can be easily understood by developers. There are other styles guides made from big projects/companies, and I have to confess that some tips of this style guide was obtained from these documents, but, another tips I created by myself.

Avoid seeing this material as rules for your development, but use this as a convention to standardization. If you prefer to follow your style for coding some specific situation, go ahead! But, I just ask you to check and determine if this style you choose was the best choice, or if there is some situation that it could break somewhere.

  1. Home
  2. Structural Naming Conventions
    1. Project Name
    2. Packages
    3. Modules
    4. Main Module
    5. Test Module
  3. Format Conventions
    1. Line Length 79
    2. Blank Lines
    3. Indentation
    4. Inline Expressions
    5. Spaces
    6. Backslash
    7. Strings
    8. End of File EOF
  4. Code Naming Conventions
    1. Variables
    2. Constants
    3. Functions
    4. Function Parameters
    5. Classes
    6. Methods
    7. Magic Methods
    8. Test Methods
    9. Unused Resources
    10. Errors
    11. Error Alias
    12. Reserved Words
    13. Enums
  5. Inheritance
    1. ABC
    2. Abstract Methods
    3. Mixins
    4. Super
  6. Access Modifiers
    1. Module Variables Access
    2. Module Constants Access
    3. Module Functions Access
    4. Module Classes Access
    5. Class Variables Access
    6. Class Constants Access
    7. Class Attributes Access
    8. Class Methods Access
    9. Class Properties Access
  7. Importation
    1. Import Location
    2. Multiple Module Imports
    3. Multiple Module Resource Imports
    4. Import Alias
    5. Order
  8. Functions and Methods
    1. Parameters
    2. Arguments
    3. Function and Method Calls
    4. Static Methods
    5. Class Methods
    6. Instance Methods
    7. Instace Properties
  9. Documentation
    1. Inline Comments
    2. Multiple Line Comments
    3. Section Comments
    4. Docstrings
  10. Resources
    1. Module Template
    2. Class Template
    3. Docstring Template
    4. Comment Snippets
    5. Editorconfig
Clone this wiki locally