check comments for wording issues

문서 > Datadog 보안 > Code Security > Static Code Analysis (SAST) > SAST 규칙 > check comments for wording issues

이 페이지는 아직 영어로 제공되지 않습니다. 번역 작업 중입니다.
현재 번역 프로젝트에 대한 질문이나 피드백이 있으신 경우 언제든지 연락주시기 바랍니다.

Metadata

ID: python-inclusive/comments

Language: Python

Severity: Notice

Category: Code Style

Description

Check the variable names and suggest better names.

Examples of replacement suggestions:

blacklist with denylist
whitelist with allowlist
master with primary
slave with secondary

Non-Compliant Code Examples

# whitelist names to prevent unauthorized usage
def filter_names(names):
    pass

# she SHE should check her code    
def new_function_from_helen():
    pass


class Foo:
    # he should check his
    def new_function_from_joe():
        pass

Compliant Code Examples

# allowlist names to prevent unauthorized usage
def filter_names(names):
    pass

# the comments do not have an history of issues
def foo(bar):
    baz()