Python filenames must have a .py extension and must not contain dashes (-). This allows them to be imported and unittested. If you want an executable to be accessible without the extension, use a symbolic link or a simple bash wrapper containing exec "$0.py" "$@". For mathematically-heavy code, short variable names that would otherwise violate the style guide are preferred when they match established notation in a reference paper or algorithm.

Archive · Skip to content · The Google Code Archive requires JavaScript to be enabled in your browser · Google · About Google · Privacy · Terms

Google’s Style Guide is made up of more than 40 sets of “do’s and don’ts” for use within Python and is broken into two key sections - Python Language Rules & Python Style Rules. Broadly speaking the Language Rules are used to define how Google approaches using (and importantly not using) and structuring different elements of the Python language within their code.

February 11, 2023 - My thoughts on docstrings, pdoc and Google style vs. Markdown ... Confused by Google's docstring "Attributes" section. ... The Move to Python 3 Begins!

July 15, 2022 - And then we’ll quickly take a look at how you can build your own style guide and best practices into code with Sourcery. Google’s Style Guide is made up of more than 40 sets of “do’s and don’ts” for use within Python and is broken into two key sections - Python Language Rules & Python Style Rules.

# -*- coding: utf-8 -*- """Example Google style docstrings. This module demonstrates documentation as specified by the `Google Python Style Guide`_. Docstrings may extend over multiple lines. Sections are created with a section header and a colon followed by a block of indented text.

“Style” covers a lot of ground, from “use camelCase for variable names” to “never use global variables” to “never use exceptions.” This project (google/styleguide) links to the style guidelines we use for Google code. If you are modifying a project that originated at Google, you may be pointed to this page to see the style guides that apply to that project. AngularJS Style Guide · Common Lisp Style Guide · C++ Style Guide · C# Style Guide · Go Style Guide · HTML/CSS Style Guide · JavaScript Style Guide · Java Style Guide · JSON Style Guide · Markdown Style Guide · Objective-C Style Guide · Python Style Guide ·

October 13, 2018 - Google’s Python style guide also suggests similar rule for method names. Moreover, the source-code doesn’t adhere to a 4-space indent as suggested by both Google’s Python style guide and PEP-8 guidelines.

April 2, 2026 - It includes recommendations for structuring your project and guidelines for code style, documentation, testing, logging, and more. The Google Python Style Guide defines the coding standards used at Google.

Python is the main dynamic language used at Google. This style guide is a list of dos and don'ts for Python programs. To help you format code correctly, we've created a settings file for Vim.

For more information about how to introduce code samples, see Document command-line syntax. The following public Google coding-style guides are available on GitHub: C++ style guide. HTML/CSS style guide. Java style guide. JavaScript style guide. Python style guide ·

Otherwise, subtle but important details of a function’s implementation that are not relevant to the caller are better expressed as comments alongside the code than within the function’s docstring. The docstring may must be descriptive-style ("""Fetches rows from a Bigtable.""") or imperative-style ("""Fetch rows from a Bigtable."""), but the style should be consistent within a file.

If you need a list comprehension or complicated computation, then it's usually better to pull it out into a temporary variable instead. Dynamic code in the middle of static strings can be easy to miss for readers. The Google style guide says that the % formatting and '{}'.format() styles are both permitted.

Python 风格指南 - 内容目录 · 扉页 · View page source · 原作者: Amit Patel · Antoine Picard · Eugene Jhong · Jeremy Hylton · Matt Smart · Mike Shields · 详细作者列表请参见英文原版的 Git 仓库. 翻译: guoqiao v2.19 · xuxinkun v2.59 · captainfffsama v2.6 · 楼宇 2023 年 4 月 16 日更新 · 项目主页: Google Style ...

Google Style Python Docstrings. GitHub Gist: instantly share code, notes, and snippets.

“Style” covers a lot of ground, from “use camelCase for variable names” to “never use global variables” to “never use exceptions.” This project (google/styleguide) links to the style guidelines we use for Google code. If you are modifying a project that originated at Google, you may be pointed to this page to see the style guides that apply to that project. AngularJS Style Guide · Common Lisp Style Guide · C++ Style Guide · C# Style Guide · Go Style Guide · HTML/CSS Style Guide · JavaScript Style Guide · Java Style Guide · JSON Style Guide · Markdown Style Guide · Objective-C Style Guide · Python Style Guide ·

Highlights of Google Python Style Guide http://google.github.io/styleguide/pyguide.html · Alternative Downloads