flake8-ascii-validator 1.0.2

A Flake8 plugin to validate ASCII characters in Python source code

flake8-ascii-validator

Flake8 plugin to validate ASCII characters in Python source code.

Installation

pip install flake8-ascii-validator

Usage

flake8 your_file.py

Example output:

example.py:3:5: ASC001 Non-ASCII character 'é' (U+00E9) found in source code
example.py:4:15: ASC002 Non-ASCII character 'ø' (U+00F8) found in string literal
example.py:5:10: ASC003 Non-ASCII character 'ñ' (U+00F1) found in comment

Error Codes

Code	Description
ASC001	Non-ASCII character found in source code (variable names, function names, etc.)
ASC002	Non-ASCII character found in string literal
ASC003	Non-ASCII character found in comment

Configuration

Ignore specific error codes:

flake8 --extend-ignore=ASC002

Or in your configuration file:

[flake8]
extend-ignore = ASC002

Examples

Valid ASCII code:

def hello_world():
    message = "Hello, World!"
    return message

Invalid non-ASCII code:

def función():  # ASC001: 'ó' in function name
    variável = "café"  # ASC001: 'á' in variable, ASC002: 'é' in string
    # Commentário  # ASC003: 'á' in comment
    return variável

Why Use This Plugin?

• Team Consistency: Ensure code works across different environments
• Legacy Compatibility: Support systems that don't handle Unicode well
• Debugging: ASCII characters are easier to search and debug
• Code Standards: Enforce ASCII-only policies in your codebase

Requirements

• Python 3.7+
• Flake8 3.0.0+

License

MIT License