comb

KO | EN

gitlite — search

#javascript #hacktoberfest #react #ai #typescript #llm #machine-learning #nodejs #macos #java #awesome #kubernetes #vue #openai

(★ 77)

Interactive code auditing and grep tool in Emacs Lisp

File Explorer

Download Latest Version (.zip)

.gitignore
comb-browse.el
comb-common.el
comb-configure.el
comb-filter.el
comb-report.el
comb-search.el
comb-session.el
comb.el
LICENSE
Makefile
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![MELPA Stable](https://stable.melpa.org/packages/comb-badge.svg)](https://stable.melpa.org/#/comb)
[![MELPA](https://melpa.org/packages/comb-badge.svg)](https://melpa.org/#/comb)

# Comb

Comb is a native Emacs Lisp solution to search, browse and annotate occurrences
of regular expressions in files. The interactive interface allows to perform an
exhaustive classification of all the results to rule out false positives and
asses proper matches during code audit.

## Installation

### [MELPA] package

```
M-x package-install RET comb
```

[MELPA]: https://melpa.org/#/getting-started

### Local package

```
M-x package-install-file RET /path/to/comb/
```

### Manual

```elisp
(add-to-list 'load-path "/path/to/comb/")
(require 'comb)
```

## Usage

This is a quick walkthrough of some of the features of Comb. To perform a
search:

1. move to the root directory of the repository you want to audit;

2. run `M-x comb`;

3. press `c` to enter the configuration mode;

4. fill the desired fields and finally perform a search.

If there are some results to browse then the `*Comb*` buffer is displayed, from
here it is possible to annotate the results (`!`) and change their status to
approved (`a`/`A`), rejected (`r`/`R`) or undecided (`u`/`U`, the default).

The above actions work on the current result which can be moved to the next
(`n`) or the previous (`p`), in doing so the `*Comb*` buffer is updated to show
the file that contains the result, which is now highlighted. Only results
matching the status filter (cycled with `f`) and the notes filter regexp (set
with `F`) are displayed. In addition to that, `t` spawns a buffer containing the
list of the currently displayed results, this allows to Isearch the snippets and
jump to the result at point.

Finally it is possible to save the current session to file (`s`) and load it
back to resume the audit (`l`).

See the help (`h`) for a list of all the features and keybindings.

### Regexps

The patterns used by Comb are Emacs-flavored regexps (see the [`(elisp) Regular
Expressions`][info-regexp] info node). The `M-x regexp-builder` utility can be
used to interactively try the regexps before performing a search, just make sure
to use the proper syntax (`C-c TAB string`) and leave out the surrounding `"`.

[info-regexp]: https://www.gnu.org/software/emacs/manual/html_node/elisp/Regular-Expressions.html

### Callbacks

Comb also accepts a list of callbacks that can be used to generate additional
search results, e.g., coming from an external linting tool. These functions are
executed with the `default-directory` set to the root directory and the current
buffer set to the currently processed file, they accept a relative path as an
argument and must return a list of ranges in the form `(BEGIN . END)`.

Here is an example callback:

```elisp
(defun my-callback (filename)
  "Match only the first occurrence of 'qwerty'."
  (when (re-search-forward "qwerty" nil t)
    (list (cons (match-beginning 0) (match-end 0)))))
```

Errors in the callback execution are not fatal, they are just reported in the
`*Messages*` buffer.

## Configuration

Some faces and options can be configured, take a look at the `comb`
customization group (`M-x customize-group RET comb`).

Additionally, all the keybindings in the `*Comb*` buffer can be altered by
changing the `comb-keymap` keymap. For example, to use the arrows to navigate
the results use:

```elisp
(define-key comb-keymap (kbd "<left>") 'comb-prev)
(define-key comb-keymap (kbd "<right>") 'comb-next)
```

This does not unbind the original keybindings though. It may be convenient to
completely replace the keymap instead so to avoid collisions with existing
modes:

```elisp
(setq comb-keymap (make-sparse-keymap))
(define-key comb-keymap (kbd "x") 'comb-quit)
(define-key comb-keymap (kbd "?") 'comb-help)
(define-key comb-keymap (kbd "<left>") 'comb-prev)
(define-key comb-keymap (kbd "<right>") 'comb-next)
;; ...
```

See the `comb-default-keybindings` alist to obtain the functions used by the
default keybindings.

comb

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

comb

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README