Turbo Console Log Flash ⚡

Ultra-fast, lightweight, zero-bloat, AST-powered debug logging for JavaScript, TypeScript, Python, and PHP.

English | 简体中文

📌 Upstream & Fork Background

This project is a fork of Chakroun-Anas/turbo-console-log.

While the original extension provides excellent AST-based logging, later releases introduced commercial Turbo Pro upselling, background Git hooks, full-workspace background scans, analytics tracking (telemetry), and promotion Webviews. These additions increased resource consumption and added background runtime overhead.

Turbo Console Log Flash ⚡ was created with a clear mission: Back to Core & Lightning Fast. We surgically removed all commercial paywalls, telemetry trackers, and background listeners while preserving 100% of the core AST logging and management capabilities, making the extension featherweight, clean, and blazing fast.

⚡ Key Differences & Enhancements

✨ Features

1. AST-Powered Precision

Instead of fragile regex matching or simple string insertion, this extension parses your code with language-native AST parsers (acorn for JS/TS, @lezer/python for Python, php-parser for PHP):

• Accurate Placement: Automatically handles variable declarations, ternary operators, object literals, destructuring, function parameters, promise chains, and loops so the log statement always lands on the most logical and syntactically valid line.
• Context-Aware: Automatically extracts enclosing class names, function/method names, filenames, and line numbers.

2. Multi-Language & Multi-Method Support

• JavaScript & TypeScript:
  • console.log, console.error, console.warn, console.info, console.debug, console.table, and custom log functions.
• Python:
  • print(), logging.debug(), logging.info(), logging.warning(), logging.error(), and custom log functions.
• PHP:
  • var_dump(), print_r(), error_log(), and custom log functions.

3. Active File Log Management

• Comment All Logs: Instantly comment out all debug logs in the current file.
• Uncomment All Logs: Restore previously commented debug logs in the current file.
• Delete All Logs: Clean up all debug logs in the current file with one shortcut.
• Correct Log Messages: Automatically update filenames and line numbers after code refactoring or line moves.

⌨️ Keyboard Shortcuts

Windows / Linux users: replace ⌘ with Ctrl.

1. Insert Log Messages

2. Log Management (Active File)

⚙️ Configuration

Open VS Code Settings and search for turboConsoleLog to customize:

🛠️ Development & Building

This project uses pnpm for package management.

# 1. Clone the repository
git clone https://github.com/liujigang/turbo-console-log-flash.git
cd turbo-console-log-flash

# 2. Install dependencies
pnpm install

# 3. Build bundle (development with sourcemap)
pnpm run esbuild

# 4. Watch mode
pnpm run watch

# 5. Typecheck & Lint
pnpm run lint

# 6. Run unit tests (1,865 tests)
pnpm run test:jest

# 7. Package offline VSIX extension
pnpm run package

After packaging, the .vsix file will be generated in the root directory:

code --install-extension turbo-console-log-flash-3.29.0.vsix

📄 Acknowledgements & License

• Forked from Chakroun-Anas/turbo-console-log. Special thanks to Chakroun Anas and all original contributors for creating the AST logging algorithms.
• This fork complies with open-source licensing guidelines by stripping proprietary Turbo Pro code, branding, and assets, focusing solely on maintaining and enhancing the core open-source functionality.
• See LICENSE.txt for details.