| Name | fvi JSON |
| Version |
2.2
JSON |
| download |
| home_page | |
| Summary | Open those files that contain a string in Vim |
| upload_time | 2023-03-18 23:47:12 |
| maintainer | |
| docs_url | None |
| author | Ken Kundert |
| requires_python | >=3.6 |
| license | |
| keywords |
grep
vi
vim
gvim
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
FVI — Vim paired with Grep
==========================
:Author: Ken Kundert
:Version: 2.2
:Released: 2023-03-18
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 <glob> a glob string used to specify desired files,
can use brace expansion to specify multiple globs
-e, --exclude <glob> 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
Raw data
{
"_id": null,
"home_page": "",
"name": "fvi",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "grep,vi,vim,gvim",
"author": "Ken Kundert",
"author_email": "fvi@nurdletech.com",
"download_url": "https://files.pythonhosted.org/packages/58/15/b34d18278a7142c509df146f533f4edd2d597fe8e0713b9c3b19d7966436/fvi-2.2.tar.gz",
"platform": null,
"description": "FVI \u2014 Vim paired with Grep\n==========================\n\n:Author: Ken Kundert\n:Version: 2.2\n:Released: 2023-03-18\n\nOpens files that contains a given pattern in *vim*. You may specify \na collection of files to search, otherwise all files in the current working \ndirectory and all sub directories are searched.\n\nWithin *vim* use *n* to move to next occurrence of pattern. *Ctrl-n* moves to \nnext file and *ctrl-p* moves to the previous file. *vim* is run with \n*autowrite* set. Any directories, unreadable files, or binary files in the file \nlist are ignored.\n\nThe pattern is a literal text string. Regular expressions are not supported.\n\nUse -- to terminate the command line options.\nAny thing that follows -- is treated as the pattern.\nYou can search for patterns that start with - by preceding the pattern with --.\n\n\nArguments\n---------\n\n``fvi`` [options] [--] *pattern* [*file* ... ]\n\n\nOptions\n-------\n\n-i, --ignore-case ignore case\n-w, --word match a word\n-o, --only <glob> a glob string used to specify desired files,\n can use brace expansion to specify multiple globs\n-e, --exclude <glob> a glob string used to filter out unwanted files,\n can use brace expansion to specify multiple globs\n-H, --hidden include hidden files\n-b, --binary do not skip binary files (any not encoded in ascii or utf-8)\n-g, --gvim open files in gvim rather than vim\n-v, --vim open files in vim rather than gvim\n-W, --warn do not suppress warnings about directories and binary files\n-h, --help show help message and exit\n\nIf both ``--only`` and ``--exclude`` are specified, both must be satisfied.\n\n\nExamples\n--------\n\nSearch specified files:\n\n fvi '#\\!/usr/bin/env python3' ~/bin/*\n\nSearch all files in current hierarchy:\n\n fvi 'unknown key'\n\n\nInstallation\n------------\n\nRuns only on Unix systems. Requires Python 3.6 or later.\n\nInstall using::\n\n pip install fvi\n\n\nConfiguration\n-------------\n\nThe file ~/.config/fvi/settings.nt is read if it exists. This is a NestedText_\nfile that can contain settings: *vim*, *gvim*, and *gui*. The first specify the \ncommands used to invoke *vim* and *gvim*. The last is a Boolean that indicates \nwhether *gvim* is used by default (use *yes* or *no*). For example::\n\n vim: vimx\n gvim: gvim\n gui: yes\n\nIn this example, vimx is used rather than vim so that copy and paste using X11 \nworks as expected.\n\n.. _NestedText: https://nestedtext.org\n\n",
"bugtrack_url": null,
"license": "",
"summary": "Open those files that contain a string in Vim",
"version": "2.2",
"split_keywords": [
"grep",
"vi",
"vim",
"gvim"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "237904d073b6d5690dc39d917f4b138cbd5bcdcbba1ab533f687d5b51b0ef068",
"md5": "9f125205b5d75378edd54ac43f8d417f",
"sha256": "adaaaf01c4789efca2d7cbd8dc886cb21b081ddeba92e57deff87bda8e7a213a"
},
"downloads": -1,
"filename": "fvi-2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9f125205b5d75378edd54ac43f8d417f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 5925,
"upload_time": "2023-03-18T23:47:09",
"upload_time_iso_8601": "2023-03-18T23:47:09.017827Z",
"url": "https://files.pythonhosted.org/packages/23/79/04d073b6d5690dc39d917f4b138cbd5bcdcbba1ab533f687d5b51b0ef068/fvi-2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5815b34d18278a7142c509df146f533f4edd2d597fe8e0713b9c3b19d7966436",
"md5": "f997099ad99d67b55612808e1e6c6fcd",
"sha256": "72595ba1950c3d4f1eea0061c631705296923821e4a0ca0ee3d82186a626228d"
},
"downloads": -1,
"filename": "fvi-2.2.tar.gz",
"has_sig": false,
"md5_digest": "f997099ad99d67b55612808e1e6c6fcd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 5035,
"upload_time": "2023-03-18T23:47:12",
"upload_time_iso_8601": "2023-03-18T23:47:12.671999Z",
"url": "https://files.pythonhosted.org/packages/58/15/b34d18278a7142c509df146f533f4edd2d597fe8e0713b9c3b19d7966436/fvi-2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-03-18 23:47:12",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "fvi"
}
