https://github.com/kenkundert/fvi
Vim paired with grep
https://github.com/kenkundert/fvi
vim
Last synced: 9 months ago
JSON representation
Vim paired with grep
- Host: GitHub
- URL: https://github.com/kenkundert/fvi
- Owner: KenKundert
- License: gpl-3.0
- Created: 2013-09-14T04:43:04.000Z (almost 13 years ago)
- Default Branch: master
- Last Pushed: 2023-11-08T20:23:45.000Z (over 2 years ago)
- Last Synced: 2025-04-13T18:16:53.947Z (about 1 year ago)
- Topics: vim
- Language: Python
- Homepage: http://nurdletech.com/linux-utilities/fvi
- Size: 117 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGELOG.rst
- License: LICENSE.txt
Awesome Lists containing this project
README
FVI — Vim paired with Grep
==========================
:Author: Ken Kundert
:Version: 2.2.1
:Released: 2023-11-08
Opens files that contains a given pattern in *vim*. You may specify
a collection of files to search, otherwise all files in the current working
directory and all sub directories are searched.
Within *vim* use *n* to move to next occurrence of pattern. *Ctrl-n* moves to
next file and *ctrl-p* moves to the previous file. *vim* is run with
*autowrite* set. Any directories, unreadable files, or binary files in the file
list are ignored.
The pattern is a literal text string. Regular expressions are not supported.
Use -- to terminate the command line options.
Any thing that follows -- is treated as the pattern.
You can search for patterns that start with - by preceding the pattern with --.
Arguments
---------
``fvi`` [options] [--] *pattern* [*file* ... ]
Options
-------
-i, --ignore-case ignore case
-w, --word match a word
-o, --only a glob string used to specify desired files,
can use brace expansion to specify multiple globs
-e, --exclude a glob string used to filter out unwanted files,
can use brace expansion to specify multiple globs
-H, --hidden include hidden files
-b, --binary do not skip binary files (any not encoded in ascii or utf-8)
-g, --gvim open files in gvim rather than vim
-v, --vim open files in vim rather than gvim
-W, --warn do not suppress warnings about directories and binary files
-h, --help show help message and exit
If both ``--only`` and ``--exclude`` are specified, both must be satisfied.
Examples
--------
Search specified files:
fvi '#\!/usr/bin/env python3' ~/bin/*
Search all files in current hierarchy:
fvi 'unknown key'
Installation
------------
Runs only on Unix systems. Requires Python 3.6 or later.
Install using::
pip install fvi
Configuration
-------------
The file ~/.config/fvi/settings.nt is read if it exists. This is a NestedText_
file that can contain settings: *vim*, *gvim*, and *gui*. The first specify the
commands used to invoke *vim* and *gvim*. The last is a Boolean that indicates
whether *gvim* is used by default (use *yes* or *no*). For example::
vim: vimx
gvim: gvim
gui: yes
In this example, vimx is used rather than vim so that copy and paste using X11
works as expected.
.. _NestedText: https://nestedtext.org