colablinter - GitLite

KO | EN

gitlite — search

#rag #awesome #computer-vision #ui #http #chatbot #devops #ruby #terminal #css

colablinter

(★ 32)

Linting and formatting Python code in Google Colab

파일 탐색기

ZIP 다운로드

- - ci.yaml
  - release.yaml
- notebook.ipynb
- - __init__.py
  - command.py
  - logger.py
  - magics.py
  - timer.py
- test_command.py
- test_init.py
- test_magics.py
.gitignore
.pre-commit-config.yaml
LICENSE
pyproject.toml
README.md
uv.lock

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

명령어 용어집

이 문서에서 사용된 명령어를 모아봤습니다. 낯선 명령어가 있다면 펼쳐서 확인해보세요.

🔍

`ruff`

설명 보기 ▼

매우 빠른 Python 린터 및 코드 포매터로, Rust로 작성되었습니다.
관련 항목: `black`.
더 많은 정보: <https://docs.astral.sh/ruff/tutorial/>.

tldr ruff check

Ruff 린터에 대한 문서 보기:

tldr ruff format

Ruff 코드 포매터에 대한 문서 보기:

🔍

`uv pip`

설명 보기 ▼

Provides pip-like commands for installing, uninstalling, and managing packages.

uv pip install {{package}}

Install a package:

uv pip install {{[-r|--requirements]}} {{requirements.txt}}

Install packages from a requirements file:

uv pip install {{package==1.2.3}}

Install a package with a specific version:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div style="text-align: center;">
  <img src="https://capsule-render.vercel.app/api?type=transparent&fontColor=0047AB&text=colablinter&height=120&fontSize=90">
</div>

**`colablinter`** is an **IPython magic command extension** designed for Jupyter and Google Colab notebooks.
It integrates the high-speed linter **`ruff`** to perform code quality checks and formatting directly within Jupyter/Colab cells.
It allows developers to lint code on a **cell-by-cell** basis with simple commands. Try it here:
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/RektPunk/colablinter/blob/main/examples/notebook.ipynb)

## Magic cell Commands

| Command             | Description                                                                                                                  |
| :------------------ | :--------------------------------------------------------------------------------------------------------------------------- |
| **`%clautofix`**    | Activates or deactivates automatic fix including import sorting, formatting, and execution time display before every cell.   |
| **`%%clcheck`**     | Displays a linting report for the current cell.                                                                              |
| **`%%clunsafefix`** | Performs a linting check and applies "unsafe" fixes that might change code logic (e.g., changing mutable default arguments). |

After executing a cell magic command, the checked/formatted code is immediately executed (if applicable), maintaining the notebook workflow.

## Installation

Just run it in colab:

```python
!uv pip install colablinter
```

The extension must be explicitly loaded in the notebook session before use.

```python
%load_ext colablinter
```

Once loaded, `%clautofix` is activated by default to keep your code clean from the start.

## Usage

1. Activate/Deactivate Auto Fix (`%clautofix`)

The `%clautofix` line magic allows you to automatically fix code before every code cell is executed.

```python
   import math, sys;

class Example(   object ):
       def __init__    ( self, bar ):
         if bar : bar+=1;  bar=bar* bar   ; return bar
         else:
                       some_string = "foo"
                       return (sys.path, some_string)
   ```

Fixed Cell:

```python
   import math
   import sys

class Example:
       def __init__(self, bar):
           if bar:
               bar += 1
               bar = bar * bar
               return bar
           else:
               some_string = "foo"
               return (sys.path, some_string)
   ```

To deactivate auto fixing:

```python
   %clautofix off # %clautofix on when you want to activate
   ```

2. Check cell quality (`%%clcheck`)

Use `%%clcheck` to see linting reports for the code below the command. After the report is displayed, the code in the cell executes as normal.

```python
   %%clcheck

def invalid_code(x):
       return x + y
   ```

Output:

```bash
   [ColabLinter:INFO] F821 Undefined name `y`
   --> tmp.py:2:16
     |
   1 | def invalid_code(x):
   2 |     return x + y
     |                ^
     |
   Found 1 error.
   ```

3. Unsafe Fix (`%%clunsafefix`)

Use `%%clunsafefix` when you want `ruff` to aggressively clean up your code, including rules that are typically considered risky (like fixing mutable default arguments or complex refactoring).

```python
   %%clunsafefix

def process_data(new_item, current_list=[]):
       old_item = "redundant"
       if new_item:
           if isinstance(new_item, str):
               current_list.append(new_item)

if len(current_list) > 0:
           return True
       else:
           return False
   ```

Fixed Cell:

```python
   def process_data(new_item, current_list=None):
       if current_list is None:
           current_list = []
       if new_item and isinstance(new_item, str):
           current_list.append(new_item)

return len(current_list) > 0
   ```

## Known Caveats & Troubleshooting

**Note on F401:**
The linter is explicitly configured to **ignore F401 errors** (unused imports). This is to ensure compatibility with the stateful nature of Jupyter/Colab notebooks, where imports in one cell may be necessary for code execution in subsequent cells, preventing unintended breakage of the notebook's execution flow.

Magic Command Execution: When using magic or terminal commands while `%clautofix` is active, the auto-format mechanism is temporarily suppressed during the final execution step to prevent infinite loops or dual checks. If you want to disable auto-formatting, use `%clautofix off`