Skip to main content

Edit directory with vim

Project description

VDIR - Edit directory with vim

Heavily inspired by vidir from moreutils and edir.

With a few different design choices:

  • vdir always prompts before applying changes

  • vdir don't integrate with git

  • vdir displays an (arguably) pretty-looking preview of the changes

  • vdir pads sequence number to same width for visual block operations

  • vdir references LS_COLORS for coloring

  • vdir supports stage/unstage items dynamically

  • vdir treats symbolic links as files instead of resolving them

  • vdir supports editing symbolic links

Examples (shell)

Edit the current diretory:

$ vdir

Manage certain files:

$ vdir *.txt

Manage found files:

$ fd --type f | vdir

Examples (vim)

A vdir's vim session looks like this:

# ═════════════════════════════════════════════════════════════════════════════
# - Add a path to track it.
# - Sort the paths as you want.
# - Add a '#' before the id to untrack an item.
# - Add a '+' before the id to expand non-hidden items under the directory.
# - Add a '*' before the id to expand all items under the directory.
# - Add a '@' before the id to resolve the soft link.
# - Setup default vdir.vimrc with
#   $ vdir --vimrc
# ═════════════════════════════════════════════════════════════════════════════

110 ││ LICENSE
120 ││ README.md
131 ││ __pycache__/
140 ││ pyproject.toml
151 ││ vdir/

Edit the content, save and quit, and vdir prompts you the changes like this:

[info] Delete:[LICENSE]
[info] Rename:[README.mdd]
Continue? [(Y)es / (n)o / (e)dit / (r)edo] _
  • y to apply and continue with another vim session
  • enter to apply and quit
  • n to cancel the edit
  • ctrl+c to cancel the edit if you're scared of the change
  • e to continue editing
  • r to restart with initial contents

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vdir-0.1.3.tar.gz (90.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vdir-0.1.3-py3-none-any.whl (113.6 kB view details)

Uploaded Python 3

File details

Details for the file vdir-0.1.3.tar.gz.

File metadata

  • Download URL: vdir-0.1.3.tar.gz
  • Upload date:
  • Size: 90.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: Hatch/1.16.5 cpython/3.14.3 HTTPX/0.28.1

File hashes

Hashes for vdir-0.1.3.tar.gz
Algorithm Hash digest
SHA256 0945239d9a083ef467cb902fba10763706e024a511092a62dfee08ad75b8e66d
MD5 b13cb204c948cbce37533d57c74f282d
BLAKE2b-256 126cbd57ad8c461a1a39182a18060384614fe75aad5efd71853fb95ca1cb3d15

See more details on using hashes here.

File details

Details for the file vdir-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: vdir-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 113.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: Hatch/1.16.5 cpython/3.14.3 HTTPX/0.28.1

File hashes

Hashes for vdir-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 18cfd184403dff4a07a369e4dea395751ed62c83578ab1e500dcd0dc78fbdc3c
MD5 c9dd95da9022ad1cafbf46b151333434
BLAKE2b-256 d81e86636dc74ed165c28f8b5dc3ae272a83cf6b876109734904ec7b6de9e5e8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page