Lightweight, configurable CodeLens for Python — shows references, implementations, and scoped imports directly above each symbol.

Powered entirely by VS Code's native DocumentSymbolProvider and ReferenceProvider (Pylance / Pyright). No extra runtime dependencies.

• Reference counts above classes, methods, functions, variables, and imports.
• Implementation counts for classes (how many subclasses inherit from them).
• Scoped import lenses with fine-grained classification: project, venv, stdlib, or global.
• Smart filtering — exclude import statements, the definition itself, or self-references from the count.
• Click action — open an inline peek view or jump to a matching reference.
• Per-resource configuration — different settings per workspace folder or file.
• Performance guards — shared symbol/reference caching, configurable debounce delay, targeted symbol invalidation, and file-size limit.
• Localized UI — settings descriptions and command titles are shown in English or Brazilian Portuguese automatically based on your VS Code display language.

• VS Code 1.96.0 or later.
• A Python language server that provides references (e.g. Pylance or Pyright).
  Without one, all counts will show 0 references.

From the Marketplace:
Search for Python CodeLens Lite in the VS Code Extensions view.

From a .vsix file:

npm run package   # generates python-codelens-lite-x.x.x.vsix

Then: Extensions → ··· → Install from VSIX…

Access via the Command Palette (Ctrl+Shift+P / ⌘⇧P).

All settings support resource scope (per-folder or per-file overrides via .vscode/settings.json).

The extension automatically adapts to your VS Code display language:

• English (en) — default.
• Brazilian Portuguese (pt-br) — settings descriptions and command titles are shown in Portuguese when VS Code is set to pt-BR.

To change your VS Code display language: Configure Display Language in the Command Palette.

Hide lenses on rarely-referenced symbols

// .vscode/settings.json
"pythonCodeLensLite.references.showZero": false,
"pythonCodeLensLite.references.minCount": 2

See which parts of your project import a given module

"pythonCodeLensLite.targets.imports.project": true,
"pythonCodeLensLite.references.filterImports": false

Reduce CPU usage on large codebases

"pythonCodeLensLite.performance.debounceMs": 500,
"pythonCodeLensLite.performance.maxFileSizeKB": 256

Ignore package initializer files

"pythonCodeLensLite.files.includeInitPy": false

Exclude generated or vendored files

"pythonCodeLensLite.exclude": [
  "**/.venv/**",
  "**/venv/**",
  "**/site-packages/**",
  "**/__pycache__/**",
  "**/migrations/**",
  "**/vendor/**"
]

1. On activation, a CodeLensProvider is registered for all Python (file scheme) documents.
2. provideCodeLenses uses VS Code's DocumentSymbolProvider to list eligible symbols, then emits placeholder lenses.
3. Symbol discovery is cached per document version, so repeated CodeLens passes do not re-read the same symbol tree.
4. resolveCodeLens calls vscode.executeReferenceProvider, caches raw references per symbol position, filters results, and reuses the filtered result for repeated resolutions.
5. Configuration is cached per URI and invalidated whenever settings change or workspace folders are added/removed.
6. Document edits are debounced, invalidate only the edited document's symbol cache, and clear reference caches globally so counts stay consistent across files.

Issues and pull requests are welcome. The project has no runtime dependencies — keep it that way.

npm install       # install dev dependencies
npm run check     # type-check without emitting files
npm run compile   # bundle dist/extension.js
npm run watch     # compile + watch
# Press F5 in VS Code to launch an Extension Development Host

You can submit a bug report or a feature suggestion via GitHub Issue Tracker.

MIT